Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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. Você precisa 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 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 da data de emissão, mas isso pode mudar. Você pode verificar o tempo de expiração de um token de sessão consultando 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. É necessário enviar a solicitação com um cabeçalho Content-Type: application/json.
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
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. 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 funciona apenas com valores de scale de 2x ou 4x. Ela não afeta os 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:
layerRoadmap
Obrigatório se você especificar terrain como o tipo de mapa. Também pode ser sobreposto opcionalmente 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 dos 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 é mostrado. 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 sobreposição de mapa, estilizada adequadamente para sobreposição em imagens de satélite (imagem à direita).
overlay: false
overlay: true
O JSON a seguir é um exemplo de um corpo de solicitação típico que contém campos obrigatórios e opcionais.
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 de resposta.
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 horário (em segundos desde o início do período) em que o token
expira. Um token de sessão é válido por duas semanas a partir da criação, mas essa política pode mudar sem aviso prévio.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eSession tokens, represented as UUIDs, are required for accessing 2D Tiles and Street View imagery through the Map Tiles API but not for 3D Tiles.\u003c/p\u003e\n"],["\u003cp\u003eThey define display options for a session, eliminating the need to send them with each tile request and can be used across multiple clients.\u003c/p\u003e\n"],["\u003cp\u003eTo obtain a session token, an HTTPS POST request is sent to the \u003ccode\u003ecreateSession\u003c/code\u003e endpoint with parameters defining the map type, language, region, and optional display settings.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes the session token, its expiration time, and tile dimensions, with the token remaining valid for approximately two weeks.\u003c/p\u003e\n"]]],[],null,["# Use session tokens with Map Tiles API\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google\n| Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. [Learn more](/maps/comms/eea/faq). In addition, certain content from the Map Tiles API will no longer be returned. [Learn more](/maps/comms/eea/map-tiles).\n\nA session token is a piece of data (a\n[UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier))\nthat is used in REST calls to identify a\n[session](https://en.wikipedia.org/wiki/Session_(computer_science))---a\nseries of related message exchanges. You must include a session token in all\nrequests for 2D Tiles and Street View imagery.\nYou include it as the value of a `session` parameter appended to all request\nURLs.\n\nIn the Map Tiles API, a session token represents a defined set of\ndisplay options. It means you don't have to pass a set of display options with\neach tile request. You can use the same session token across multiple clients.\nA session token is currently valid for two weeks from its\nissue time, but this might change. You can always check the expiration time of a\nsession token by looking at the `expiry` field in the response message.\n| **Note:** You need to use session tokens for getting 2D Tiles and Street View Tiles, but not for getting 3D Tiles.\n\nSession token request\n---------------------\n\nTo request a session token, send an HTTPS POST request to the `createSession`\nendpoint, as shown in the following example. You must send the request with a\n`Content-Type: application/json` header. \n\n```json\ncurl -X POST -d '{\n \"mapType\": \"streetview\",\n \"language\": \"en-US\",\n \"region\": \"US\"\n}' \\\n-H 'Content-Type: application/json' \\\n\"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY\"\n```\n\n### Required fields\n\n`mapType`\n\n: The type of base map. This value can be one of the following:\n\n `roadmap`\n : The standard Google Maps painted map tiles.\n\n `satellite`\n : Satellite imagery.\n\n `terrain`\n : Terrain imagery. When selecting `terrain` as the map type, you must also\n include the `layerRoadmap` layer type (described in the\n [Optional fields](/maps/documentation/tile/session_tokens#optional_fields)\n section).\n\n `streetview`\n : Street View panoramas. For more information, see\n [Street View Tiles](/maps/documentation/tile/streetview).\n\n`language`\n\n: An\n [IETF language tag](https://en.wikipedia.org/wiki/IETF_language_tag)\n that specifies the language used to display information on the tiles. For\n example, `en-US` specifies the English language as spoken in the United States.\n\n`region`\n\n: A\n [Common Locale Data Repository](https://cldr.unicode.org/)\n region identifier (two uppercase letters) that represents the physical location\n of the user. For example, `US`.\n\n### Optional fields\n\n`imageFormat`\n: Specifies the file format to return. Valid values are either `jpeg` or `png`.\n JPEG files don't support transparency, therefore they aren't recommended for\n overlay tiles. If you don't specify an `imageFormat`, then the best format for\n the tile is chosen automatically.\n\n`scale`\n\n: Scales-up the size of map elements (such as road labels), while retaining the\n tile size and coverage area of the default tile. Increasing the scale also\n reduces the number of labels on the map, which reduces clutter. The following\n values are valid `scale` values:\n\n - `scaleFactor1x`: The default.\n - `scaleFactor2x`: Doubles label size and removes minor feature labels.\n - `scaleFactor4x`: Quadruples label size and removes minor feature labels.\n\nThe following examples demonstrate the effect of scaling map elements.\n\n| Scale Factor 1x | Scale Factor 2x |\n|-----------------|-----------------|\n| | |\n\n`highDpi`\n: Specifies whether to return high-resolution tiles. If the scale-factor is\n increased, `highDpi` is used to increase the size of the tile. Normally,\n increasing the scale factor enlarges the resulting tile into an image of the\n same size, which lowers quality. With `highDpi`, the resulting size is also\n increased, preserving quality. DPI stands for Dots per Inch, and High DPI means\n the tile renders using more dots per inch than normal. If `true`, then the\n number of pixels in each of the x and y dimensions is multiplied by the scale\n factor (that is , 2x or 4x). The coverage area of the tile remains unchanged.\n This parameter works only with `scale` values of 2x or 4x. It has no effect on\n 1x scale tiles.\n\n| Scale Factor 1x | Scale Factor 2x High DPI |\n|-----------------|--------------------------|\n| | |\n\n`layerTypes`\n\n: An array of values that specifies the layer types added to the map. Valid\n values are:\n\n `layerRoadmap`\n : Required if you specify `terrain` as the map type. Can also be optionally\n overlaid on the `satellite` map type. Has no effect on roadmap tiles.\n\n `layerStreetview`\n : Shows Street View-enabled streets and locations using blue outlines on the\n map.\n\n `layerTraffic`\n : Displays current traffic conditions.\n\n`styles`\n\n: An array of JSON style objects that specify the appearance and detail level of\n map features such as roads, parks, and built-up areas. Styling is used to\n customize the standard Google base map. The `styles` parameter is valid only if\n the map type is `roadmap`. For the complete style syntax, see the\n [Style Reference](/maps/documentation/tile/style-reference).\n\n`overlay`\n\n: A boolean value that specifies whether `layerTypes` should be\n rendered as a separate overlay, or combined with the base imagery. When\n `true`, the base map isn't displayed. If you haven't defined any `layerTypes`,\n then this value is ignored.\n\nFor example, requesting a `satellite` map type with a `layerRoadmap` layer, and\n`overlay` set to `false` results in tiles equivalent to the `hybrid` map type\nused in the Maps JavaScript API (left image). The same\nmap and layer types with `overlay` set to `true` results in a transparent tile\nwith a map overlay, styled appropriately for overlaying over satellite imagery\n(right image).\n\n| `overlay`: false | `overlay`: true |\n|------------------|-----------------|\n| | |\n\nThe following JSON is an example of a typical request body that contains both\nrequired and optional fields. \n\n {\n \"mapType\": \"satellite\",\n \"language\": \"en-US\",\n \"region\": \"us\",\n \"layerTypes\": [ \"layerRoadmap\", \"layerStreetview\" ],\n \"overlay\": true,\n \"scale\": \"scaleFactor1x\",\n \"styles\": [\n {\n \"stylers\": [\n { \"hue\": \"#00ffe6\" },\n { \"saturation\": -20 }\n ]\n },{\n \"featureType\": \"road\",\n \"elementType\": \"geometry\",\n \"stylers\": [\n { \"lightness\": 100 },\n { \"visibility\": \"simplified\" }\n ]\n }\n ]\n }\n\nThis example provides an overlay that's suitable for combining with satellite\nimagery. The example contains both a roadmap and street view overlay. The\nresulting map is rendered with names and data in the English language, as it's\nspoken in the United States.\n\nSession token response\n----------------------\n\nThe following JSON is an example response body. \n\n {\n \"session\": \"IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg\",\n \"expiry\": \"1361828036\",\n \"tileWidth\": 256,\n \"tileHeight\": 256,\n \"imageFormat\": \"png\"\n }\n\nThe following list contains definitions of the fields in the response body.\n\n`session`\n: A session token value that you must include in all of your Map Tiles API\n requests.\n\n`expiry`\n: A string that contains the time (in seconds since the epoch) at which the token\n expires. A session token is valid for two weeks from its creation\n time, but this policy might change without notice.\n\n`tileWidth`\n: The width of the tiles measured in pixels.\n\n`tileHeight`\n: The height of the tiles measured in pixels.\n\n`imageFormat`\n: The image format, which can be either `png` or `jpeg`."]]
