La version 2 de Google Static Maps API remplace la version 1 considérée comme périmée.
Cette API ne nécessite pas de clé API Maps.
Par contre, les clients de Google Maps API Premier doivent signer leur URL en utilisant une nouvelle clé cryptographique, qui leur sera envoyée. Veuillez consulter la documentation consacrée à Google Maps API Premier pour plus d'informations.
Vous n'avez aucune connaissance en JavaScript ? Alors l'API Google Static Maps Version 2 est faite pour vous.
Celle-ci vous permet d'afficher une carte Google Maps, sous la forme d'une image, dans votre page Web. Aucune clé API Google Maps n'est éxigée. Ce type de carte peut être utilisé sur un site web classique ou destiné aux mobiles. Vous pouvez également y intégrer des marqueurs classiques ou personnalisés, des polylines et des polygones.
La carte, construite à l'aide des paramètres (&nom=valeur) contenus dans l'URL, située dans l'attribut src= de la balise <img />, peut-être affichée sous différents formats :
Format type de la balise <img /> :
<img src="http://maps.google.com/maps/api/staticmap?parametres_de_la_carte" title="Carte Google Maps Statique" alt="Carte Google Maps Statique" />
La carte ci-dessus est obtenue à partir de la ligne de code ci-dessous :
<img src="http://maps.google.com/maps/api/staticmap?center=Tours,FR&zoom=13&size=512x350&maptype=roadmap&markers=color:blue|label:S|47.39734,0.687933&markers=color:green|label:G|47.3971,0.693684&markers=color:red|color:red|label:C|47.389576,0.651197&sensor=false" title="Carte réalisée avec Google Static Maps API Version 2" alt="Carte réalisée avec Google Static Maps API Version 2" />
Dans les lignes qui vont suivre nous allons détailler chacun des paramètres nécessaires à la construction d'une carte statique à l'aide de l'API Google Static Maps Version 2.
Si vous souhaitez adapter rapidement votre carte réalisée avec l'ancienne version de l'API Google Static Maps Version 1 veuillez consulter le guide mise à jour.
Attention :
L'utilisation de l'API Google Static Maps est limitée à 1.000 (mille) requêtes images différentes par visiteur et par jour.
Depuis que la restriction est basée sur le nombre de visiteurs, la plupart des développeurs n'ont plus à se soucier d'un éventuel dépassement de leur quota. De plus, notez qu'en général les demandes d'images identiques, ne sont pas comptabilisées en plus de la demande initiale.
Si un utilisateur venait à dépasser la limite fixée, l'image ci-dessous s'afficherait, en lieu et place de votre carte, pour lui indiquer qu'il a dépassé le quota de requêtes autorisé :
Cette limite a été mise en place afin d'éviter les abus et pourra, par la suite, être modifiée sans préavis.
Si, au cours d'un délai de 24 heures, vous dépassez la limite fixée ou abusez du service, l'API Google Static Maps API peut être, en ce qui vous concerne, suspendue temporairement.
Si, malgré tout, vous continuez à dépasser cette limite, votre accès à l'API Google Static Maps API Version 2 pourra être bloqué.
Le nombre de caractères présents dans l'URL d'une carte statique est limité à 2048.
Certains paramètres sont obligatoires , tandis que d'autres sont facultatifs .
Conformément à la norme concernant les requêtes HTTP, tous les paramètres sont séparés en utilisant l'esperluette (&).
Les paramètres possibles sont listés ci-dessous :
Paramètres Emplacement :
Paramètres Carte :
Paramètres Caractéristiques :
Paramètres Capteur :
center : ( obligatoire si aucun marqueur n'est présent sur la carte, sinon facultatif ).
Il fixe le centre de la carte. Il est situé à égale distance de tous les bords de la carte.
<img src="http://maps.google.com/maps/api/staticmap?center=latitude,longitude&zoom=niveau_de_zoom&size=largeur_pixelsxhauteur_pixels&sensor=false" alt="Carte Google Maps Statique" />
Création d'une image représentant une carte Google Maps centrée sur la ville de Tours :
<img src="http://maps.google.com/maps/api/staticmap?center=47.389750,0.689049&zoom=12&size=640x370&sensor=false" alt="Carte Google Maps Statique" />
Attention :
Vous pouvez également indiquer une adresse postale en lieu et place de la latitude / longitude. Google convertit automatiquement l'adresse postale en latitude / longitude pour centrer la carte sur ces coordonnées.
<img src="http://maps.google.com/maps/api/staticmap?center=adresse_postale&zoom=niveau_de_zoom&size=largeur_pixelsxhauteur_pixels&sensor=false" alt="Carte Google Maps Statique" />
La chaîne adresse ne doit comporter que des caratères compatibles avec les URI (voir : URL-escaped). Ainsi une adresse telle que : "rue Bretonneau,37000,Tours,FR" doit être convertie ainsi : "rue+Bretonneau,37000,Tours,FR". L "espace" est remplacé par un signe "+".
Notez que les adresses peuvent indiquer un emplacements précis, comme une adresse postale complète, des polylignes comme le nom d'une route, ou des secteurs polygonaux comme des villes, des pays, ou des parcs nationaux. Pour des résultats polylinéaires et polygonaux, le serveur de Carte Statique utilisera le point central de la ligne/secteur comme le centre de l'adresse. Si vous avez le doute sur la façon dont une adresse peut être géocodée, vous pouvez la tester en utilisant cet Utilitaire de géocodage.
Exemple :
Création d'une image représentant une carte Google Maps centrée sur la rue bretonneau, 37000, Tours, FR :
<img src="http://maps.google.com/maps/api/staticmap?center=rue+bretonneau,37000,Tours,FR&zoom=12&size=640x370&sensor=false" alt="Carte Google Maps Statique" />
zoom : ( obligatoire si aucun marqueur n'est présent sur la carte, sinon facultatif ).
Il fixe le niveau de zoom de la carte. Ce paramètre prend une valeur numérique correspondant au niveau de zoom de la région désirée. Le niveau de zoom le plus bas : 0, permet de visualiser l'ensemble de la Terre. Le niveau de zoom le plus élevé : 21+, permet de visualiser une maison en particulier. Ces niveaux de zoom sont proposés par défaut dans les cartes de type roadmap.
Attention :
Le niveau de zoom maximal n'est pas le même sur toute la surface de la terre. Il peut varier selon les régions. Si vous envoyez une requête avec un niveau de zoom qui n'existe pas pour la région seléctionnée, une image blanche sera retournée par Google. Pensez alors, à modifier le niveau de zoom.
Exemple :
Voici deux cartes statiques centrées sur le même point mais avec deux niveaux de zoom différents : 14 et 16.
<img src="http://maps.google.com/maps/api/staticmap?center=47.389750,0.689049&zoom=14&size=362x370&sensor=false" alt="Carte Google Maps Statique" /> <img src="http://maps.google.com/maps/api/staticmap?center=47.389750,0.689049&zoom=16&size=362x370&sensor=false" alt="Carte Google Maps Statique" />
size : ( obligatoire ) définit les dimensions de la carte : nombre de pixels horizontauxxnombre de pixels verticaux. Par exemple, 640x400 définit une carte dont la largeur fait 640 pixels et la hauteur 400 pixels.
Si vous créez une carte statique dont la largeur est inférieure ou égale à 100 pixels, la taille du logo "Powered by Google" sera automatiquement redimensionnée.
Attention :
La taille maximale d'une image générée via l'API Google Static Map version 2 est de 640 x 640 pixels.
<img src="http://maps.google.com/maps/api/staticmap?center=47.389750,0.689049&zoom=12&size=640x370&sensor=false" alt="Carte Google Maps Statique" />
format : ( facultatif ) définit le format de l'image. Par défaut, l'image créée est au format GIF. Cinq types de format sont possibles :
Du format sélectionné, va dépendre la qualité/précision de l'image de la carte affichée.
La plupart des images JPEG sont progressives. Cela signife que dès le départ une image grossière est chargée, puis celle-ci va voir sa résolution augmenter au fur et à mesure que les données sont chargées. Ceci permet un chargement rapide des images dans les pages Web. JPEG est actuellement le format la plus utilisé. Cependant, certaines utilisations, comme par exemple l'impression, exigent des images non progressives . Dans ce cas, vous pouvez utiliser le format jpg-baseline qui est non-progressif, à la place du format JPEG.
<img src="http://maps.google.com/maps/api/staticmap?center=47.389750,0.689049&zoom=12&size=640x370&format=jpg&sensor=false" alt="Carte Google Maps Statique" />
<img src="http://maps.google.com/maps/api/staticmap?center=47.389750,0.689049&zoom=12&size=640x370&format=gif&sensor=false" alt="Carte Google Maps Statique" />
<img src="http://maps.google.com/maps/api/staticmap?center=47.389750,0.689049&zoom=12&size=640x370&format=png32&sensor=false" alt="Carte Google Maps Statique" />
maptype : ( facultatif ) définit le type de carte à construire.
Quatre types de cartes sont possibles pour maptype :
<img src="http://maps.google.com/maps/api/staticmap?center=latitude,longitude&zoom=niveau_de_zoom&size=largeur_pixelsxhauteur_pixels&maptype=roadmap&sensor=false" alt="Carte Google Maps Statique" />
<img src="http://maps.google.com/maps/api/staticmap?center=47.389750,0.689049&zoom=12&size=640x370&maptype=roadmap&sensor=false" alt="Carte Google Maps Statique roadmap" />
<img src="http://maps.google.com/maps/api/staticmap?center=47.389750,0.689049&zoom=12&size=640x370&maptype=satellite&sensor=false" alt="Carte Google Maps Statique satellite" />
<img src="http://maps.google.com/maps/api/staticmap?center=47.389750,0.689049&zoom=12&size=640x370&maptype=terrain&sensor=false" alt="Carte Google Maps Statique terrain" />
<img src="http://maps.google.com/maps/api/staticmap?center=47.389750,0.689049&zoom=12&size=640x370&maptype=hybrid&sensor=false" alt="Carte Google Maps Statique hybrid" />
mobile : ( obligatoire ) indique si la carte sera affichée sur un mobile.
Il prend la valeur false ou true.
L'emploi de mobile=true permet d'afficher des cartes dont la définition est optimisée pour les écrans des téléphones portables.
Exemple :
<img src="http://maps.google.com/maps/api/staticmap?center=47.389750,0.689049&zoom=12&size=640x370&mobile=true&sensor=false" alt="Carte Google Maps Statique" />
language : ( facultatif ) définit la langue à utiliser pour l'affichage des étiquettes sur les tuiles de la carte.
Notez :
Ce paramètre est pris en charge uniquement pour les tuiles de certains pays. Si le langage language demandé, est inconnu du jeu de tuiles spécifié, c'est la langue utilisée par défaut pour ces tuiles qui sera appliquée.
La carte ci-dessous, affiche le nom des villes en Russe et en Français - language=ru :
<img src="http://maps.google.com/maps/api/staticmap?center=47.389750,0.689049&zoom=12&size=640x300&sensor=false&language=ru" alt="Carte dont le nom des villes est affiché en Russe et en Français" />
sensor : ( obligatoire ) indique si votre application utilise ou non un GPS afin de déterminer l'emplacement de l'utilisateur (exemple : mobile doté d'un GPS).
Il prend la valeur false ou true.
Si la requête est destinée à déterminer l'emplacement du visiteur doté d'un téléphone portable avec GPS intégré, alors vous devez utiliser : sensor=true.
Exemple :
<img src="http://maps.google.com/maps/api/staticmap?center=47.389750,0.689049&zoom=12&size=640x370&sensor=true" alt="Carte Google Maps Statique" />
Dans le cas contraire, vous devez utiliser : sensor=false.
Exemple :
<img src="http://maps.google.com/maps/api/staticmap?center=47.389750,0.689049&zoom=12&size=640x370&sensor=false" alt="Carte Google Maps Statique" />
markers : ( facultatif ) défini un ou plusieurs marqueurs à afficher sur la carte, associés à un ou plusieurs styles de marqueurs.
Le paramètre markers doit respecter la régle d'écriture suivante :
markers=style_marqueurs|emplacement_marqueur_1|emplacement_marqueur_2|emplacement_marqueur_3| ... etc.
Les informations de style et les informations d'emplacement étant toutes deux délimitées à l'aide du caractère pipe '|", les informations de style doivent apparaître en premiers dans n'importe quel descripteur de marqueur. Une fois que le serveur de Carte Statique rencontre un emplacement dans le descripteur de marqueur, tous les autres paramètres de marqueur sont considérés comme étant également des emplacements.
Si plusieurs marqueurs doivent être affichés, les chaînes de caractères définissant chaque marqueur seront séparées par le caractère pipe | ( ou %7C en ASCII si vous encodez vos URL).
<img src="http://maps.google.com/maps/api/staticmap?size=largeur_pixelsxhauteur_pixels&markers=style_marqueurs|emplacement_marqueur_1|emplacement_marqueur_2|emplacement_marqueur_3|&sensor=false" alt="Carte Google Maps Statique comportant 3 marqueurs" title="Carte Google Maps Statique comportant 3 marqueurs" />
Le style d'un marqueur, est défini à l'aide d'une série de valeurs séparées par le caractère pipe "|" :
Chaque descripteur de marqueur doit contenir un jeu d'un ou plusieurs emplacements situant chaque marqueur sur la carte. Ces emplacements peuvent être spécifiés sous forme de coordonées GPS latitude,longitude ou d'adresses postales. Les emplacements sont séparés les uns des autres en utilisant le caractère de pipe " | ".
Les paramètres d'emplacement définissent l'emplacement du marqueur sur la carte.
Si l'emplacement du marqueur est situé en dehos de la carte, ce marqueur n'apparaîtra
pas si l'image est construite en fournissant les paramètres center
et zoom. Par contre, si ces paramètres ne sont pas fournis, le
serveur de carte statique construira automatiquement une image qui contiendra
les marqueurs fournis. (Voir le Positionnement Implicite ci-dessous.)
Plutôt que d'utiliser les icônes de marqueurs proposées par Google, vous pouvez
utiliser vos propres icônes personnalisées. Les icônes personnalisées sont spécifiées
en utilisant les descripteurs suivants dans le paramètre markers
:
icon spécifie l'URL de l'icône personnalisée à utiliser pour
le marqueur. Les images peuvent être dans le format PNG, JPEG ou GIF. Le fomat
PNG est recommandé.shadow (true par défaut) indique que le service
de Cartes Statique devra construire une ombre appropriée pour l'image. Cette
ombre est basée sur la région visible de l'image et son opacité/transparence.Le paramètre icon doit être spécifié à l'aide d'une URL (qui doit
être encodée : URL_encoded).
Vous pouvez utiliser n'importe quelle URL valable de votre choix, ou un service
générant des alias courts d'URL comme http://bit.ly
ou http://tinyurl.com.
La plupart des services générant des alias courts d'URL ont l'avantage d'encoder
'automatiquement les URL. La taille des icônes est limitée à 4096 pixels (64x64
pour des images carrées) et le service de Cartes Statique autorise jusqu'à cinq
icônes personnalisées uniques par requête. Notez que chacune de ces icônes unique,
peut être utilisée plusieurs fois dans la carte statique.
Les icônes personnalisées qui ont un descripteur shadow:true
(par défaut) auront leur "le point d'ancre" le jeu comme le centre
du bas de l'image d'icône fournie, dont l'ombre est jetée. Par contre, les icônes
sans ombre (descripteur shadow:false)
sont considérés comme étant des icônes centrées sur leurs emplacements indiqués,
donc leurs points d'ancrage est localisé au centre de l'image.
L'exemple suivant utilise Map Icons Collection pour créer des marqueurs personnalisés, montrant plusieurs châteaux situés en Touraine :
<img src="http://maps.google.com/maps/api/staticmap?size=480x480&markers=icon:http://www.touraineverte.com/map-icons-collection-2.0/icons/castle.png|Rue+de+la+Concorde,37403,Amboise,FR|rue+du+chateau,37500,Chinon,FR|rue+lavoisier,37000,tours,FR&sensor=false" alt="Carte Google Maps statique avec marqueur personnalisé" />
Notez :
Si vous utilisez Google Chart API, celui-ci, comme l'API de Cartes Statique Google, utilise le caractère pipe " | " pour délimiter des paramètres dans ses URL. N'importe quelles URL d'icône contenant un tel caractère causeront que le service de Carte Statique interprète le caractère de pipe comme un délimiteur de paramètre avant l'évaluation de l'URL. Si vous voulez utiliser une URL contenant un caractère pipe, vous pouvez "doubler - codent" la pipe à %257C, qui décode à %7C et assurera que n'importe quelle pipe que vous placez dans l'URL de l'icône n'est pas interprétée par le service de Carte Statique. (Nous avons utilisé ce tour ci-dessus.)
L'exemple ci-dessous montre comment une telle URL s'occupera du codage double le caractère(personnage) de pipe :
# URL originale :
http://chart.apis.google.com/chart?chst=d_map_pin_icon&chld=cafe|996600
# URL encodée :
http://chart.apis.google.com/chart%3Fchst%3Dd_map_pin_icon%26chld%3Dcafe%7C996600
# Double encodage pour le caractère "|" :
http://chart.apis.google.com/chart%3Fchst%3Dd_map_pin_icon%26chld%3Dcafe%257C996600
La taille, la couleur et le caractère alphabétique définissent l'aspect visuel du marqueur. Si aucune taille n'est indiquée, le marqueur s'affiche, par défaut, en taille "normal".
Si aucune valeur n'est indiquée, le marqueur rouge par défaut s'affiche :
| Intitulé | Valeur |
|---|---|
| Couleur : | blue (bleu) |
| Caratère alphanumérique : | A |
| Code Final : markers=color:blue|label:A | |
| Intitulé | Valeur |
|---|---|
| Latitude : | 47.389750 |
| Longitude : | 0.689049 |
| Code Final : 47.389750,0.689049 | |
| Intitulé | Valeur |
|---|---|
| Latitude : | 47.389401 |
| Longitude : | 0.720463 |
| Code Final : 47.389401,0.720463 | |
| Intitulé | Valeur |
|---|---|
| Adresse : | rue Bretonneau, 37000, Tours, FR |
| Code Final : rue Bretonneau, 37000, Tours, FR | |
Il ne reste plus qu'à lier le style et nos trois marqueurs avec le caractère |
markers=color:blue|label:A|47.389750,0.689049|47.389401,0.720463|rue+Bretonneau,37000,Tours,FR
et à insérer l'ensemble dans la balise <img />
<img src="http://maps.google.com/maps/api/staticmap?size=640x370&markers=color:blue|label:A|47.389750,0.689049|47.389401,0.720463|rue+Bretonneau,37000,Tours,FR&sensor=false" alt="Carte Google Maps Statique comportant 3 marqueurs" title="Carte Google Maps Statique comportant 3 marqueurs" />
| Intitulé | Valeur |
|---|---|
| Latitude : | 47.389750 |
| Longitude : | 0.689049 |
| Couleur : | blue (bleu) |
| Caratère alphanumérique : | S |
| Code Final : markers=color:blue|label:S|47.389750,0.689049 | |
| Intitulé | Valeur |
|---|---|
| Latitude : | 47.389401 |
| Longitude : | 0.720463 |
| Taille : | tiny (minuscule) |
| Couleur : | green (vert) |
| Code Final : markers=color:green|size:tiny|47.389401,0.720463 | |
| Intitulé | Valeur |
|---|---|
| Adresse : | rue Bretonneau, 37000, Tours, FR |
| Taille : | mid (moyen) |
| Couleur : | orange (orange) |
| Caratère alphanumérique : | 8 |
| Code Final : markers=color:orange|size:mid|label:8|rue+Bretonneau,37000,Tours,FR | |
Il ne reste plus qu'à lier nos trois marqueurs avec le caractère &
markers=color:blue|label:S|47.389750,0.689049&markers=color:green|size:tiny|47.389401,0.720463&markers=color:orange|size:mid|label:8|rue+Bretonneau,37000,Tours,FR
et à insérer l'ensemble dans la balise <img>
<img src="http://maps.google.com/maps/api/staticmap?size=640x370&markers=color:blue|label:S|47.389750,0.689049&markers=color:green|size:tiny|47.389401,0.720463&markers=color:orange|size:mid|label:8|rue+Bretonneau,37000,Tours,FR" alt="Carte Google Maps Statique comportant 3 marqueurs" title="Carte Google Maps Statique comportant 3 marqueurs" />
Attention :
si vous affichez des marqueurs sur votre carte, vous n'aurez pas besoin de préciser les paramètres suivants, normalement obligatoires :
Ils seront définis implicitement par Google Maps Static, en s'appuyant sur la position des marqueurs à afficher.
path : ( facultatif ) définit un tracé unique constitué de deux ou plusieurs points, chaque point étant relié au suivant à l'aide d'une ligne droite, l'ensemble venant se superposer à la carte. Ce paramètre prend une série de points séparés par le caractère pipe " | ". Le tracé est dessiné en tenant compte de l'ordre des points séparés par les pipes " | ".
<img src="http://maps.google.com/maps/api/staticmap?size=640x370&path=color:0xff0000|weight:5|47.407181,0.681496|47.409504,0.677204|47.410782,0.672913|47.410896,0.666904|47.409386,0.661068|47.407528,0.658321|47.404507,0.656261|47.401485,0.655746|47.396374,0.655231|47.391842,0.656776|47.388241,0.660381|47.386379,0.666218|47.385334,0.672054|47.383705,0.676346|47.381729,0.679092|47.380104,0.680466|47.377197,0.682526|47.378593,0.683899|47.379986,0.684929|47.382545,0.687847|47.385448,0.693169|47.388821,0.700893|47.392654,0.704842|47.396488,0.707245|47.401253,0.707245|47.406250,0.705528|47.409969,0.699005|47.411476,0.691452|47.410664,0.686817|47.407413,0.681324&sensor=false" alt="Dessine moi un coeur sur Tours" title="Dessine moi un coeur sur Tours" />
Si on ne souhaite pas afficher le contour du polygone il suffit d'utiliser : color:0x00000000 - noir totalement transparent
<img src="http://maps.google.com/maps/api/staticmap?size=640x370&path=color:0x00000000|weight:5|fillcolor:0xFF000055|47.407181,0.681496|47.409504,0.677204|47.410782,0.672913|47.410896,0.666904|47.409386,0.661068|47.407528,0.658321|47.404507,0.656261|47.401485,0.655746|47.396374,0.655231|47.391842,0.656776|47.388241,0.660381|47.386379,0.666218|47.385334,0.672054|47.383705,0.676346|47.381729,0.679092|47.380104,0.680466|47.377197,0.682526|47.378593,0.683899|47.379986,0.684929|47.382545,0.687847|47.385448,0.693169|47.388821,0.700893|47.392654,0.704842|47.396488,0.707245|47.401253,0.707245|47.406250,0.705528|47.409969,0.699005|47.411476,0.691452|47.410664,0.686817&sensor=false" alt="Carte Google Maps Statique - un coeur sur Tours" title="Carte Google Maps Statique - un coeur sur Tours" />
Si on souhaite afficher le contour du polygone il suffit d'utiliser : color:0x0000FFFF - bleu totalement opaque
<img src="http://maps.google.com/maps/api/staticmap?size=640x370&path=color:0x0000FFFF|weight:5|fillcolor:0xFF000055|47.407181,0.681496|47.409504,0.677204|47.410782,0.672913|47.410896,0.666904|47.409386,0.661068|47.407528,0.658321|47.404507,0.656261|47.401485,0.655746|47.396374,0.655231|47.391842,0.656776|47.388241,0.660381|47.386379,0.666218|47.385334,0.672054|47.383705,0.676346|47.381729,0.679092|47.380104,0.680466|47.377197,0.682526|47.378593,0.683899|47.379986,0.684929|47.382545,0.687847|47.385448,0.693169|47.388821,0.700893|47.392654,0.704842|47.396488,0.707245|47.401253,0.707245|47.406250,0.705528|47.409969,0.699005|47.411476,0.691452|47.410664,0.686817|47.407181,0.681496&sensor=false" alt="Carte Google Maps Statique - un coeur sur Tours" title="Carte Google Maps Statique - un coeur sur Tours" />
Au lieu d'indiquer une série de points, vous pouvez déclarer le tracé en utilisant une polyligne encodée à l'aide du préfixe enc: dans la déclaration du path.
Notez que si vous fournissez un tracé sous la forme d'une polyligne encodée, vous n'avez pas besoin de spécifier les paramètres center et zoom, normalement obligatoires dans l'URL.
<img src="http://maps.google.com/maps/api/staticmap?size=640x370&path=weight:4|color:red|enc:_fisIp~u|U}|a@pytA_~b@hhCyhS~hResU||x@oig@rwg@amUfbjA}f[roaAynd@|vXxiAt{ZwdUfbjAewYrqGchH~vXkqnAria@c_o@inc@k{g@i`]o|F}vXaj\h`]ovs@?yi_@rcAgtO|j_AyaJren@nzQrst@zuYh`]v|GbldEuzd@||x@spD|trAzwP|d_@yiB~vXmlWhdPez\_{Km_`@~re@ew^rcAeu_@zhyByjPrst@ttGren@aeNhoFemKrvdAuvVidPwbVr~j@or@f_z@ftHr{ZlwBrvdAmtHrmT{rOt{Zz}E|c|@o|Lpn~AgfRpxqBfoVz_iAocAhrVjr@rh~@jzKhjp@``NrfQpcHrb^k|Dh_z@nwB|kb@a{R|yh@uyZ|llByuZpzw@wbd@rh~@||Fhqs@teTztrAupHhyY}t]huf@e|Fria@o}GfezAkdW|}[ocMt_Neq@ren@e~Ika@pgE|i|AfiQ|`l@uoJrvdAgq@fppAsjGhg`@|hQpg{Ai_V||x@mkHhyYsdP|xeA~gF|}[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|i@mqJtb^s|@fbjA{wDfs`BmvEfqs@umWt_Nwn^pen@qiBr`xAcvMr{Zidg@dtjDkbM|d_@&sensor=false" alt="Carte Google Maps Statique - Polyline encodée" />
Vous pouvez également encoder des polygones et les insérer dans une carte Google Statique à l'aide de l'argument fillcolor: et du préfixe enc:
L'exemple ci-dessous affiche un polygone correpondant à la zone de Brooklyn, NY :
<img src="http://maps.google.com/maps/api/staticmap?size=640x370&path=fillcolor:0xFF000066|color:0xFFFFFF00|enc:}zswFtikbMjJzZ|RdPfZ}DxWvBjWpF~IvJnEvBrMvIvUpGtQpFhOQdKpz@bIx{A|PfYlvApz@bl@tcAdTpGpVwQtX}i@|Gen@lCeAda@bjA%60q@v}@rfAbjA|EwBpbAd_@he@hDbu@uIzWcWtZoTdImTdIwu@tDaOXw_@fc@st@~VgQ|[uPzNtA%60LlEvHiYyLs^nPhCpG}SzCNwHpz@cEvXg@bWdG%60]lL~MdTmEnCwJ[iJhOae@nCm[%60Aq]qE_pAaNiyBuDurAuB}}Ay%60@|EKv_@?|[qGji@lAhYyH%60@Xiw@tBerAs@q]jHohAYkSmW?aNoaAbR}LnPqNtMtIbRyRuDef@eT_z@mW_Nm|B~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&sensor=false" alt="Carte Google Maps Statique - Polygone encodé" />
Une zone particulière à visualiser peut être spécifiée à l'aide du paramètre visible.
Le paramètre visible charge Google Static Map de construire une carte de façon à ce que les emplacements existants soient visibles (ce paramètre peut être combiné avec des marqueurs existants ou un tracé afin de définir la zone qui doit être visible.)
Définir la zone particulière à visualiser de cette façon, permet d'éviter la nécessité de préciser le niveau de zoom exact.
L'exemple ci-dessous demande une carte centrée sur Tours, FR contenant à la fois le 10 rue bretonneau 37000 Tours FR et le square Francis Poulenc 37000 Tours FR :
<img src="http://maps.google.com/maps/api/staticmap?center=Tours,FR&visible=10+rue+Bretonneau,37000,Tours,FR|square+francis+poulenc,37000,Tours,FR&size=640x370&sensor=false" alt="Carte Google Maps Statique - Polygone encodé" />
Normalement, vous devez spécifier les paramètres d'URL center
et zoom afin de définir l'emplacement et le niveau de zoom de votre
carte.
Toutefois, si vous fournissez des marqueurs, un tracé, ou le paramètre visible, vous pouvez laisser l'API Google Static Maps déterminer le centre et le niveau de zoom implicitement, en se fondant sur l'évaluation de la position de ces éléments.
Si vous fournissez au moins deux éléments, l'API Google Static Maps déterminera automatiquement le centre et le niveau de zoom de la carte, tout en offrant des marges généreuses aux éléments contenus.
L'exemple ci-dessous affiche une carte contenant Tours, Nantes et Niort :
<img src="http://maps.google.com/maps/api/staticmap?size=512x512&maptype=roadmap&markers=size:mid|color:red|Tours,FR|Nantes,FR|Niort,FR&mobile=true&sensor=false" alt="Carte Google Maps Statique - Polygone encodé" />
Ceci est une traduction non officielle de "Google Static Maps API V2 API Developer's Guide".
La version originale, en Anglais, se situe ici : Google Static Maps API V2 API Developer's Guide.
| © 2010 | Google Static Maps API Version 2 en Français |