Los mosaicos de hojas de ruta son mosaicos de imágenes basados en datos topográficos vectoriales
con el estilo cartográfico de Google. Esto incluye rutas, edificios, puntos
de interés y límites políticos.
Cómo obtener mosaicos de hojas de ruta
Puedes comenzar a realizar solicitudes de mosaicos de hojas de ruta después de obtener un token de sesión. Debido a que 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 muestra una solicitud de token de sesión típica para mosaicos de hojas 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 hojas de ruta, realiza una solicitud GET de 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 HTTPS GET, z es el nivel de zoom
(que va 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 sentido antihorario de la imagen del mosaico. orientation es
compatible con los mosaicos roadmap, y también con las solicitudes de satélite y
terreno con imágenes base quitadas con "overlay": true, y con
layerTypes configurado. Los valores orientation válidos son 0 (el valor predeterminado), 90, 180 y 270.
La cuadrícula de coordenadas de los mosaicos no se rota si incluyes un valor 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, que solicita un solo mosaico que contiene todo el mundo. En este ejemplo, el nivel de zoom es 0, y las coordenadas x y 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 ningún mensaje de respuesta del servidor. En cambio, el mosaico 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.

