Los mosaicos de mapa son simplemente la división del mundo en una cuadrícula indexada. Te permite acceder a los datos de mapas y usarlos de manera eficiente y dinámica en varias escalas cartográficas. La API de Map Tiles te brinda acceso a varios geoconjuntos de datos temáticos, incluidos los siguientes seleccionados por Google:
Mosaicos de imágenes de mapas de ruta basados en datos topográficos vectoriales con el estilo cartográfico de Google
Ortofotografía capturada por cámaras satelitales y aéreas que entregan imágenes de arriba abajo (nadir) de la Tierra.
Mapas de contornos de colinas.
Los mosaicos de mapas en 2D tienen referencias geográficas y alineados entre sí. Se seleccionan en función de la extensión geográfica del viewport y el nivel de zoom. Los niveles de zoom varían de cero (para ver el mundo completo) a 22 (para ver calles y cuadras).
Temas de mapas
Puedes obtener mosaicos de mapas para los siguientes temas de mapas.
| Tema del mapa | Descripción |
|---|---|
| Hoja de ruta | Rutas, edificios, lugares de interés y límites políticos |
| Satélite | Imágenes fotográficas tomadas desde el espacio |
| Terreno | Un mapa de contorno que muestra características naturales, como vegetación |
Para solicitar mosaicos de mapas desde la API de Map Tiles, primero debes solicitar un token de sesión. El token de sesión hace un seguimiento del estado actual de tu mapa y viewport. Cuando configures tu token de sesión, debes establecer el valor mapType para que coincida con el tema del mapa que desees.
Luego, debes incluir el token de sesión en cada una de tus solicitudes a la API de Map Tiles.
Solicitudes de información de viewport
El viewport define el tamaño del cuadro que enmarca la escena del mundo. Las solicitudes de información de viewports muestran detalles sobre los mosaicos de mapas que conforman tu viewport actual. El motivo por el que solicitas información del viewport es para asegurarte de evitar solicitar imágenes en niveles de zoom que no existen.
Por ejemplo, la mayoría de las ciudades tienen imágenes con un nivel de zoom 22, pero no del océano, ya que solo se mostrarían cuadrados azules sin características.
La solicitud de viewport es una solicitud HTTPS GET que tiene el siguiente formato.
curl "https://tile.googleapis.com/tile/v1/viewport?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &zoom=zoom &north=north &south=south &east=east &west=west"
La solicitud contiene los siguientes campos:
zoom- El nivel de zoom del viewport.
north,south,eastywest- Los puntos más alejados del norte, el sur, el este y el oeste del viewport, expresados en grados. El norte y el sur deben encontrarse en el rango de -90 a 90; el este y el oeste deben estar en el rango de -180 a 180. Para expresar límites que cruzan el antimeridiano, el oeste puede ser positivo (por ejemplo, 170) y el este puede ser negativo (por ejemplo, -170). Todos los parámetros son obligatorios.
Respuestas de información de viewport
La respuesta del viewport te indica qué áreas tienen imágenes y en qué niveles de zoom. Una respuesta de información de viewport tiene el siguiente formato.
{
"copyright": "Map data ©2023",
"maxZoomRects": [
{
"maxZoom": 19,
"north": 90,
"south": -90,
"east": 180,
"west": -180
},
{
"maxZoom": 9,
"north": 90,
"south": -90,
"east": 180,
"west": -180
},
{
"maxZoom": 14,
"north": 84.375,
"south": -84.375,
"east": 180,
"west": -180
}, ...
]
}
El cuerpo de la respuesta contiene los siguientes campos.
copyright- Contiene una cadena de atribución que debes mostrar en tu mapa cuando muestras mapas de ruta y mosaicos satelitales. Para obtener más información, consulta las Políticas de la API de Map Tiles.
maxZoomRect- Contiene un array de rectángulos delimitadores que se superponen con el viewport actual. Además, contiene el nivel de zoom máximo disponible en cada rectángulo.
Funciones de coordenadas del mosaico
Las herramientas (funciones simples) están disponibles en la mayoría de los lenguajes de programación para convertir pares de latitud y longitud en coordenadas de mosaicos con un nivel de zoom específico.
Considera el siguiente ejemplo de código JavaScript que primero convierte un latLng en un punto y, luego, de un punto a las coordenadas del mosaico.
var TILE_SIZE = 256;
function fromLatLngToPoint(latLng) {
var mercator = -Math.log(Math.tan((0.25 + latLng.lat() / 360) * Math.PI));
return {
x: TILE_SIZE * (latLng.lng() / 360 + 0.5),
y: TILE_SIZE / 2 * (1 + mercator / Math.PI)
};
}
function fromLatLngToTileCoord(latLng, zoom) {
var point = fromLatLngToPoint(latLng);
var scale = Math.pow(2, zoom);
return {
x: Math.floor(point.x * scale / TILE_SIZE),
y: Math.floor(point.y * scale / TILE_SIZE),
z: zoom
};
}