Commencer

Introduction

L'API Maps Static renvoie une image (GIF, PNG ou JPEG) en réponse à une requête HTTP via une URL. Pour chaque requête, vous pouvez spécifier l'emplacement de la carte, la taille de l'image, le niveau de zoom, le type de carte et l'emplacement des repères facultatifs à des emplacements sur la carte. Vous pouvez également étiqueter vos repères à l'aide de caractères alphanumériques.

Une image d'API Maps Static est intégrée dans l'attribut src d'une balise <img> ou son équivalent dans d'autres langages de programmation.

Ce document décrit le format requis des URL d'API Maps Static et les paramètres disponibles. Il propose également des conseils et astuces pour spécifier vos URL.

Avant de commencer

Ce document est destiné aux développeurs de sites Web et d'applications mobiles qui souhaitent inclure des images de l'API Maps Static dans une page Web ou une application mobile. Elle présente l'utilisation de l'API et présente des supports de référence sur les paramètres disponibles.

Avant de commencer à développer avec l'API Maps Static, consultez les exigences d'authentification (vous avez besoin d'une clé API) et les informations sur l'utilisation et la facturation de l'API (vous devez activer la facturation dans votre projet).

Paramètres d'URL

L'URL d'une API Maps Static doit respecter le format suivant:

https://maps.googleapis.com/maps/api/staticmap?parameters

Si votre site Web est accessible via HTTPS, vous devez également charger les images de l'API Maps Static via HTTPS afin d'éviter les alertes de sécurité du navigateur. HTTPS est également recommandé si vos requêtes incluent des informations sensibles sur l'utilisateur, telles que sa position:

https://maps.googleapis.com/maps/api/staticmap?parameters

Que vous utilisiez HTTP ou HTTPS, certains paramètres d'URL sont obligatoires, tandis que d'autres sont facultatifs. Comme c'est la norme pour les URL, tous les paramètres sont séparés par une esperluette (&). La liste des paramètres et leurs valeurs possibles sont énumérées dans ce document.

L'API Maps Static définit les images de carte à l'aide des paramètres d'URL suivants:

Paramètres de localisation

  • center (obligatoire en l'absence de repères) définit le centre de la carte, à distance de tous les bords de celle-ci. Ce paramètre utilise un lieu sous la forme d'une paire {latitude,longitude} séparée par une virgule (par exemple, "40.714728,-73.998672") ou d'une adresse de chaîne (par exemple, "hôtel de ville, new-york, NY") identifiant un lieu unique sur la Terre. Pour en savoir plus, consultez la section Emplacements.
  • zoom (obligatoire en l'absence de repères) définit le niveau de zoom de la carte, qui détermine le niveau d'agrandissement de la carte. Ce paramètre utilise une valeur numérique correspondant au niveau de zoom sur la région souhaitée. Pour en savoir plus, consultez Niveaux de zoom.

Paramètres de la carte

  • size (obligatoire) définit les dimensions rectangulaires de l'image de la carte. Ce paramètre prend une chaîne au format {horizontal_value}x{vertical_value}. Par exemple, 500x400 définit une carte de 500 pixels de large sur 400 pixels de haut. Les cartes dont la largeur est inférieure à 180 pixels affichent un logo Google de taille réduite. Ce paramètre est affecté par le paramètre scale. La taille de sortie finale est le produit des valeurs de taille et d'échelle.
  • scale (facultatif) affecte le nombre de pixels renvoyés. scale=2 renvoie deux fois plus de pixels que scale=1, tout en conservant la même zone de couverture et le même niveau de détail (le contenu de la carte ne change pas). Cette fonctionnalité est utile pour le développement destiné aux écrans haute résolution. La valeur par défaut est 1. Les valeurs acceptées sont 1 et 2. Pour plus d'informations, consultez la section Valeurs d'échelle.
  • format (facultatif) définit le format de l'image obtenue. Par défaut, l'API Maps Static crée des images PNG. Plusieurs formats sont possibles, y compris les types GIF, JPEG et PNG. Le format à utiliser dépend de la manière dont vous souhaitez présenter l'image. JPEG offre généralement une plus grande compression, tandis que GIF et PNG fournissent plus de détails. Pour en savoir plus, consultez Formats d'image.
  • maptype (facultatif) définit le type de carte à construire. Il existe plusieurs valeurs de maptype possibles, y compris roadmap, satellite, hybrid et terrain. Pour en savoir plus, consultez Types de cartes des API Maps Static.
  • language (facultatif) définit la langue à utiliser pour l'affichage des libellés sur les tuiles de carte. Notez que ce paramètre n'est compatible qu'avec certaines tuiles de pays. Si la langue spécifique demandée n'est pas prise en charge pour l'ensemble de tuiles, la langue par défaut de ce jeu de tuiles est utilisée.
  • region (facultatif) définit les frontières à afficher en fonction des sensibilités géopolitiques. Accepte un code régional spécifié sous la forme d'une valeur ccTLD (domaine de premier niveau) à deux caractères. Consultez Détails de la couverture Google Maps Platform pour connaître les régions acceptées.

Paramètres de la fonctionnalité

  • map_id (facultatif) spécifie l'identifiant d'une carte spécifique. L'ID de carte associe une carte à un style ou un élément géographique particulier et doit appartenir au même projet que la clé API utilisée pour initialiser la carte. Pour en savoir plus, consultez Utiliser des ID de carte.
  • markers (facultatif) définit un ou plusieurs repères à associer à l'image aux emplacements spécifiés. Ce paramètre nécessite une seule définition de repère avec des paramètres séparés par une barre verticale (|). Plusieurs repères peuvent être placés dans le même paramètre markers s'ils présentent le même style. Vous pouvez ajouter des repères de styles différents en ajoutant des paramètres markers supplémentaires. Notez que si vous fournissez des repères pour une carte, vous n'avez pas besoin de spécifier les paramètres center et zoom (normalement requis). Pour en savoir plus, consultez Repères d'API Maps Static.
  • path (facultatif) définit un chemin unique composé d'au moins deux points connectés à superposer sur l'image aux emplacements spécifiés. Ce paramètre prend une chaîne de définitions de points séparées par une barre verticale (|) ou une polyligne encodée utilisant le préfixe enc: dans la déclaration d'emplacement du tracé. Vous pouvez fournir des chemins d'accès supplémentaires en ajoutant des paramètres path supplémentaires. Notez que si vous fournissez un chemin d'accès pour une carte, vous n'avez pas besoin de spécifier les paramètres center et zoom (normalement requis). Pour en savoir plus, consultez Chemins d'accès des API Maps Static.
  • visible (facultatif) spécifie un ou plusieurs lieux qui doivent rester visibles sur la carte, bien qu'aucun repère ni autre indicateur ne s'affiche. Utilisez ce paramètre pour vous assurer que certains éléments géographiques ou emplacements sur la carte sont affichés dans l'API Maps Static.
  • style (facultatif) définit un style personnalisé pour modifier la présentation d'un élément géographique spécifique (routes, parcs et autres éléments géographiques) de la carte. Ce paramètre utilise des arguments feature et element identifiant les éléments géographiques à styliser, ainsi qu'un ensemble d'opérations de style à appliquer aux éléments géographiques sélectionnés. Vous pouvez fournir plusieurs styles en ajoutant des paramètres style supplémentaires. Pour en savoir plus, consultez le guide des cartes stylisées.

Paramètres de clé et de signature

  • key (obligatoire) vous permet de surveiller l'utilisation des API de votre application dans la console Google Cloud et garantit que Google peut vous contacter au sujet de votre application si nécessaire. Pour en savoir plus, consultez Utiliser des clés API avec l'API Maps Static.
  • signature (recommandé) est une signature numérique permettant de vérifier que tous les sites qui génèrent des requêtes à l'aide de votre clé API sont autorisés à le faire. Les requêtes sans signature numérique peuvent échouer. Pour en savoir plus, consultez Utiliser une signature numérique.

Restriction liée à la taille des URL

Les URL d'API Maps Static sont limitées à 16 384 caractères. En pratique, vous n'aurez probablement pas besoin d'URL plus longues, sauf si vous créez des cartes complexes comportant un grand nombre de repères et de tracés.

Utilisation des paramètres

L'API Maps Static est relativement simple à utiliser, car elle se compose uniquement d'une URL paramétrée. Cette section explique comment utiliser ces paramètres pour créer vos URL.

Spécification des points géographiques

L'API Maps Static doit être en mesure d'identifier avec précision des points géographiques sur la carte, à la fois pour centrer la carte au bon endroit (en utilisant le paramètre center) et/ou pour placer des repères facultatifs (à l'aide du paramètre markers) à certains emplacements de la carte. L'API Maps Static utilise des nombres (valeurs de latitude et de longitude) ou des chaînes (adresses) pour spécifier ces emplacements. Ces valeurs identifient un emplacement geocoding.

Plusieurs paramètres (tels que markers et path) utilisent plusieurs emplacements. Dans ce cas, les emplacements sont séparés par une barre verticale (|).

Latitudes et longitudes

Les latitudes et les longitudes sont définies à l'aide de chiffres dans une chaîne de texte séparée par des virgules, avec une précision de 6 chiffres après la virgule. Par exemple, "40.714728,-73.998672" est une valeur de geocoding valide. La précision au-delà des six décimales est ignorée.

Les valeurs de longitude sont basées sur la distance à partir de Greenwich, en Angleterre, où se situe le premier méridien. Étant donné que Greenwich se situe à une latitude de 51,477222, nous pouvons saisir une valeur center de 51.477222,0 pour centrer la carte sur Greenwich:

Greenwich, Angleterre

Les valeurs de latitude et de longitude doivent correspondre à un point géographique valide sur la surface de la Terre. Les latitudes peuvent prendre n'importe quelle valeur comprise entre -90 et 90, et les valeurs de longitude peuvent être comprises entre -180 et 180. Si vous spécifiez une valeur de latitude ou de longitude non valide, votre requête sera rejetée en tant que requête incorrecte.

Adresses

La plupart des gens ne parlent pas de latitude et de longitude. Ils indiquent des lieux à l'aide d'adresses. Le processus de transformation d'une adresse en point géographique est appelé geocoding. Le service d'API Maps Static peut effectuer un geocoding pour vous à condition que vous fournissiez des adresses valides.

Dans tout paramètre où vous pouvez indiquer une latitude/longitude, vous pouvez spécifier une chaîne indiquant une adresse. Google géocode l'adresse et fournit au service d'API Maps Static une valeur de latitude/longitude à utiliser pour placer des repères ou spécifier des lieux. La chaîne doit être encodée en URL. Ainsi, les adresses telles que "City Hall, New York, NY" doivent être converties en "City+Hall,New+York,NY", par exemple.

Notez que les adresses peuvent refléter des lieux précis, tels que des adresses postales, des polylignes telles que des itinéraires nommés, ou des zones polygonales telles que des villes, des pays ou des parcs nationaux. Pour les résultats polylinéaires et polygonaux, le serveur d'API Maps Static utilise le point central de la ligne ou de la zone comme centre d'adresse. Si vous ne savez pas comment une adresse peut être géocodée, vous pouvez la tester à l'aide de l' utilitaire Geocoding.

L'exemple suivant génère une image de carte statique pour Berkeley, Californie:

https://maps.googleapis.com/maps/api/staticmap?center=Berkeley,CA&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Berkeley (Californie)

Niveaux de zoom

Sur Google Maps, les cartes ont un "niveau de zoom" entier qui définit la résolution de la vue actuelle. Les niveaux de zoom entre 0 (le niveau de zoom le plus faible, dans lequel le monde entier peut être vu sur une seule carte) et 21+ (jusqu'aux rues et aux bâtiments) sont possibles dans la vue roadmap par défaut. Le cas échéant, les contours des bâtiments s'affichent sur la carte autour du niveau de zoom 17. Cette valeur varie d'une zone à l'autre et peut changer au fil du temps à mesure que les données évoluent.

Google Maps définit le niveau de zoom 0 pour englober la Terre entière. Chaque niveau de zoom successif double la précision des dimensions horizontales et verticales. Pour en savoir plus, consultez la documentation de l'API Google Maps JavaScript.

Remarque : les niveaux de zoom ne sont pas tous disponibles pour tous les points géographiques sur Terre. Les niveaux de zoom varient en fonction du lieu, car les données de certaines parties du globe sont plus précises que d'autres emplacements.

Si vous envoyez une requête de niveau de zoom sans aucune tuile de carte, l'API Maps Static affichera une image vide à la place.

La liste suivante indique le niveau de détail approximatif que vous pouvez vous attendre à voir à chaque niveau de zoom:

  • 1 : Le monde
  • 5 : La masse continentale/Le continent
  • 10 : La ville
  • 15 : Les rues
  • 20 : Les immeubles

Cet exemple demande deux cartes de Manhattan avec la même valeur center, mais aux niveaux de zoom 12 et 14, respectivement:

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Manhattan éloigné  Manhattan rapproché

Tailles d'image

Le paramètre size, combiné à center, définit la zone de couverture d'une carte. Il définit également la taille de sortie de la carte en pixels, lorsqu'elle est multipliée par la valeur scale (qui est 1 par défaut).

Ce tableau indique les valeurs maximales autorisées pour le paramètre size pour chaque valeur scale.

scale=1 scale=2
640x640 640x640 (renvoie 1 280 x 1 280 pixels)

Cet exemple demande une "tranche" de la Terre au niveau de l'équateur au niveau de zoom 1:

https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=400x50&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Équateur

Cet exemple demande une petite carte de 100 x 100 pixels centrée sur la même région. Remarquez le logo Google de plus petite taille :

https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=100x100&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Petite carte de l&#39;équateur

Valeurs d'échelle

Le paramètre size de l'API Maps Static définit la taille d'une carte en pixels. Une carte avec size=200x200 est donc renvoyée au format 200 x 200 pixels. Sur un écran d'ordinateur LCD, qui affiche généralement environ 100 pixels par pouce (ppp), une carte de 200 x 200 mesure environ 5 cm dans chaque dimension.

Cependant, de plus en plus d'appareils mobiles intègrent des écrans haute résolution avec des densités de pixels supérieures à 300 ppp, qui:

  • Réduisez la taille d'une image de 200 x 200 pixels à seulement 1,8 cm pour que les libellés et les icônes soient trop petits pour être lisibles ; ou
  • Mettez à l'échelle (zoom) l'image pour améliorer la lisibilité, ce qui génère une image floue ou pixélisée.
Trop petit Trop floue

Lors du développement pour les appareils mobiles, vous pouvez utiliser le paramètre scale de l'API pour renvoyer des images de carte à plus haute résolution qui résolvent les problèmes ci-dessus. La valeur scale est multipliée par la valeur size pour déterminer la taille de sortie réelle de l'image en pixels, sans modifier la zone de couverture de la carte. La valeur par défaut du champ scale est 1. Les valeurs acceptées sont 1 et 2.

Par exemple, une valeur d'échelle de 2 renvoie la même zone de couverture de carte qu'une requête sans échelle spécifiée, mais avec deux fois plus de pixels dans chaque dimension. Cela inclut les routes et les libellés afin qu'ils soient lisibles sur les écrans haute résolution et de petite taille, ainsi que lorsqu'ils sont mis à l'échelle par le navigateur.

150x150 150x150&échelle=2

Une telle image fonctionnera également dans les navigateurs pour ordinateur, lorsqu'elle sera insérée dans une balise img ou div, dont la hauteur et la largeur seront définies à l'aide d'un code CSS. Le navigateur réduit la taille de l'image à la bonne taille, sans perte de qualité.

Ce tableau présente trois requêtes d'image différentes.

  • La première est une image 100x100, sans valeur d'échelle spécifiée. Elle s'affiche correctement sur l'ordinateur, mais est trop petite pour être lisible sur un appareil mobile.
  • La deuxième requête double la taille de la carte. Sur ordinateur, le CSS l'intègre à l'élément img 100 x 100 spécifié, mais lorsque la taille de l'image est réduite, les routes et les libellés deviennent trop petits. Sur l'appareil mobile, l'image est à la bonne taille, mais là encore, les routes et les libellés sont illisibles.
  • La troisième demande concerne une carte de 100 x 100 avec scale=2. L'image est renvoyée avec 200 px de détail ; l'ordinateur de bureau la redimensionne parfaitement pour qu'elle soit impossible à distinguer de la requête d'origine au format 100 x 100, tandis que le navigateur mobile bénéficie de la résolution supplémentaire renvoyée par l'API.
Demandes d'images
Appareil 100x100 200x200 100x100&scale=2
Ordinateur
(avec height="100px" et
width="100px" sur la balise
img)
Haute résolution
(simulée)

Pour en savoir plus sur le développement pour les écrans mobiles et haute résolution, nous vous recommandons de consulter les ressources suivantes:

Formats illustrés

Les images peuvent être renvoyées dans plusieurs formats graphiques Web courants: GIF, JPEG et PNG. Le paramètre format peut avoir l'une des valeurs suivantes:

  • png8 ou png (par défaut) spécifie le format PNG 8 bits.
  • png32 spécifie le format PNG 32 bits.
  • gif spécifie le format GIF.
  • jpg spécifie le format de compression JPEG.
  • jpg-baseline spécifie un format de compression JPEG non progressif.

Ces exemples demandent des cartes aux formats gif et png:

  https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=gif&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
  https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=png&&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

jpg et jpg-baseline fournissent généralement la taille d'image la plus petite, mais via une compression "avec perte", ce qui peut dégrader l'image. gif, png8 et png32 fournissent une compression sans perte.

La plupart des images JPEG sont progressives, c'est-à-dire qu'elles chargent une image plus grosse plus tôt et affinent la résolution de l'image à mesure que d'autres données arrivent. Cela permet de charger rapidement les images dans les pages Web et constitue actuellement l'utilisation la plus répandue du format JPEG. Cependant, certaines utilisations de JPEG nécessitent des images non progressives (de référence). Dans ce cas, vous pouvez utiliser le format jpg-baseline, qui est non progressif.

Types de carte

L'API Maps Static permet de créer des cartes dans plusieurs formats, listés ci-dessous:

  • roadmap (par défaut) spécifie une image de feuille de route standard, telle qu'elle s'affiche normalement sur le site Web de Google Maps. Si aucune valeur maptype n'est spécifiée, l'API Maps Static diffuse les tuiles roadmap par défaut.
  • satellite spécifie une image satellite.
  • terrain spécifie une image de carte à relief physique, montrant le relief et la végétation.
  • hybrid spécifie une combinaison de l'image satellite et de l'image de carte routière, montrant une couche transparente des principales rues et des noms de lieux sur l'image satellite.

Vous pouvez voir la différence entre les types de feuille de route et de relief dans cet exemple de code.

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=roadmap&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=terrain&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Carte normale de Manhattan  Carte physique de Manhattan

Les cartes hybrides utilisent des images satellite et des fonctionnalités importantes de feuille de route pour créer une carte combinée. Les exemples suivants illustrent des types de cartes satellite et hybrides:

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=satellite&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=hybrid&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Carte satellite de Manhattan  Carte physique de Manhattan

Cartes stylisées

Personnalisez la présentation de la carte Google standard en appliquant vos propres styles. Consultez le guide des cartes stylisées.

Repères

Le paramètre markers définit un ensemble d'un ou de plusieurs repères (repères sur la carte) à un ensemble de points géographiques. Chaque repère défini dans une même déclaration markers doit présenter le même style visuel. Si vous souhaitez afficher des repères avec des styles différents, vous devez fournir plusieurs paramètres markers avec des informations de style distinctes.

Le paramètre markers accepte un ensemble d'attributions de valeurs (descripteurs de repères) au format suivant:

markers=markerStyles|markerLocation1| markerLocation2|..., etc.

L'ensemble de markerStyles est déclaré au début de la déclaration markers et se compose de zéro, un ou plusieurs descripteurs de style séparés par une barre verticale (|), suivi d'un ensemble d'un ou plusieurs emplacements également séparés par une barre verticale (|).

Étant donné que les informations de style et les informations de localisation sont délimitées par des barres verticales, ces informations doivent apparaître en premier dans tout descripteur de repère. Une fois que le serveur d'API Maps Static trouve un lieu dans le descripteur du repère, tous les autres paramètres du repère sont également considérés comme des emplacements.

Styles de repère

L'ensemble de descripteurs de style de repère est une série d'attributions de valeurs séparées par une barre verticale (|). Ce descripteur de style définit les attributs visuels à utiliser lors de l'affichage des repères dans ce descripteur de repère. Ces descripteurs de style contiennent les attributions clé/valeur suivantes:

  • size: (facultatif) spécifie la taille du repère à partir de l'ensemble {tiny, mid, small}. Si aucun paramètre size n'est défini, le repère s'affiche dans sa taille par défaut (normale).
  • color: (facultatif) spécifie une couleur 24 bits (par exemple, color=0xFFFFCC) ou une couleur prédéfinie à partir de l'ensemble {black, brown, green, purple, yellow, blue, gray, orange, red, white}.

    Notez que les transparences (spécifiées à l'aide de valeurs de couleur hexadécimales 32 bits) ne sont pas prises en charge dans les repères, bien qu'elles le soient pour les tracés.

  • label: (facultatif) spécifie un seul caractère alphanumérique uppercase du jeu {A-Z, 0-9}. (L'exigence de caractères en majuscules est nouvelle dans cette version de l'API.) Notez que les repères de taille par défaut et mid sont les seuls capables d'afficher un paramètre alphanumeric-character. Les repères tiny et small ne peuvent pas afficher de caractères alphanumériques.

Mise à l'échelle du repère

La valeur scale est multipliée par la taille de l'image du repère pour produire la taille de sortie réelle du repère en pixels. La valeur d'échelle par défaut est 1. Les valeurs acceptées sont 1, 2 et 4.

La limite de taille en pixels des images s'applique après l'application de la mise à l'échelle. Par exemple, si la valeur du repère est scale:2, sa taille peut être supérieure à la taille maximale de 4 096 pixels, à condition qu'elle soit réduite à moins de 4 096 pixels après la mise à l'échelle. Utilisez la mise à l'échelle des repères en même temps que la mise à l'échelle de la carte lorsque vous affichez des cartes à plus haute résolution.

Emplacement des repères

Chaque descripteur de repère doit contenir un ensemble d'un ou de plusieurs lieux définissant l'emplacement du repère sur la carte. Ces points géographiques peuvent être spécifiés sous forme de valeurs latitude/longitude ou d'adresses. Ces emplacements sont séparés par une barre verticale (|).

Remarque: Si vous choisissez de spécifier l'emplacement d'un repère à l'aide d'une méthode nécessitant un geocoding (par exemple, des chaînes d'adresse ou des polylignes lisibles), la requête est limitée à 15 repères. Cette limite ne s'applique qu'aux emplacements de repère qui nécessitent un geocoding. Elle ne s'applique pas aux emplacements de repères spécifiés avec des coordonnées de latitude/longitude.

Les paramètres de position définissent l'emplacement du repère sur la carte. Si l'établissement se trouve en dehors de la carte, ce repère n'apparaîtra pas dans l'image construite, à condition que les paramètres center et zoom soient fournis. Toutefois, si ces paramètres ne sont pas fournis, le serveur d'API Maps Static crée automatiquement une image contenant les repères fournis. (voir Positionnement implicite).

Voici un exemple de déclaration de repère. Notez que nous définissons un ensemble de styles et trois emplacements:

https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&size=400x400&
markers=color:blue%7Clabel:S%7C11211%7C11206%7C11222&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Trois codes postaux de Brooklyn

Pour définir des repères avec des styles différents, nous devons fournir plusieurs paramètres markers. Cet ensemble de paramètres markers définit trois repères: un repère bleu "S" à 62,107733 et -145,5419, un petit repère vert à "Delta Junction, AK" et un repère jaune de taille moyenne intitulé "C" à "Tok, AK". Ces repères sont illustrés dans cet exemple:

https://maps.googleapis.com/maps/api/staticmap?center=63.259591,-144.667969&zoom=6&size=400x400
&markers=color:blue%7Clabel:S%7C62.107733,-145.541936&markers=size:tiny%7Ccolor:green%7CDelta+Junction,AK
&markers=size:mid%7Ccolor:0xFFFF00%7Clabel:C%7CTok,AK"&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Trois villes d&#39;Alaska, différents marqueurs

Icônes personnalisées

Plutôt que d'utiliser les icônes de repère de Google, vous êtes libre d'utiliser vos propres icônes personnalisées. Les icônes personnalisées sont spécifiées à l'aide du descripteur icon dans le paramètre markers. Exemple :

markers=icon:URLofIcon|markerLocation

Spécifiez la valeur icon à l'aide d'une URL (qui doit être encodée en URL). Vous pouvez utiliser des URL créées par des services de raccourcissement d'URL tels que https://goo.gl. La plupart des services de raccourcissement d'URL présentent l'avantage d'encoder automatiquement les URL.

Vous pouvez spécifier un point d'ancrage pour l'icône personnalisée. Le point d'ancrage définit la façon dont l'icône est placée par rapport aux emplacements markers spécifiés. Par défaut, le point d'ancrage d'une icône personnalisée se trouve en bas au centre de l'image de l'icône. Vous pouvez spécifier un autre point d'ancrage à l'aide du descripteur anchor conjointement avec votre icon. Définissez anchor en tant que point x,y de l'icône (par exemple, 10,5) ou en tant qu'alignement prédéfini à l'aide de l'une des valeurs suivantes : top, bottom, left, right, center, topleft, topright, bottomleft ou bottomright. Exemple :

markers=anchor:bottomright|icon:URLofIcon|markerLocation1|markerLocation2

Vous pouvez utiliser jusqu'à cinq icônes personnalisées uniques par requête. Cette limitation ne signifie pas que vous êtes limité à seulement cinq emplacements marqués sur la carte. Chaque icône peut être utilisée avec plusieurs lieux markers sur votre carte.

Format des icônes:

  • Les images d'icônes peuvent être au format PNG, JPEG ou GIF, bien que le format PNG soit recommandé.
  • La taille maximale des icônes ne doit pas dépasser 4 096 pixels (64 x 64 pour les images carrées).
Exemples d'icônes personnalisées

L'exemple 1 crée des icônes personnalisées et les positionne à l'aide d'ancrages.

https://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=anchor:32,10%7Cicon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=anchor:topleft%7Cicon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=anchor:topright%7Cicon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY
&signature=YOUR_SIGNATURE

Trois villes australiennes avec des ancres sur différentes icônes personnalisées.

L'exemple 2 crée les mêmes icônes personnalisées que l'exemple 1, mais ne définit pas leur position à l'aide d'ancrages, en se basant sur l'ancre par défaut en bas au centre.

https://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=icon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=icon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=icon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Trois villes australiennes, différentes icônes personnalisées avec positionnement par défaut.

Chemins d'accès de l'API Maps Static

Le paramètre path définit un ensemble d'un ou de plusieurs établissements reliés par un chemin à superposer sur l'image de la carte. Le paramètre path accepte un ensemble d'attributions de valeurs (descripteurs de chemin) au format suivant:

path=pathStyles|pathLocation1|pathLocation2|..., etc.

Notez que les deux points de tracé sont séparés l'un de l'autre à l'aide de la barre verticale (|). Étant donné que les informations de style et les informations de point sont délimitées par la barre verticale, les informations de style doivent apparaître en premier dans tout descripteur de tracé. Lorsque le serveur d'API Maps Static rencontre un emplacement dans le descripteur de chemin, tous les autres paramètres de chemin sont également considérés comme des emplacements.

Styles de chemin

L'ensemble de descripteurs de style de chemin est une série d'attributions de valeurs séparées par une barre verticale (|). Ce descripteur de style définit les attributs visuels à utiliser pour afficher le tracé. Ces descripteurs de style contiennent les attributions de clé/valeur suivantes:

  • weight: (facultatif) spécifie l'épaisseur du tracé en pixels. Si aucun paramètre weight n'est défini, le tracé s'affichera avec son épaisseur par défaut (5 pixels).
  • color: (facultatif) spécifie une couleur sous la forme d'une valeur hexadécimale 24 bits (exemple: color=0xFFFFCC) ou 32 bits (exemple: color=0xFFFFCCFF), ou à partir de la valeur {black, brown, green, purple, yellow, blue, gray, orange, red, white} définie.

    Lorsqu'une valeur hexadécimale 32 bits est spécifiée, les deux derniers caractères spécifient la valeur de transparence alpha 8 bits. Cette valeur varie entre 00 (complètement transparent) et FF (complètement opaque). Notez que les transparences sont prises en charge dans les tracés, mais pas pour les repères.

  • fillcolor: (facultatif) indique que le tracé délimite une zone polygonale et spécifie la couleur de remplissage à utiliser comme superposition dans cette zone. L'ensemble des lieux ci-dessous ne doit pas nécessairement être en boucle "fermée". Le serveur d'API Maps Static ajoutera automatiquement les premier et dernier points. Notez toutefois que tout trait sur l'extérieur de la zone remplie ne sera pas fermé, sauf si vous indiquez spécifiquement le même point de départ et la même fin.
  • geodesic: (facultatif) indique que le tracé demandé doit être interprété comme une ligne géodésique suivant la courbure de la Terre. Si la valeur est "false", le tracé est affiché sous forme de ligne droite dans l'espace à l'écran. Valeur par défaut : "false".

Voici quelques exemples de définitions de chemin:

  • Ligne bleue fine, opacité de 50 % : path=color:0x0000ff80|weight:1
  • Ligne rouge continue: path=color:0xff0000ff|weight:5
  • Ligne blanche continue et épaisse: path=color:0xffffffff|weight:10

Ces styles de tracé sont facultatifs. Si vous souhaitez utiliser des attributs par défaut, vous pouvez ignorer la définition des attributs de tracé. Dans ce cas, le premier "argument" du descripteur de chemin sera constitué du premier point déclaré (position).

Points du tracé

Pour dessiner un tracé, deux points ou plus doivent également être transmis au paramètre path. L'API Maps Static connectera ensuite le trajet le long de ces points, dans l'ordre spécifié. Chaque pathPoint est indiqué dans le pathDescriptor, séparé par une barre verticale (|).

L'exemple suivant définit un tracé bleu avec une opacité par défaut de 50 %, d'Union Square NY à Times Square NY.

Tracé d&#39;Union Square à Times Square

Voici les spécificités du paramètre path:

path=color:0x0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

L'exemple suivant définit le même tracé au lieu de définir une ligne rouge continue avec une opacité de 100 % :

Tracé d&#39;Union Square à Times Square

Les spécificités de ce paramètre path sont les suivantes:

path=color:0xff0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

L'exemple suivant définit une zone polygonale dans Manhattan, et transmet une série d'intersections en tant que points géographiques:

Tracé d&#39;Union Square à Times Square

Les spécificités de ce paramètre path sont les suivantes:

path=color:0x00000000|weight:5|fillcolor:0xFFFF0033|8th+Avenue+%26+34th+St,New+York,NY|\
8th+Avenue+%26+42nd+St,New+York,NY|Park+Ave+%26+42nd+St,New+York,NY,NY|\
Park+Ave+%26+34th+St,New+York,NY,NY

Notez que nous avons défini le tracé lui-même de sorte qu'il soit invisible et la zone polygonale avec une opacité de 15 %.

Polylignes encodées

Au lieu d'une série de lieux, vous pouvez déclarer un tracé en tant que polyligne encodée en utilisant le préfixe enc: dans la déclaration d'emplacement du path.

L'exemple suivant trace le tracé de la route de l'Alaska entre Dawson Creek, Colombie-Britannique, et Delta Junction, Alaska, avec une polyligne encodée:

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=59.900503,-135.478011&zoom=4
&path=weight:3%7Ccolor:orange%7Cenc:_fisIp~u%7CU}%7Ca@pytA_~b@hhCyhS~hResU%7C%7Cx@oig@rwg@amUfbjA}f[roaAynd@%7CvXxiAt{ZwdUfbjAewYrqGchH~vXkqnAria@c_o@inc@k{g@i`]o%7CF}vXaj\h`]ovs@?yi_@rcAgtO%7Cj_AyaJren@nzQrst@zuYh`]v%7CGbldEuzd@%7C%7Cx@spD%7CtrAzwP%7Cd_@yiB~vXmlWhdPez\_{Km_`@~re@ew^rcAeu_@zhyByjPrst@ttGren@aeNhoFemKrvdAuvVidPwbVr~j@or@f_z@ftHr{ZlwBrvdAmtHrmT{rOt{Zz}E%7Cc%7C@o%7CLpn~AgfRpxqBfoVz_iAocAhrVjr@rh~@jzKhjp@``NrfQpcHrb^k%7CDh_z@nwB%7Ckb@a{R%7Cyh@uyZ%7CllByuZpzw@wbd@rh~@%7C%7CFhqs@teTztrAupHhyY}t]huf@e%7CFria@o}GfezAkdW%7C}[ocMt_Neq@ren@e~Ika@pgE%7Ci%7CAfiQ%7C`l@uoJrvdAgq@fppAsjGhg`@%7ChQpg{Ai_V%7C%7Cx@mkHhyYsdP%7CxeA~gF%7C}[mv`@t_NitSfjp@c}Mhg`@sbChyYq}e@rwg@atFff}@ghN~zKybk@fl}A}cPftcAite@tmT__Lha@u~DrfQi}MhkSqyWivIumCria@ciO_tHifm@fl}A{rc@fbjAqvg@rrqAcjCf%7Ci@mqJtb^s%7C@fbjA{wDfs`BmvEfqs@umWt_Nwn^pen@qiBr`xAcvMr{Zidg@dtjDkbM%7Cd_@
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Route de l&#39;Alaska

Comme pour les tracés standards, les tracés de polyligne encodés peuvent également délimiter des zones polygonales si un argument fillcolor est transmis au paramètre path.

L'exemple suivant trace une zone polygonale délimitant Brooklyn (New York) :

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=40.653279,-73.959816&zoom=11
&path=fillcolor:0xAA000033%7Ccolor:0xFFFFFF00%7Cenc:}zswFtikbMjJzZ%7CRdPfZ}DxWvBjWpF~IvJnEvBrMvIvUpGtQpFhOQdKpz@bIx{A%7CPfYlvApz@bl@tcAdTpGpVwQtX}i@%7CGen@lCeAda@bjA%60q@v}@rfAbjA%7CEwBpbAd_@he@hDbu@uIzWcWtZoTdImTdIwu@tDaOXw_@fc@st@~VgQ%7C[uPzNtA%60LlEvHiYyLs^nPhCpG}SzCNwHpz@cEvXg@bWdG%60]lL~MdTmEnCwJ[iJhOae@nCm[%60Aq]qE_pAaNiyBuDurAuB }}Ay%60@%7CEKv_@?%7C[qGji@lAhYyH%60@Xiw@tBerAs@q]jHohAYkSmW?aNoaAbR}LnPqNtMtIbRyRuDef@eT_z@mW_Nm%7CB~j@zC~hAyUyJ_U{Z??cPvg@}s@sHsc@_z@cj@kp@YePoNyYyb@_iAyb@gBw^bOokArcA}GwJuzBre@i\tf@sZnd@oElb@hStW{]vv@??kz@~vAcj@zKa%60Atf@uQj_Aee@pU_UrcA
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Polyligne encodée de Brooklyn avec signature

Fenêtres d'affichage

Les images peuvent spécifier une fenêtre d'affichage en indiquant les emplacements visibles à l'aide du paramètre visible. Le paramètre visible indique au service d'API Maps Static de construire une carte de sorte que les établissements existants restent visibles. (Ce paramètre peut être associé à des repères ou des chemins existants pour définir également une région visible.) Lorsque vous définissez une fenêtre d'affichage de cette manière, vous n'avez pas besoin de spécifier un niveau de zoom exact.

L'exemple suivant demande une carte centrée sur Boston, Massachusetts, contenant à la fois le MIT et Harvard Square à Cambridge, dans le Massachusetts:

https://maps.googleapis.com/maps/api/staticmap?center=Boston,MA
&visible=77+Massachusetts+Ave,Cambridge,MA%7CHarvard+Square,Cambridge,MA&size=512x512&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Carte de Cambridge

Le positionnement implicite de la carte

Normalement, vous devez spécifier les paramètres d'URL center et zoom pour définir l'emplacement et le niveau de zoom de la carte générée. Toutefois, si vous fournissez des paramètres markers, path ou visible, vous pouvez laisser l'API Maps Static déterminer implicitement le centre et le niveau de zoom appropriés, en fonction de l'évaluation de la position de ces éléments.

Si vous fournissez deux éléments ou plus, l'API Maps Static détermine un centre et un niveau de zoom appropriés, ce qui offre des marges généreuses pour les éléments contenus. Cet exemple affiche une carte contenant San Francisco, Oakland et San Jose, Californie:

https://maps.googleapis.com/maps/api/staticmap?size=512x512&maptype=roadmap\
&markers=size:mid%7Ccolor:red%7CSan+Francisco,CA%7COakland,CA%7CSan+Jose,CA&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Feuille de route

Images plus grandes

Si vous avez besoin d'images dont la taille est supérieure à 640 x 640 pixels (ou 1 280 x 1 280 pixels, avec une valeur d'échelle de 2), veuillez contacter l'équipe d'assistance et lui fournir les informations suivantes:

  1. Votre cas d'utilisation et les raisons pour lesquelles vous avez besoin d'images de grande taille
  2. si vous envisagez d'utiliser d'autres API Google Maps Platform (API Maps JavaScript, API Maps Embed, SDK Maps pour Android ou SDK Maps pour iOS) et pourquoi elles ne répondent pas à vos besoins ?
  3. Captures d'écran, simulations ou exemples d'utilisation d'images de grande taille.
  4. Votre utilisation mensuelle estimée pour les images de grande taille.

Nous examinerons votre demande en fonction des informations que vous nous fournirez et déterminerons si votre cas d'utilisation respecte les Conditions d'utilisation de Google Maps Platform.

La taille maximale autorisée est de 2 048 x 2 048 pixels.

Dépannage et assistance

Pour plus d'informations sur l'utilisation de l'API Maps Static, consultez la page d'assistance.

L'API Maps Static peut générer une erreur ou un avertissement en cas de problème. Vous devez vérifier les avertissements, en particulier si vous remarquez qu'il manque un élément sur la carte. Nous vous recommandons également de vérifier les avertissements avant de lancer une nouvelle application. Notez que les avertissements peuvent ne pas apparaître immédiatement, car ils apparaissent dans l'en-tête HTTP. Pour plus d'informations, consultez le guide sur les erreurs et avertissements.