Os blocos de roteiro são blocos de imagem com base em dados topográficos vetoriais
com o estilo cartográfico do Google. Isso inclui vias, edifícios, pontos
interesses 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 de sessão será aplicado à sessão inteira, não será necessário especificar o mapa com suas solicitações de blocos.
O exemplo de código a seguir demonstra uma solicitação de token de sessão típica para blocos de roteiro.
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"
Você obtém blocos de roteiro fazendo uma solicitação GET HTTPS, conforme mostrado no exemplo.
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"
Nesta solicitação GET HTTPS, z
é o nível de zoom.
(variando de 0 a 22) e x
e
y
são os
coordenadas de bloco
do bloco que você quer recuperar.
O parâmetro orientation
é opcional. Seu 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
, além de ser compatível com blocos de satélite e
solicitações de terreno com imagens de base removidas usando "overlay": true
e com
layerTypes
definido. Os valores orientation
válidos são 0 (o padrão), 90, 180 e
270.
A grade de coordenadas do bloco não será girada se você incluir um orientation
. Por exemplo, se você definir orientation
como 90, o
A coordenada x
ainda define a direção da esquerda para a direita
posição do bloco, que, neste caso, é 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 as 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 downloads para um arquivo local, com as seguintes estatísticas.
% 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.