Los mosaicos de hojas de ruta son mosaicos de imágenes que se basan en datos topográficos vectoriales
con el estilo cartográfico de Google. como rutas, edificios, lugares de interés y límites políticos.
Cómo obtener mosaicos de la hoja de ruta
Puedes comenzar a realizar solicitudes de mosaicos de la hoja 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 tienes que especificar las opciones de mapa con tus solicitudes de mosaicos.
En la siguiente muestra de código, se observa 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 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 HTTPS, z es el nivel de zoom (de 0 a 22), y x y y son las coordenadas de mosaicos 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 de mosaico. orientation es compatible con mosaicos de roadmap, así como con solicitudes satelitales y de terreno en las que las imágenes base se quitan usando "overlay": true y con layerTypes establecido. Los valores de orientation válidos son 0 (el valor predeterminado), 90, 180 y 270.
La cuadrícula de coordenadas del mosaico no se rota si incluyes un valor orientation. Por ejemplo, si estableces orientation en 90, la coordenada x aún define la posición de izquierda a derecha del mosaico, que en este caso es de norte a sur en el mapa.
| Orientación en 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
No hay un mensaje de respuesta del servidor en este ejemplo. 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 previa, almacenamiento en caché o almacenamiento de contenido.