Mosaicos de hoja de ruta

Descripción general de la tarjeta de la hoja de rutaLos mosaicos 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 mosaicos de ruta de planificación 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 mosaico.

En la siguiente muestra de código, se muestra una solicitud de token de sesión típica para las tarjetas de planificación.

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 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 (que varía de 0 a 22) y x y y son las coordenadas de la tarjeta de la tarjeta 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 del mosaico. orientation se admite para mosaicos roadmap y también para 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 (el valor 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 de la tarjeta, que en este caso es de norte a sur en el mapa.

Orientación de cero grados Orientación de 90 grados
Orientación de cero grados Orientación de 90 grados

Ejemplo de solicitud de tarjeta

Considera el siguiente ejemplo, que 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.

Todo el mundo en una sola tarjeta

  % 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 Captura previa, almacenamiento en caché o almacenamiento de contenido.