Blocos do roteiro

Os blocos de roteiro são blocos de imagem baseados em dados topográficos vetoriais com o estilo cartográfico do Google. Isso inclui estradas, edifícios, pontos de interesse e fronteiras políticas.

Como acessar os blocos do roteiro

Você pode começar a fazer solicitações de blocos do roadmap depois de receber um token de sessão. Como o 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 blocos.

O exemplo de código abaixo demonstra uma solicitação de token de sessão típica para blocos do mapa.

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 os blocos do roadmap, 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&orientation=0_or_90_or_180_or_270"

Nesta solicitação HTTPS GET, z é o nível de zoom (variando de 0 a 22), e x e y são as coordenadas do bloco do bloco que você quer recuperar.

Observação: as coordenadas do bloco não são iguais às coordenadas geográficas. Para mais informações sobre as coordenadas de blocos, consulte Coordenadas de mapa e bloco na documentação da API Maps JavaScript.

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. O orientation tem suporte para blocos roadmap e também para 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 vai definir a posição da esquerda para a direita do bloco, que, nesse caso, é de norte a sul no mapa.

Orientação de zero graus	Orientação de 90 graus

Exemplo de solicitação de bloco

Considere o exemplo a seguir, 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 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.