Blocos de terreno

Os blocos de terreno são blocos de imagem que contêm mapeamento de sombreamento de morros e curvas de nível. Eles incluem recursos naturais, como vegetação.

Como acessar blocos de terreno

Você pode começar a fazer solicitações de blocos de terreno depois de receber um token de sessão. Como um token de sessão se aplica a toda a sessão, não é necessário especificar as opções de mapa com as solicitações de bloco.

O exemplo de código abaixo demonstra uma solicitação de token de sessão típica para tiles 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 receber blocos de terreno, faça uma solicitação HTTPS GET, conforme mostrado no exemplo a seguir.

curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY

Exemplo de solicitação de bloco

Considere o exemplo a seguir, que solicita um único bloco de terreno com nível de zoom 10, com 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

Não há mensagem de resposta do servidor neste exemplo. Em vez disso, o bloco é salvo em um arquivo local.

Para informações sobre cabeçalhos de mensagens de resposta, consulte Pré-busca, armazenamento em cache ou armazenamento de conteúdo.