Un jeton de session est une donnée (UUID) utilisée dans les appels REST pour identifier une session, c'est-à-dire une série d'échanges de messages associés. Vous devez inclure un jeton de session dans toutes les requêtes de tuiles 2D et d'images Street View.
Vous l'incluez en tant que valeur d'un paramètre session
ajouté à toutes les URL de requête.
Dans l'API Map Tiles, un jeton de session représente un ensemble défini d'options d'affichage. Cela signifie que vous n'avez pas besoin de transmettre un ensemble d'options d'affichage avec chaque requête de carte. Vous pouvez utiliser le même jeton de session pour plusieurs clients.
Un jeton de session est actuellement valide pendant deux semaines à compter de sa date d'émission, mais cela peut changer. Vous pouvez toujours vérifier le délai d'expiration d'un jeton de session en consultant le champ expiry
du message de réponse.
Demande de jeton de session
Pour demander un jeton de session, envoyez une requête HTTPS POST au point de terminaison createSession
, comme indiqué dans l'exemple suivant. Vous devez envoyer la requête avec un en-tête 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"
Champs obligatoires
mapType
Type de la carte de base. Cette valeur peut être l'une des suivantes :
roadmap
- Tuiles de carte peintes Google Maps standards.
satellite
- Images satellite.
terrain
- Images du relief. Lorsque vous sélectionnez
terrain
comme type de carte, vous devez également inclure le type de calquelayerRoadmap
(décrit dans la section Champs facultatifs). streetview
- Panoramas Street View. Pour en savoir plus, consultez Cartes Street View.
language
Tag de langue IETF qui spécifie la langue utilisée pour afficher les informations sur les tuiles. Par exemple,
en-US
spécifie la langue anglaise telle qu'elle est parlée aux États-Unis.region
Un identifiant de région Common Locale Data Repository (deux lettres majuscules) représentant l'emplacement physique de l'utilisateur. Exemple :
US
Champs facultatifs
imageFormat
- Spécifie le format de fichier à renvoyer. Les valeurs valides sont
jpeg
oupng
. Les fichiers JPEG ne sont pas compatibles avec la transparence. Ils ne sont donc pas recommandés pour les tuiles superposées. Si vous ne spécifiez pas deimageFormat
, le format le mieux adapté à la carte est choisi automatiquement. scale
Agrandit la taille des éléments de la carte (tels que les libellés des routes), tout en conservant la taille de la tuile et la zone de couverture de la tuile par défaut. Augmenter l'échelle réduit également le nombre de libellés sur la carte, ce qui réduit l'encombrement. Les valeurs suivantes sont des valeurs
scale
valides:scaleFactor1x
: valeur par défaut.scaleFactor2x
: double la taille des libellés et supprime ceux des éléments géographiques mineurs.scaleFactor4x
: quadruple la taille des libellés et supprime ceux des éléments géographiques mineurs.
Les exemples suivants illustrent l'effet de la mise à l'échelle des éléments de la carte.
Facteur d'échelle 1x | Facteur d'échelle 2x |
---|---|
![]() |
![]() |
highDpi
- Spécifie s'il faut afficher des tuiles haute résolution. Si le facteur de scaling est augmenté,
highDpi
permet d'augmenter la taille de la carte. Normalement, l'augmentation du facteur de mise à l'échelle agrandit la tuile obtenue en une image de même taille, ce qui diminue la qualité. AvechighDpi
, la taille résultante est également augmentée, ce qui préserve la qualité. DPI signifie "points par pouce" et "High DPI" signifie que la tuile s'affiche en utilisant plus de points par pouce que d'habitude. Si la valeur esttrue
, le nombre de pixels dans chacune des dimensions x et y est multiplié par le facteur d'échelle (soit 2x ou 4x). La zone de couverture de la tuile reste inchangée. Ce paramètre ne fonctionne qu'avec des valeursscale
x2 ou 4x. Cela n'a aucun effet sur les tuiles de l'échelle 1x.
Facteur d'échelle 1x | Facteur d'échelle 2 x PPP élevé |
---|---|
![]() |
![]() |
layerTypes
Tableau de valeurs spécifiant les types de calques ajoutés à la carte. Les valeurs valides sont les suivantes:
layerRoadmap
- Obligatoire si vous spécifiez
terrain
comme type de carte. Peut également être superposé au type de cartesatellite
. N'a aucun effet sur les tuiles de la feuille de route. layerStreetview
- Indique les rues et les lieux pour lesquels Street View est activé à l'aide de contours bleus sur la carte.
layerTraffic
- Affiche les conditions de circulation actuelles.
styles
Tableau d'objets de style JSON qui spécifient l'apparence et le niveau de détail des éléments cartographiques tels que les routes, les parcs et les zones construites. Les styles permettent de personnaliser la carte de base Google standard. Le paramètre
styles
n'est valide que si le type de carte estroadmap
. Pour connaître la syntaxe complète du style, consultez la documentation de référence sur les styles.overlay
Valeur booléenne indiquant si
layerTypes
doit être affiché sous forme de superposition distincte ou combiné avec l'image de base. Lorsque la valeur esttrue
, la carte de base n'est pas affichée. Si vous n'avez défini aucunlayerTypes
, cette valeur est ignorée.
Par exemple, demander un type de carte satellite
avec un calque layerRoadmap
et overlay
défini sur false
génère des tuiles équivalentes au type de carte hybrid
utilisé dans l'API Maps JavaScript (image de gauche). Les mêmes types de carte et de calques lorsque overlay
est défini sur true
génère une tuile transparente avec une superposition de carte, stylisée de manière appropriée pour la superposition sur l'image satellite (image de droite).
overlay : faux |
overlay : true |
---|---|
![]() |
![]() |
Le code JSON suivant est un exemple de corps de requête type contenant à la fois des champs obligatoires et facultatifs.
{
"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" }
]
}
]
}
Cet exemple fournit une superposition pouvant être combinée avec une imagerie satellite. L'exemple contient à la fois une feuille de route et une superposition Street View. La carte obtenue est affichée avec les noms et les données en anglais, tel qu'il est prononcé aux États-Unis.
apiOptions
: tableau de valeurs spécifiant les options supplémentaires à appliquer.
Les options suivantes sont acceptées :
MCYJ5E517XR2JC
: activez le nouveau style de carte. Pendant la période d'activation, le style existant est appliqué à vos requêtes, sauf si cette valeur est spécifiée.
Réponse du jeton de session
Le code JSON suivant est un exemple de corps de réponse.
{
"session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
"expiry": "1361828036",
"tileWidth": 256,
"tileHeight": 256,
"imageFormat": "png"
}
La liste suivante contient les définitions des champs dans le corps de la réponse.
session
- Valeur de jeton de session que vous devez inclure dans toutes vos requêtes API Map Tiles.
expiry
- Chaîne contenant l'heure d'expiration du jeton (en secondes depuis l'epoch). Un jeton de session est valide pendant deux semaines à compter de sa date de création, mais cette règle peut être modifiée sans préavis.
tileWidth
- Largeur des tuiles mesurée en pixels.
tileHeight
- Hauteur des tuiles, mesurée en pixels
imageFormat
- Format de l'image, qui peut être
png
oujpeg
.