Mosaicos de terreno

Las tarjetas de terreno son tarjetas de imagen que contienen mapas de sombreado de colinas y líneas de contorno. Incluyen características naturales, como la vegetación.

Cómo obtener tarjetas de terreno

Puedes comenzar a realizar solicitudes de tarjetas de terreno después de obtener un token de sesión. Debido a que un token de sesión se aplica a toda la sesión, no es necesario que especifiques las opciones del mapa con tus solicitudes de tarjetas.

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

curl -X POST -d '{
  "mapType": "terrain",
  "language": "en-US",
  "region": "US",
  "layerTypes": ["layerRoadmap"]
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"

Para obtener tarjetas de terreno, debes realizar 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"

Ejemplo de solicitud de tarjeta

Considera el siguiente ejemplo, que solicita una sola tarjeta de terreno con un nivel de zoom de 10 y coordenadas x e y de (192, 401).

curl "https://tile.googleapis.com/v1/2dtiles/10/192/401?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 solo se descarga en un archivo local.

Para obtener información sobre los encabezados de los mensajes de respuesta, consulta Recuperación anticipada o almacenamiento (incluso en caché) del contenido.