Los mosaicos de la hoja de ruta son mosaicos de imágenes basados en datos topográficos vectoriales con el diseño cartográfico de Google. Esto incluye rutas, edificios, lugares de interés y límites políticos.
Obteniendo tarjetas de hoja de ruta
Puedes comenzar a realizar solicitudes de tarjetas de 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 necesitas especificar las opciones del mapa con tus solicitudes de tarjetas.
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 HTTPS GET, 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 (de 0 a 22), y x
y y
son las coordenadas de mosaicos del mosaico que quieres 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 mosaicos roadmap
y también en solicitudes satelitales y de terreno en las que se quitan las imágenes base con "overlay": true
y con layerTypes
configurado. Los valores válidos de orientation
son 0 (el predeterminado), 90, 180 y 270.
La cuadrícula de coordenadas de mosaicos 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 de cero grados | Orientación a 90 grados |
---|---|
Ejemplo de solicitud de mosaico
Considera el siguiente ejemplo, en el que se solicita una sola tarjeta que contiene el mundo completo. 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 acerca de los encabezados de los mensajes de respuesta, consulta Recuperación previa, almacenamiento en caché o almacenamiento de contenido.