Los mosaicos de mapas de ruta son mosaicos de imágenes basados en datos topográficos vectoriales con el estilo cartográfico de Google. Esto incluye rutas, edificios, lugares de interés y límites políticos.
Obteniendo tarjetas de la hoja de ruta
Puedes comenzar a realizar solicitudes de mosaicos de mapas de ruta después de obtener un token de sesión. Como el token de sesión se aplica a toda la sesión, no es necesario que especifiques las opciones de mapa con tus solicitudes de mosaicos.
En la siguiente muestra de código, se indica una solicitud típica de token de sesión para las tarjetas de mapa de ruta.
curl -X POST -d '{ "mapType": "roadmap", "language": "en-US", "region": "US" }' \ -H 'Content-Type: application/json' \ "https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"
Para obtener mosaicos de mapas de ruta, realiza una solicitud GET HTTPS, como se muestra en el siguiente ejemplo.
curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &orientation=0_or_90_or_180_or_270"
En esta solicitud GET de HTTPS, z es el nivel de zoom (que varía de 0 a 22), y x y y son las coordenadas del mosaico que deseas recuperar.
El parámetro orientation es opcional. Su valor especifica la cantidad de grados de rotación en el sentido contrario a las manecillas del reloj de la imagen de mosaico. orientation es compatible con las tarjetas roadmap, y también con las solicitudes de imágenes satelitales y de terreno con las imágenes base quitadas con "overlay": true y con layerTypes establecido. Los valores válidos de orientation son 0 (el valor predeterminado), 90, 180 y
270.
La cuadrícula de coordenadas de mosaico no se rota si incluyes un valor de orientation. Por ejemplo, si estableces orientation en 90, la coordenada x seguirá definiendo la posición de izquierda a derecha del mosaico, que, en este caso, es de norte a sur en el mapa.
| Orientación de cero grados | Orientación de 90 grados |
|---|---|
![]() |
![]() |
Ejemplo de solicitud de mosaico
Considera el siguiente ejemplo, en el que se solicita una sola tarjeta que contiene todo el mundo. En este ejemplo, el nivel de zoom es 0, y las coordenadas x e y son 0, 0.
curl "https://tile.googleapis.com/v1/2dtiles/0/0/0?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY" --output /tmp/example_tile.png
En este ejemplo, no hay un mensaje de respuesta del servidor. En cambio, la tarjeta se descarga en un archivo local con las siguientes estadísticas.

% Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 8335 100 8335 0 0 51471 0 --:--:-- --:--:-- --:--:-- 54835
Para obtener información sobre los encabezados de los mensajes de respuesta, consulta Recuperación anticipada o almacenamiento (incluso en caché) del contenido.

