Um token de sessão é um dado (um UUID) usado em chamadas REST para identificar uma sessão, uma série de trocas de mensagens relacionadas. É necessário incluir um token de sessão em todas as
solicitações de blocos 2D e imagens do Street View.
Inclua-o como o valor de um parâmetro session
anexado a todos os URLs de solicitação.
Na API Map Tiles, um token de sessão representa um conjunto definido de
opções de exibição. Isso significa que você não precisa transmitir um conjunto de opções de exibição com
cada solicitação de bloco. Você pode usar o mesmo token de sessão em vários clientes.
No momento, um token de sessão é válido por duas semanas a partir do momento da emissão, mas isso pode mudar. Para verificar o prazo de validade de um token de sessão, consulte o campo expiry
na mensagem de resposta.
Solicitação de token de sessão
Para solicitar um token de sessão, envie uma solicitação HTTPS POST para o endpoint createSession
, conforme mostrado no exemplo a seguir. Você precisa enviar a solicitação com um cabeçalho Content-Type: application/json
.
curl -X POST -d '{ "mapType": "streetview", "language": "en-US", "region": "US" }' \ -H 'Content-Type: application/json' \ "https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"
Campos obrigatórios
mapType
o tipo de mapa base. Esse valor pode ser um destes:
roadmap
- Os blocos de mapa pintados padrão do Google Maps.
satellite
- Imagens de satélite.
terrain
- Imagens de terreno. Ao selecionar
terrain
como o tipo de mapa, você também precisa incluir o tipo de camadalayerRoadmap
(descrito na seção Campos opcionais). streetview
- Panoramas do Street View. Para saber mais, consulte Blocos do Street View.
language
Uma tag de idioma IETF que especifica o idioma usado para mostrar informações nos blocos. Por exemplo,
en-US
especifica o idioma inglês falado nos Estados Unidos.region
Um identificador de região do Repositório comum de dados de localidade (duas letras maiúsculas) que representa a localização física do usuário. Por exemplo,
US
.
Campos opcionais
imageFormat
- Especifica o formato do arquivo a ser retornado. Os valores válidos são
jpeg
oupng
. Os arquivos JPEG não oferecem suporte à transparência, então não são recomendados para blocos de sobreposição. Se você não especificar umimageFormat
, o melhor formato para o bloco vai ser escolhido automaticamente. scale
Aumenta o tamanho dos elementos do mapa, como etiquetas de vias, mantendo o tamanho do bloco e a área de cobertura do bloco padrão. Aumentar a escala também reduz o número de etiquetas no mapa, o que deixa tudo mais organizado. Os seguintes valores são
scale
válidos:scaleFactor1x
: o padrão.scaleFactor2x
: duplica o tamanho do rótulo e remove rótulos de recursos secundários.scaleFactor4x
: quadruplicar o tamanho do rótulo e remove rótulos de recursos secundários.
Os exemplos a seguir demonstram o efeito de dimensionar elementos do mapa.
Fator de escala 1x | Fator de escala 2x |
---|---|
highDpi
- Especifica se é necessário retornar blocos de alta resolução. Se o fator de escala for
aumentado,
highDpi
será usado para aumentar o tamanho do bloco. Normalmente, aumentar o fator de escala amplia o bloco resultante em uma imagem do mesmo tamanho, o que diminui a qualidade. ComhighDpi
, o tamanho resultante também é aumentado, preservando a qualidade. DPI significa pontos por polegada, e DPI alto significa que o bloco é renderizado usando mais pontos por polegada do que o normal. Se fortrue
, o número de pixels em cada uma das dimensões x e y será multiplicado pelo fator de escala (ou seja , 2x ou 4x). A área de cobertura do bloco permanece inalterada. Este parâmetro funciona apenas com valoresscale
de 2x ou 4x. Não tem efeito em blocos de escala 1x.
Fator de escala 1x | Fator de escala 2x DPI alto |
---|---|
layerTypes
Uma matriz de valores que especifica os tipos de camada adicionados ao mapa. Os valores válidos são estes:
layerRoadmap
- Obrigatório se você especificar
terrain
como o tipo de mapa. Também podem ser sobrepostos no tipo de mapasatellite
. Não tem efeito nos blocos da estratégia. layerStreetview
- Mostra ruas e locais com Street View ativado usando contornos azuis no mapa.
layerTraffic
- Exibe as condições atuais de trânsito.
styles
Uma matriz de objetos de estilo JSON que especificam a aparência e o nível de detalhes dos elementos do mapa, como vias, parques e áreas construídas. A estilização é usada para personalizar o Mapa básico padrão do Google. O parâmetro
styles
só é válido se o tipo de mapa éroadmap
. Para conferir a sintaxe completa do estilo, consulte a Referência de estilos.overlay
Um valor booleano que especifica se
layerTypes
precisa ser renderizado como uma sobreposição separada ou combinado com as imagens de base. Quando fortrue
, o mapa base não será exibido. Se você não tiver definido nenhumlayerTypes
, esse valor será ignorado.
Por exemplo, solicitar um tipo de mapa satellite
com uma camada layerRoadmap
e overlay
definido como false
resulta em blocos equivalentes ao tipo de mapa hybrid
usado na API Maps JavaScript (imagem à esquerda). O mesmo tipo de mapa e camada com overlay
definido como true
resulta em um bloco transparente com uma sobreposição de mapa, estilizado corretamente para sobrepor imagens de satélite (imagem à direita).
overlay : falso |
overlay : verdadeiro |
---|---|
O JSON a seguir é um exemplo de corpo de solicitação típico que contém campos obrigatórios e opcionais.
{
"mapType": "satellite",
"language": "en-US",
"region": "us",
"layerTypes": [ "layerRoadmap", "layerStreetview" ],
"overlay": true,
"scale": "scaleFactor1x",
"styles": [
{
"stylers": [
{ "hue": "#00ffe6" },
{ "saturation": -20 }
]
},{
"featureType": "road",
"elementType": "geometry",
"stylers": [
{ "lightness": 100 },
{ "visibility": "simplified" }
]
}
]
}
Este exemplo mostra uma sobreposição adequada para combinar com imagens de satélite. O exemplo contém um roteiro e uma sobreposição do Street View. O mapa resultante é renderizado com nomes e dados no idioma inglês, como é falado nos Estados Unidos.
apiOptions
: uma matriz de valores que especifica outras opções a serem aplicadas.
As opções compatíveis são:
MCYJ5E517XR2JC
: ative o novo estilo de mapa. Durante o período de ativação, suas solicitações receberão o estilo atual, a menos que esse valor seja especificado.
Resposta do token de sessão
O JSON a seguir é um exemplo de corpo de resposta.
{
"session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
"expiry": "1361828036",
"tileWidth": 256,
"tileHeight": 256,
"imageFormat": "png"
}
A lista a seguir contém definições dos campos no corpo da resposta.
session
- Um valor de token de sessão que você precisa incluir em todas as solicitações da API Map Tiles.
expiry
- Uma string que contém o tempo (em segundos desde a época) em que o token expira. Um token de sessão é válido por duas semanas a partir do momento da criação, mas essa política pode ser alterada sem aviso prévio.
tileWidth
- A largura dos blocos medida em pixels.
tileHeight
- A altura dos blocos medida em pixels.
imageFormat
- O formato da imagem, que pode ser
png
oujpeg
.