Un token de sesión es un dato (un
UUID)
que se usa en las llamadas de REST para identificar un
session: una
varios intercambios de mensajes relacionados. Debes incluir un token de sesión en todos
solicitudes de mosaicos 2D e imágenes de Street View.
Se incluye como el valor de un parámetro session
anexado a todas las solicitudes.
URLs.
En la API de Map Tiles API, un token de sesión representa un conjunto definido de
opciones de visualización. Significa que no tienes que pasar un conjunto de opciones de visualización con
cada solicitud de mosaico. Puedes usar el mismo token de sesión en varios clientes.
Un token de sesión es válido por dos semanas desde su
el momento de la solicitud, pero esto puede cambiar. Puedes verificar en cualquier momento la fecha de vencimiento de un
token de sesión observando 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 createSession
extremo, como se muestra en el siguiente ejemplo. Debes enviar la solicitud con una
Encabezado 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 obligatorios
mapType
tipo de mapa básico. Este valor puede ser uno de los siguientes:
roadmap
- Los mosaicos de mapas estándares pintados de Google Maps.
satellite
- Imágenes satelitales
terrain
- Imágenes del terreno Al seleccionar
terrain
como el tipo de mapa, también debes incluir el tipo de capalayerRoadmap
(descrito en la Campos opcionales sección). streetview
- Panorámicas de Street View. Para obtener más información, consulta Mosaicos de Street View.
language
Los Etiqueta de idioma de IETF que especifique el idioma utilizado para mostrar información en las tarjetas. Para Por ejemplo,
en-US
especifica el idioma inglés que se habla en Estados Unidos.region
R Repositorio de datos de configuración regional común identificador de región (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 mostrará. Los valores válidos son
jpeg
opng
. Los archivos JPEG no admiten transparencia, por lo que no se recomiendan para superposición de mosaicos. Si no especificas unimageFormat
, el mejor formato para la tarjeta se elige automáticamente. scale
Aumenta la escala de los elementos del mapa (como las etiquetas de rutas) y, al mismo tiempo, mantiene el tamaño de mosaico y el área de cobertura del mosaico predeterminado. Aumentar la escala también reduce la cantidad de etiquetas en el mapa, lo que reduce el desorden. Lo siguiente valores son valores
scale
válidos:scaleFactor1x
: Es el valor predeterminado.scaleFactor2x
: Duplica el tamaño de la etiqueta y quita las etiquetas de componentes menores.scaleFactor4x
: cuadruplica el tamaño de la etiqueta y quita las etiquetas de atributos menores.
En los siguientes ejemplos, se demuestra 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 el factor de escala es
aumenta,
highDpi
se usa para aumentar el tamaño de la tarjeta. Normalmente, Al aumentar el factor de escala, se agranda el mosaico resultante y se transforma en una imagen del del mismo tamaño, lo que disminuye la calidad. ConhighDpi
, el tamaño resultante también se ve afectado. aumentada, lo que preserva la calidad. DPI significa puntos por pulgada, y un valor alto de DPI significa la tarjeta se renderiza usando más puntos por pulgada de lo normal. Si estrue
, entonces el la cantidad de píxeles en cada una de las dimensiones x e y se multiplica por la escala (es decir , 2x o 4x). El área de cobertura de la tarjeta no se modifica. Este parámetro solo funciona con valoresscale
de 2x o 4x. No tiene efecto en Tarjetas con una escala de 1x.
Factor de escala 1x | Factor de escala 2x alto DPI |
---|---|
![]() |
![]() |
layerTypes
Es un array de valores que especifica los tipos de capas agregados al mapa. Válida son los siguientes:
layerRoadmap
- Es obligatorio si especificas
terrain
como el tipo de mapa. También puede superpuesto en el tipo de mapasatellite
. No tiene efecto en los mosaicos de hojas de ruta. layerStreetview
- Muestra calles y ubicaciones habilitadas para Street View con contornos azules en el mapa.
layerTraffic
- Muestra las condiciones actuales del tráfico.
styles
Un array de objetos de estilo JSON que especifica la apariencia y el nivel de detalle de componentes del mapa, como rutas, parques y áreas con edificaciones. El estilo se usa para personalizar el mapa base estándar de Google, El parámetro
styles
solo es válido si el tipo de mapa esroadmap
. Para ver la sintaxis de estilo completa, consulta la Referencia de estilo.overlay
Un valor booleano que especifica si
layerTypes
debe se renderizan como una superposición independiente o se combinan con las imágenes de base. Cuándotrue
, no se muestra el mapa base. Si no definiste ningúnlayerTypes
, se ignora este valor.
Por ejemplo, solicitar un tipo de mapa satellite
con una capa layerRoadmap
.
overlay
establecido en false
da como resultado mosaicos equivalentes al tipo de mapa hybrid
.
que se usa en la API de Maps JavaScript (imagen izquierda). Es igual.
los tipos de mapa y de capas con overlay
establecido en true
da como resultado un mosaico transparente.
con un mapa superpuesto, con el estilo adecuado para superponer imágenes satelitales
(imagen derecha).
overlay : falso |
overlay : verdadero |
---|---|
![]() |
![]() |
El siguiente JSON es un ejemplo de un cuerpo de solicitud típico que contiene tanto campos obligatorios y opcionales.
{
"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" }
]
}
]
}
En este ejemplo, se proporciona una superposición que se puede combinar con satélite imágenes. El ejemplo contiene una hoja de ruta y una superposición de Street View. El el mapa resultante se renderiza con nombres y datos en inglés, ya que está que se hablan en Estados Unidos.
apiOptions
: Es un array de valores que especifica las opciones adicionales que se aplicarán.
Las opciones compatibles son las siguientes:
MCYJ5E517XR2JC
: Habilita la nuevo mapa estilo. Durante el período de aceptación, tus solicitudes obtendrán el estado estilo, a menos que se especifique este valor.
Respuesta del token de sesión
El siguiente JSON es un ejemplo de cuerpo de respuesta.
{
"session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
"expiry": "1361828036",
"tileWidth": 256,
"tileHeight": 256,
"imageFormat": "png"
}
La siguiente lista contiene definiciones de los campos del cuerpo de la respuesta.
session
- Un valor del token de sesión que debes incluir en todas tus APIs de Map Tiles de acceso a los datos.
expiry
- Una cadena que contiene la hora (en segundos a partir del ciclo de entrenamiento) en la que el token y vence el período de vencimiento. Un token de sesión es válido durante dos semanas a partir de su creación pero esta política podría cambiar sin previo aviso.
tileWidth
- El ancho de los mosaicos medido en píxeles.
tileHeight
- Es la altura de los mosaicos medida en píxeles.
imageFormat
- Es el formato de imagen, que puede ser
png
ojpeg
.