add `/map` prefix to tiles endpoint

[vincentsarago]

right now we have tiles endpoints in form of /tiles/{tileMatrixSetId}/{z}/{x}/{y} which is compliant with OGC Tileset specification.

we could also comply with dataset-tileset and tilesets-map conformance by adding /map prefix to the /tiles endpoints

# now                               
../tiles                                                   
../tiles/{tileMatrixSetId}                                     
../tiles/{tileMatrixSetId}/{z}/{x}/{y}[@{scale}x][.{format}]
/tileMatrixSets
/tileMatrixSets/{tileMatrixSetId}

ConformsTo:
- http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/core
- http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/tileset
- http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/tilesets-list
- http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/oas30

# after                                  
../map/tiles                                                   
../map/tiles/{tileMatrixSetId}                                     
../map/tiles/{tileMatrixSetId}/{z}/{x}/{y}[@{scale}x][.{format}] 
/tileMatrixSets
/tileMatrixSets/{tileMatrixSetId}

ConformsTo: 
- http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/core
- http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/tileset
- http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/tilesets-list
- http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/dataset-tilesets
- http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/tilesets-map
- http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/oas30

ref: https://docs.ogc.org/is/20-057/20-057.html

[j08lue]

Does TiTiler-PgSTAC have a concept of "datasets" ("a.k.a., a root resource, which may contain multiple geospatial data resources")? I guess it would in our case just be a transparent wrapper to the existing resources (collections, tilesets)?

In other words, would the addition of /map provide anything new and useful, or just an alias, for compliance?

[j08lue]

I've seen /map already have a different meaning on TiTiler - a HTML viewer application.

https://eoapi.develop.eoepca.org/raster/api.html#/STAC%20Collection/map_viewer_collections__collection_id___tileMatrixSetId__map_get

Would we rename this, to avoid confusion?

[vincentsarago]

Does TiTiler-PgSTAC have a concept of "datasets"

we have /searches, /collections and /items with can be seen as datasets

In other words, would the addition of /map provide anything new and useful, or just an alias, for compliance?

yeah it would be just for compliance, because titiler only work with raster output, having or not having a compliance with tilesets-map (/map/tiles/...` is not a huge thing IMO

[vincentsarago]

I've seen /map already have a different meaning on TiTiler - a HTML viewer application.
Would we rename this, to avoid confusion?

Yes

also the current /map endpoint will be in conflict once we implement the OGC MAPS API