Mosaicos de hoja de ruta

Los mosaicos de 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.

Cómo obtener tarjetas de la hoja de ruta

Puedes comenzar a realizar solicitudes de tarjetas de hoja 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 del mapa con tus solicitudes de segmentos.

En la siguiente muestra de código, se muestra una solicitud típica de token de sesión para las tarjetas 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 tarjetas de la hoja de ruta, debes realizar 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 va de 0 a 22), y x y y son las coordenadas de la segmentación de la segmentación que deseas recuperar.

El parámetro orientation es opcional. Su valor especifica la cantidad de grados de rotación en sentido contrario a las manecillas del reloj de la imagen de la tarjeta. orientation se admite para las tarjetas roadmap, y también para las solicitudes de imágenes satelitales y de terreno con imágenes base quitadas con "overlay": true y con layerTypes establecido. Los valores válidos de orientation son 0 (predeterminado), 90, 180 y 270.

La cuadrícula de coordenadas de la segmentación 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 de la segmentación, 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 tarjeta

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 ningún 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.