Mosaico
Descripción
Devuelve los mosaicos de mapa generados por el Map Tiling Service con base en los parámetros de entrada especificados.
Formato de dirección URL de HTTP GET
El siguiente formato se utiliza para solicitudes HTTP GET:
HTTP GET /{mapname}/{level}/{x}:{y}/tile.{image type}
Parámetros
Consulte Tipos de datos de URL de solicitud, para obtener información sobre los tipos de parámetros que se indican a continuación.
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| mapname | Cadena | sí | El nombre del mosaico con nombre asignado desde el cual se va a generar el mosaico. Debe especificar la ubicación en el repositorio del mosaico con nombre asignado. |
| level | Integer | sí |
Determina el nivel de zoom del mosaico que se va a arrojar. El nivel muestra la cercanía respecto de la Tierra de la imagen del mapa El nivel 1 indica la mayor distancia y está compuesto de un mosaico que abarca todo el mapa. El nivel 2 está compuesto de cuatro mosaicos: dos horizontales y dos abajo. Cada uno es un cuarto del mapa entero. El nivel 3 está compuesto de 16 mosaicos: cuatro horizontales, cuatro abajo, y así sucesivamente. Cuanto mayor es el nivel especificado, más cerca de la Tierra aparece la imagen del mapa. Por ejemplo, generalmente los niveles 1 a 3 muestran detalles globales o hemisféricos, los niveles 4 a 15 muestran un nivel de detalle en relación con el condado, el estado o la provincia y algunas ciudades grandes, y los niveles superiores a 15 muestran vistas del nivel de calle. Lo que los niveles mostrarán realmente dependerá del mapa con nombre asignado publicado en Map Tiling Service. Por ejemplo, si publica un mapa de Nueva York, Toronto o Londres, entonces el nivel 1 sería un mapa de nivel de calle de Toronto, mientras que los niveles más altos serían más detallados. Este parámetro se debe establecer en un valor superior o igual al valor minLevel e inferior o igual al valor maxLevel del mapa con nombre asignado. |
| x | Integer | sí | Especifica la columna del mosaico, a partir del parámetro level especificado. |
| y | Integer | sí | Especifica la fila del mosaico, a partir del parámetro level especificado. |
| .{image type} | endPoint | sí | Especifica el formato de imagen de la respuesta (gif, jpeg, jpg, mvt o png). |
Devolución
Una imagen del mapa.
Se arrojará un error JSON si se cumple alguna de las siguientes condiciones:
- No se especifica el parámetro mapname.
- El nombre especificado no es un mapa con nombre asignado disponible en el servicio de mosaicos.
- El parámetro level es inferior al definido en los metadatos del mapa especificado.
- El parámetro level es superior al maxlevel en los metadatos del mapa especificado.
- El parámetro x es inferior a 1.
- El parámetro x es superior al que el nivel indica que el mapa puede proporcionar.
- El parámetro y es inferior a 1
- El parámetro y es superior al que el nivel indica que el mapa puede proporcionar.
Ejemplo
http://<server>:<port>/rest/Spatial/MapTilingService/Samples/NamedTiles/WorldTile/2/1:1/tile.png
El siguiente ejemplo muestra la salida de imagen arrojada en la respuesta:
