Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Desarrolladores del Espacio Económico Europeo (EEE)
Un token de sesión es un fragmento de datos (un UUID) que se usa en las llamadas a REST para identificar una sesión, es decir, una serie de intercambios de mensajes relacionados. Debes incluir un token de sesión en todas las solicitudes de imágenes de Street View y de Tiles 2D.
Se incluye como el valor de un parámetro session agregado a todas las URLs de solicitud.
En la API de Map Tiles, un token de sesión representa un conjunto definido de opciones de visualización. Esto significa que no tienes que pasar un conjunto de opciones de visualización con cada solicitud de tarjeta. Puedes usar el mismo token de sesión en varios clientes.
Actualmente, un token de sesión es válido durante dos semanas a partir de la fecha de emisión, pero esto podría cambiar. Siempre puedes verificar la hora de vencimiento de un token de sesión consultando el campo expiry en el mensaje de respuesta.
Solicitud de token de sesión
Para solicitar un token de sesión, envía una solicitud HTTPS POST al extremo createSession, como se muestra en el siguiente ejemplo. Debes enviar la solicitud con un encabezado Content-Type: application/json.
tipo de mapa básico. Este valor puede ser uno de los siguientes:
roadmap
Son los mosaicos de mapa pintados estándar de Google Maps.
satellite
Imágenes satelitales.
terrain
Imágenes de terreno Cuando selecciones terrain como el tipo de mapa, también debes incluir el tipo de capa layerRoadmap (que se describe en la sección Campos opcionales).
Es una etiqueta de idioma IETF que especifica el idioma que se usa para mostrar la información en las tarjetas. Por ejemplo, en-US especifica el idioma inglés tal como se habla en Estados Unidos.
region
Es un identificador de región del Common Locale Data Repository (dos letras mayúsculas) que representa la ubicación física del usuario. Por ejemplo, US
Campos opcionales
imageFormat
Especifica el formato de archivo que se devolverá. Los valores válidos son jpeg o png.
Los archivos JPEG no admiten transparencia, por lo que no se recomiendan para las tarjetas superpuestas. Si no especificas un imageFormat, se elegirá automáticamente el mejor formato para la tarjeta.
scale
Aumenta el tamaño de los elementos del mapa (como las etiquetas de las rutas), a la vez que conserva el tamaño de la segmentación y el área de cobertura de la segmentación predeterminada. Aumentar la escala también reduce la cantidad de etiquetas en el mapa, lo que disminuye el desorden. Los siguientes valores son valores scale válidos:
scaleFactor1x: Es el valor predeterminado.
scaleFactor2x: Duplica el tamaño de las etiquetas y quita las etiquetas de las entidades secundarias.
scaleFactor4x: Cuadruplica el tamaño de las etiquetas y quita las etiquetas de los atributos secundarios.
En los siguientes ejemplos, se muestra el efecto de escalar los elementos del mapa.
Factor de escala 1x
Factor de escala 2x
highDpi
Especifica si se deben devolver mosaicos de alta resolución. Si se aumenta el factor de ajuste, se usa highDpi para aumentar el tamaño de la segmentación. Normalmente, aumentar el factor de escala agranda la segmentación resultante en una imagen del mismo tamaño, lo que reduce la calidad. Con highDpi, el tamaño resultante también aumenta, lo que preserva la calidad. DPI significa puntos por pulgada, y DPI alto significa que la tarjeta se renderiza con más puntos por pulgada de lo normal. Si es true, la cantidad de píxeles en cada una de las dimensiones X e Y se multiplica por el factor de escala (es decir , 2x o 4x). El área de cobertura de la tarjeta no cambia.
Este parámetro solo funciona con valores de scale de 2 o 4 veces. No tiene efecto en las tarjetas a escala 1x.
Factor de escala 1x
Factor de escala 2x para DPI alto
layerTypes
Es un array de valores que especifica los tipos de capas que se agregaron al mapa. Los valores válidos son los siguientes:
layerRoadmap
Obligatorio si especificas terrain como el tipo de mapa. También se puede superponer de forma opcional en el tipo de mapa satellite. No tiene efecto en las tarjetas de la hoja de ruta.
layerStreetview
Muestra las calles y ubicaciones habilitadas para Street View con contornos azules en el mapa.
layerTraffic
Muestra las condiciones de tráfico actuales.
styles
Es un array de objetos de estilo JSON que especifican la apariencia y el nivel de detalle de las características del mapa, como rutas, parques y áreas urbanizadas. El diseño se usa para personalizar el mapa base estándar de Google. El parámetro styles solo es válido si el tipo de mapa es roadmap. Para ver la sintaxis de estilo completa, consulta la Referencia de estilo.
overlay
Es un valor booleano que especifica si layerTypes se debe renderizar como una capa superpuesta separada o combinada con las imágenes base. Cuando es true, no se muestra el mapa base. Si no definiste ningún layerTypes, se ignorará este valor.
Por ejemplo, solicitar un tipo de mapa satellite con una capa layerRoadmap y overlay establecido en false genera mosaicos equivalentes al tipo de mapa hybrid que se usa en la API de Maps JavaScript (imagen de la izquierda). Los mismos tipos de mapa y capa con overlay establecido en true generan un mosaico transparente con una superposición de mapa, con el diseño adecuado para superponerse sobre imágenes satelitales (imagen de la derecha).
overlay: false
overlay: true
El siguiente JSON es un ejemplo de un cuerpo de solicitud típico que contiene campos obligatorios y opcionales.
En este ejemplo, se proporciona una superposición adecuada para combinar con imágenes satelitales. El ejemplo contiene una hoja de ruta y una superposición de Street View. El mapa resultante se renderiza con nombres y datos en inglés, tal como se habla en Estados Unidos.
Respuesta del token de sesión
El siguiente JSON es un ejemplo de cuerpo de respuesta.
La siguiente lista contiene definiciones de los campos del cuerpo de la respuesta.
session
Es un valor de token de sesión que debes incluir en todas tus solicitudes a la API de Map Tiles.
expiry
Es una cadena que contiene la hora (en segundos desde la época) en la que vence el token. Un token de sesión es válido durante dos semanas a partir de su fecha de creación, pero esta política puede cambiar sin previo aviso.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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`."]]
