Utiliser des jetons de session avec l'API Map Tiles

Un jeton de session est une donnée (une UUID) utilisé dans les appels REST pour identifier session : d'échanges de messages associés. Vous devez inclure un jeton de session dans toutes des demandes de tuiles 2D et d'images Street View. Vous l'incluez en tant que valeur d'un paramètre session ajouté à toutes les requêtes. URL.

Dans l'API Map Tiles, un jeton de session représente un ensemble défini options d'affichage. Cela signifie que vous n'avez pas besoin de transmettre un ensemble d'options d'affichage 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 au moment du problème, mais cela pourrait changer. Vous pouvez toujours vérifier la date d'expiration d'un jeton de session en examinant le champ expiry dans le message de réponse.

Demande de jeton de session

Pour demander un jeton de session, envoyez une requête POST HTTPS au point de terminaison createSession, comme illustré 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 terrain Lorsque vous sélectionnez terrain comme type de carte, vous devez également incluent le type de couche layerRoadmap (décrit dans le Champs facultatifs ).
streetview
Panoramas Street View. Pour en savoir plus, consultez Street View Tiles
language

Une Tag de langue IETF qui spécifie la langue utilisée pour afficher les informations sur les tuiles. Pour Par exemple, en-US spécifie la langue anglaise telle qu'elle est parlée aux États-Unis.

region

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 ou png. Les fichiers JPEG n'étant pas compatibles avec la transparence, ils ne sont pas recommandés pour superpositions. Si vous ne spécifiez pas de imageFormat, le format le plus adapté la carte est sélectionnée automatiquement.
scale

Agrandit la taille des éléments de la carte (comme les libellés des routes), tout en conservant la valeur taille de la tuile et zone de couverture de la tuile par défaut. Augmenter l'échelle permet également réduit 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
Carte montrant un facteur d'échelle 1x Carte montrant un facteur d'échelle 2x
highDpi
Spécifie s'il faut afficher des tuiles haute résolution. Si le facteur d'évolutivité est a augmenté, highDpi permet d'augmenter la taille de la carte. Habituellement, L'augmentation du facteur de scaling agrandit la tuile obtenue en une image du même taille, ce qui réduit la qualité. Avec highDpi, la taille obtenue est également pour préserver leur qualité. Le PPP (points par pouce) signifie "points par pouce". Un PPP élevé signifie que la carte utilise plus de points par pouce que la normale. Si la valeur est true, le le nombre de pixels dans chacune des dimensions x et y est multiplié par l'échelle (soit , 2x ou 4x). La zone de couverture de la tuile reste inchangée. Ce paramètre ne fonctionne qu'avec des valeurs scale x2 ou 4x. Cela n'a aucun effet sur les cartes à l'échelle 1.
Facteur d'échelle 1x Facteur de scaling 2x PPP élevé
Carte affichée à une résolution standard Carte affichée à une résolution haute résolution 2 fois
layerTypes

Tableau de valeurs qui spécifie les types de calques ajoutés à la carte. Valide sont les suivantes:

layerRoadmap
Obligatoire si vous spécifiez terrain comme type de carte. Peut également être superposé au type de carte satellite. N'a aucun effet sur les tuiles de la feuille de route.
layerStreetview
Affichage des rues et des lieux compatibles avec Street View à l'aide de contours bleus sur la carte.
layerTraffic
Affiche les conditions de circulation actuelles.
styles

Tableau d'objets de style JSON spécifiant l'apparence et le niveau de détail les éléments cartographiques tels que les routes, les parcs et les zones construites. Le style est utilisé pour personnaliser la carte de base Google standard. Le paramètre styles n'est valide que si le type de carte est roadmap. Pour obtenir la syntaxe de style complète, consultez la Référence de style.

overlay

Valeur booléenne indiquant si layerTypes doit être rendue sous forme de superposition distincte, ou combinée à l'image de base. Quand ? true, la carte de base ne s'affiche pas. Si vous n'avez pas défini de layerTypes, cette valeur est ignorée.

Par exemple, vous pouvez demander un type de carte satellite avec un calque layerRoadmap. Si overlay est défini sur false, vous obtenez des tuiles équivalentes au type de carte hybrid. utilisée dans l'API Maps JavaScript (image de gauche). Identique les types de carte et de calque avec overlay défini sur true génère une tuile transparente. avec une superposition de carte, stylisée de manière appropriée pour se superposer aux images satellite (image de droite).

overlay: faux overlay : true
Superposition définie sur "False" Superposition définie sur "true"

Le code JSON suivant est un exemple de corps de requête type contenant à la fois les 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 associée à une image satellite de l'imagerie. L'exemple contient à la fois une feuille de route et une superposition Street View. La La carte obtenue s'affiche avec des noms et des données en anglais, car il s'agit parlée aux États-Unis.

apiOptions: tableau de valeurs spécifiant les options supplémentaires à appliquer. Les options suivantes sont acceptées :

  • MCYJ5E517XR2JC - Activer le nouvelle carte style d'annonces. Pendant la période d'activation, vos demandes recevront les informations à moins que cette valeur ne soit 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 API Map Tiles de recherche.
expiry
Chaîne contenant l'heure (en secondes depuis l'epoch) à laquelle le jeton expire. Un jeton de session est valide pendant deux semaines à compter de sa création, mais cette règle peut être modifiée sans préavis.
tileWidth
Largeur des tuiles mesurée en pixels.
tileHeight
Hauteur des cartes, mesurée en pixels.
imageFormat
Format de l'image, qui peut être png ou jpeg.