Mosaicos de hoja de ruta

Descripción general del mosaico 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, puntos de intereses 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 tienes que especificar las opciones de mapa con tus solicitudes de mosaico.

El siguiente ejemplo de código muestra una solicitud de token de sesión típica para tarjetas 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 de HTTPS, como se muestra a continuación. 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. (de 0 a 22) y x y y son las coordenadas de mosaicos de la tarjeta 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 del mosaico. orientation es es compatible con mosaicos de roadmap y también es compatible con solicitudes de relieve sin imágenes base eliminadas con "overlay": true y con Se estableció layerTypes. 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 orientation. valor. 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 mosaico

Ten en cuenta el siguiente ejemplo, que solicita un solo mosaico que contiene el elemento todo el mundo. En este ejemplo, el nivel de zoom es 0, y las coordenadas x e y son 0 o 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 descargas 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.