Usar tokens de sessão com a API Map Tiles

Desenvolvedores do Espaço Econômico Europeu (EEE)

Um token de sessão é um dado (um UUID) usado em chamadas REST para identificar uma sessão, ou seja, uma série de trocas de mensagens relacionadas. É preciso incluir um token de sessão em todas as solicitações de blocos 2D e imagens do Street View. Ele é incluído 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 não é necessário transmitir um conjunto de opções de exibição com cada solicitação de bloco. É possível 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 da data de emissão, mas isso pode mudar. Para verificar o tempo de expiração 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. Envie 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, inclua também o tipo de camada layerRoadmap, descrito na seção Campos opcionais.
streetview
Panoramas do Street View. Para mais informações, 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 Common Locale Data Repository (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 ou png. Os arquivos JPEG não são compatíveis com transparência e, portanto, não são recomendados para blocos de sobreposição. Se você não especificar um imageFormat, o melhor formato para o bloco será escolhido automaticamente.
scale

Aumenta o tamanho dos elementos do mapa (como rótulos 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 rótulos no mapa, o que diminui a confusão. Os seguintes valores são válidos para scale:

  • scaleFactor1x: o padrão.
  • scaleFactor2x: dobra o tamanho do rótulo e remove os rótulos de recursos secundários.
  • scaleFactor4x: quadruplica o tamanho do rótulo e remove os rótulos de recursos secundários.

Os exemplos a seguir demonstram o efeito do escalonamento de elementos do mapa.

Fator de escala 1x Fator de escalonamento 2x
Mapa mostrando o fator de escalonamento 1x Mapa mostrando o fator de escalonamento 2x
highDpi
Especifica se os blocos de alta resolução serão retornados. 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 reduz a qualidade. Com highDpi, o tamanho resultante também aumenta, 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 true, 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. Esse parâmetro só funciona com valores de scale de 2x ou 4x. Ela não afeta os blocos de escala 1x.
Fator de escala 1x Fator de escalonamento 2x DPI alto
Mapa mostrado em resolução normal Mapa exibido em resolução 2x High DPI
layerTypes

Uma matriz de valores que especifica os tipos de camada adicionados ao mapa. Os valores válidos são:

layerRoadmap
Obrigatório se você especificar terrain como o tipo de mapa. Também pode ser sobreposto ao tipo de mapa satellite. Não tem efeito nos blocos do mapa de rotas.
layerStreetview
Mostra ruas e locais com o Street View ativado usando contornos azuis no mapa.
layerTraffic
Mostra as condições de trânsito atuais.
styles

Uma matriz de objetos de estilo JSON que especificam a aparência e o nível de detalhes de recursos do mapa, como vias, parques e áreas construídas. A estilização é usada para personalizar o mapa de base padrão do Google. O parâmetro styles só é válido se o tipo de mapa for roadmap. Para ver a sintaxe completa de estilo, consulte a Referência de estilo.

overlay

Um valor booleano que especifica se layerTypes precisa ser renderizado como uma sobreposição separada ou combinado com as imagens de base. Quando true, o mapa de base não é exibido. Se você não tiver definido nenhum layerTypes, 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). Os mesmos tipos de mapa e camada com overlay definido como true resultam em um bloco transparente com uma cobertura regional, estilizada adequadamente para sobreposição em imagens de satélite (imagem à direita).

overlay: false overlay: true
Sobreposição definida como "false" Sobreposição definida como "true"

O JSON a seguir é um exemplo de um 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 fornece uma sobreposição adequada para combinar com imagens de satélite. O exemplo contém um mapa e uma sobreposição do Street View. O mapa resultante é renderizado com nomes e dados em inglês, como é falado nos Estados Unidos.

Resposta do token de sessão

O JSON a seguir é um exemplo de corpo da 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 o início da era Unix) em que o token expira. Um token de sessão é válido por duas semanas a partir da hora de criação, mas essa política pode mudar 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 ou jpeg.