Os blocos de roteiro são blocos de imagem baseados em dados topográficos vetoriais
com o estilo cartográfico do Google. Isso inclui vias, edifícios, pontos de interesse e fronteiras políticas.
Obter blocos de roteiro
Você pode começar a fazer solicitações de blocos do roteiro depois de obter um token de sessão. Como o token de sessão se aplica à sessão inteira, não é necessário especificar as opções de mapa com suas solicitações de bloco.
O exemplo de código a seguir demonstra uma solicitação típica de token de sessão para blocos de roteiros.
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 receber blocos de roteiro, faça uma solicitação GET HTTPS, conforme mostrado no exemplo a seguir.
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"
Nessa solicitação GET HTTPS, z é o nível de zoom
(de 0 a 22), e x e
y são as
coordenadas de bloco
do bloco que você quer recuperar.
O parâmetro orientation é opcional. O valor especifica o número de graus de rotação no sentido anti-horário da imagem do bloco. orientation é compatível com blocos roadmap e com solicitações de satélite e de terreno com imagens de base removidas usando "overlay": true e com layerTypes definido. Os valores válidos de orientation são 0 (padrão), 90, 180 e
270.
A grade de coordenadas do bloco não será girada se você incluir um valor
orientation. Por exemplo, se você definir orientation como 90, a coordenada x ainda definirá a posição da esquerda para a direita do bloco, que, nesse caso, vai de norte a sul no mapa.
| Orientação de zero grau | Orientação de 90 graus |
|---|---|
 |
 |
Exemplo de solicitação de bloco
Considere o exemplo abaixo, que solicita um único bloco que contém o mundo inteiro. Neste exemplo, o nível de zoom é 0 e as coordenadas x e y são 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
Não há mensagem de resposta do servidor neste exemplo. Em vez disso, o bloco é transferido por download para um arquivo local com as estatísticas abaixo.
% 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 informações sobre cabeçalhos de mensagens de resposta, consulte Pré-busca, armazenamento em cache ou armazenamento de conteúdo.