Introduction
Avec les URL Maps, vous pouvez créer une URL universelle multiplate-forme pour lancer Google Maps, effectuer des recherches, obtenir un itinéraire et des itinéraires, et afficher des plans et des images panoramiques. La syntaxe de l'URL est identique quelle que soit la plate-forme utilisée.
Vous n'avez pas besoin d'une clé API Google pour utiliser les URL Maps.
Syntaxe universelle multiplate-forme
En tant que développeur d'une application Android, iOS ou d'un site Web, vous pouvez créer une URL commune qui permet d'ouvrir Google Maps et d'effectuer l'action demandée, quelle que soit la plate-forme utilisée lors de l'ouverture de la carte.
- Sur un appareil Android :
- Si l'application Google Maps pour Android est installée et active, l'URL lance Google Maps dans l'application Maps et effectue l'action demandée.
- Si l'application Google Maps n'est pas installée ou est désactivée, l'URL lance Google Maps dans un navigateur et effectue l'action demandée.
- Sur un appareil iOS :
- Si l'application Google Maps pour iOS est installée, l'URL lance Google Maps dans l'application Maps et effectue l'action demandée.
- Si l'application Google Maps n'est pas installée, l'URL lance Google Maps dans un navigateur et effectue l'action demandée.
- Sur tout autre appareil, l'URL lance Google Maps dans un navigateur et effectue l'action demandée.
Nous vous recommandons d'utiliser une URL multiplate-forme pour lancer Google Maps à partir de votre application ou de votre site Web, car ces URL universelles permettent une gestion plus large des requêtes Maps, quelle que soit la plate-forme utilisée. Pour les fonctionnalités qui ne fonctionnent peut-être que sur une plate-forme mobile (par exemple, la navigation détaillée), vous préférerez peut-être utiliser une option spécifique à la plate-forme pour Android ou iOS. Consultez la documentation suivante:
- Intents Google Maps pour Android, en particulier pour lancer l'application Google Maps pour Android
- Google Maps URL Scheme pour iOS, en particulier pour lancer l'application Google Maps pour iOS
Lancer Google Maps et effectuer une action spécifique
Pour lancer Google Maps et exécuter éventuellement l'une des fonctions compatibles, utilisez un schéma d'URL de l'un des formats suivants, en fonction de l'action demandée:
- Recherche : lancez une carte Google Maps qui affiche un repère pour un lieu spécifique, ou effectuez une recherche générale et lancez une carte pour afficher les résultats :
https://www.google.com/maps/search/?api=1¶meters
- Itinéraire : demandez un itinéraire et lancez Google Maps avec les résultats suivants :
https://www.google.com/maps/dir/?api=1¶meters
- Afficher une carte : lancez Google Maps sans repères ni itinéraire :
https://www.google.com/maps/@?api=1&map_action=map¶meters
- Afficher un panorama Street View : lancez une image panoramique interactive :
https://www.google.com/maps/@?api=1&map_action=pano¶meters
Important: Le paramètre api=1
identifie la version des URL Maps à laquelle cette URL est destinée. Ce paramètre est obligatoire dans chaque requête. La seule valeur valide est 1. Si api=1
N'EST PAS dans l'URL, tous les paramètres sont ignorés et l'application Google Maps par défaut se lance dans un navigateur ou dans l'application mobile Google Maps, en fonction de la plate-forme utilisée (par exemple, https://www.google.com/maps).
Créer des URL valides
Vous devez encoder correctement les URL.
Par exemple, certains paramètres utilisent une barre verticale (|
) comme séparateur, que vous devez encoder en tant que %7C
dans l'URL finale. D'autres paramètres utilisent des valeurs séparées par une virgule, telles que des coordonnées de latitude/longitude ou une ville ou un État. Vous devez encoder la virgule en %2C
. Encodez des espaces avec %20
ou remplacez-les par un signe plus (+
).
De plus, les URL sont limitées à 2 048 caractères par demande. Tenez compte de cette limite lorsque vous créez vos URL.
Actions sur la carte
Les actions disponibles sur la carte sont la recherche, l'itinéraire, l'affichage de la carte et l'affichage d'un panorama Street View. Vous spécifiez l'action dans l'URL de la requête, ainsi que les paramètres obligatoires et facultatifs. Comme pour toutes les URL, vous devez séparer les paramètres à l'aide du caractère esperluette (&
). Pour chaque action, la liste des paramètres et leurs valeurs possibles sont énumérées dans la section Paramètres de recherche.
Rechercher
L'action de recherche affiche les résultats d'une recherche dans la région visible sur la carte. Lorsque vous recherchez un lieu spécifique, la carte obtenue place un repère à l'emplacement spécifié et affiche les détails disponibles.
Création de l'URL de recherche
https://www.google.com/maps/search/?api=1¶meters
Paramètres
query
(obligatoire): définit le ou les lieux à mettre en évidence sur la carte. Le paramètre de requête est obligatoire pour toutes les requêtes de recherche.- Spécifiez les lieux sous forme de nom de lieu, d'adresse ou de coordonnées de latitude/longitude séparées par une virgule. Les chaînes doivent être encodées au format URL. Par conséquent, une adresse telle que "hôtel de ville, New York, NY" doit être convertie en
City+Hall%2C+New+York%2C+NY
. - Spécifiez des termes de recherche généraux sous la forme d'une chaîne encodée au format URL, telle que
grocery+stores
ourestaurants+in+seattle+wa
.
- Spécifiez les lieux sous forme de nom de lieu, d'adresse ou de coordonnées de latitude/longitude séparées par une virgule. Les chaînes doivent être encodées au format URL. Par conséquent, une adresse telle que "hôtel de ville, New York, NY" doit être convertie en
query_place_id
(facultatif) : un identifiant de lieu est un identifiant textuel qui identifie un lieu de manière unique. Pour l'actionsearch
, vous devez spécifier unquery
, mais vous pouvez également spécifier unquery_place_id
. Si vous spécifiez les deux paramètres,query
n'est utilisé que si Google Maps ne trouve pas l'ID de lieu. Si vous essayez d'associer définitivement un établissement spécifique, l'ID de lieu constitue la meilleure garantie d'association au bon endroit. Il est également recommandé d'envoyer unquery_place_id
lorsque vous interrogez un lieu spécifique à l'aide de coordonnées de latitude/longitude.
Exemples de recherches
Recherche de lieu
Vous pouvez rechercher un lieu spécifique à l'aide d'un nom de lieu, d'une adresse ou de coordonnées de latitude/longitude séparées par une virgule. La carte obtenue affiche alors un repère à cet emplacement. Ces trois exemples illustrent des recherches sur le même lieu, le CenturyLink Field (stade de Seattle, dans l'État de Washington), à l'aide de valeurs de localisation différentes.
Exemple 1: La recherche du nom de lieu "CenturyLink Field" s'affiche dans la carte suivante:
https://www.google.com/maps/search/?api=1&query=centurylink+field
Exemple 2: Rechercher un champ CenturyLink à l'aide des coordonnées de latitude/longitude, ainsi que l'identifiant de lieu, dans la carte suivante:
Exemple 3: La recherche de champ CenturyLink en utilisant uniquement les coordonnées de latitude/longitude dans la carte suivante Notez qu'un repère est affiché sur la carte, mais qu'aucune autre information sur le lieu n'est fournie sur la carte ni dans le panneau latéral:
https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393
Recherche par catégorie
Dans ce cas, vous spécifiez un terme de recherche général, et Google Maps tente de trouver des fiches correspondant à vos critères à proximité du lieu spécifié.
Si aucune position n'est spécifiée, Google Maps tente de trouver des fiches à proximité de votre position actuelle. Si vous préférez fournir un lieu pour une recherche catégorielle, incluez-le dans la chaîne de recherche générale (par exemple, pizza+seattle+wa
).
Dans cet exemple, une recherche de pizzerias à Seattle (Washington) renvoie la carte suivante:
https://www.google.com/maps/search/?api=1&query=pizza+seattle+wa
Directions
L'action Directions affiche le trajet entre plusieurs points spécifiés sur la carte, ainsi que la distance et la durée du trajet.
Création de l'URL d'itinéraire
https://www.google.com/maps/dir/?api=1¶meters
Paramètres
origin
: définit le point de départ de l'itinéraire. Par défaut, la position de départ la plus pertinente (par exemple, la position de l'appareil) est utilisée. Si ce n'est pas le cas, la carte obtenue peut fournir un formulaire vide pour permettre à un utilisateur d'accéder au point de départ. La valeur peut être un nom de lieu, une adresse ou des coordonnées de latitude/longitude séparées par une virgule. Une chaîne doit être encodée au format URL. Par conséquent, une adresse telle que "hôtel de ville, New York, NY" doit être convertie enCity+Hall%2C+New+York%2C+NY
.Remarque:Ce paramètre est facultatif, sauf si vous spécifiez un
origin_place_id
dans votre URL. Si vous choisissez de spécifier unorigin_place_id
, vous devez également inclure unorigin
dans l'URL.origin_place_id
(facultatif) : un identifiant de lieu est un identifiant textuel qui identifie un lieu de manière unique. Si vous essayez de spécifier définitivement un établissement, nous vous conseillons d'utiliser un ID de lieu pour associer le bon établissement. Les URL qui utilisent ce paramètre doivent également inclure unorigin
.destination
: définit le point de terminaison de l'itinéraire. Si ce n'est pas le cas, la carte obtenue peut fournir un formulaire vide pour permettre à l'utilisateur de saisir la destination. La valeur peut être un nom de lieu, une adresse ou des coordonnées de latitude/longitude séparées par une virgule. Une chaîne doit être encodée au format URL. Par conséquent, une adresse telle que "hôtel de ville, New York, NY" doit être convertie enCity+Hall%2C+New+York%2C+NY
.Remarque : Ce paramètre est facultatif, sauf si vous spécifiez un
destination_place_id
dans votre URL. Si vous choisissez de spécifier undestination_place_id
, vous devez également inclure undestination
dans l'URL.destination_place_id
(facultatif) : un identifiant de lieu est un identifiant textuel qui identifie un lieu de manière unique. Si vous essayez de spécifier définitivement un établissement, nous vous conseillons d'utiliser un ID de lieu pour associer le bon établissement. Les URL qui utilisent ce paramètre doivent également inclure undestination
.travelmode
(facultatif) : définit le mode de transport. Les options disponibles sontdriving
,walking
(de préférence pour les voies piétonnes et les trottoirs, le cas échéant),bicycling
(pour les itinéraires à vélo et les rues à privilégier, le cas échéant) outransit
. Si aucuntravelmode
n'est spécifié, Google Maps affiche un ou plusieurs des modes les plus pertinents pour l'itinéraire et/ou les préférences utilisateur spécifiés.dir_action=navigate
(facultatif): lance la navigation détaillée ou l'aperçu de l'itinéraire vers la destination spécifiée, selon que l'origine est disponible. Si l'utilisateur spécifie une origine qui n'est pas proche de la position actuelle de l'utilisateur ou de la position actuelle de l'appareil non disponible, la carte lance un aperçu de l'itinéraire. Si l'utilisateur ne spécifie pas de point de départ (auquel cas l'origine est définie par défaut sur la position actuelle de l'appareil), ou si celle-ci est proche de la position actuelle de l'utilisateur, la carte lance la navigation détaillée. Notez que la navigation n'est pas disponible sur tous les produits Google Maps et/ou entre toutes les destinations. Dans ce cas, ce paramètre sera ignoré.waypoints
: spécifie un ou plusieurs lieux intermédiaires permettant d'acheminer les itinéraires entreorigin
etdestination
. Vous pouvez spécifier plusieurs points de cheminement en utilisant une barre verticale (|
) pour séparer les lieux (par exemple,Berlin,Germany|Paris,France
). Le nombre de points de cheminement varie selon la plate-forme sur laquelle le lien s'ouvre. Jusqu'à trois points de cheminement peuvent être pris en charge sur les navigateurs mobiles, et neuf points de cheminement sont pris en charge. Les points de cheminement s'affichent sur la carte dans l'ordre dans lequel ils sont indiqués dans l'URL. Chaque point de cheminement peut être un nom de lieu, une adresse ou des coordonnées de latitude/longitude séparées par une virgule. Les chaînes doivent être encodées au format URL. Les points de cheminement tels que "Berlin, Allemagne|Paris,France" doivent être convertis enBerlin%2CGermany%7CParis%2CFrance
.Remarques :
- Les points de cheminement ne sont pas compatibles avec tous les produits Google Maps. Dans ce cas, ce paramètre est ignoré.
- Ce paramètre est facultatif, sauf si vous spécifiez
waypoint_place_ids
dans votre URL. Si vous choisissez de spécifierwaypoint_place_ids
, vous devez également inclurewaypoints
dans l'URL.
waypoint_place_ids
(facultatif) : un identifiant de lieu est un identifiant textuel qui identifie un lieu de manière unique.Waypoint_place_ids
vous permet de fournir une liste d'ID de lieu correspondant à la liste dewaypoints
. Les identifiants de lieu doivent être répertoriés dans le même ordre que les points de cheminement et séparés par une barre verticale "|
" (encodée au format URL sous%7C
). Si vous essayez de spécifier définitivement certains établissements, les identifiants de lieu constituent la meilleure garantie que vous créerez un lien vers les bons lieux. Les URL qui utilisent ce paramètre doivent également inclurewaypoints
.
Exemples d'itinéraires
L'URL suivante lance une carte en mode Itinéraire et fournit un formulaire permettant à l'utilisateur de saisir le point de départ et la destination.
https://www.google.com/maps/dir/?api=1
L'exemple suivant permet de lancer une carte avec un itinéraire à vélo du Space Needle au marché de Pike Place, à Seattle.
L'exemple suivant permet de lancer une carte avec un itinéraire à pied entre Google, à Sydney, en Australie, et le Queen Victoria Building.
Afficher une carte
L'action sur la carte renvoie une carte sans repère ni itinéraire.
Création de l'URL de la carte
https://www.google.com/maps/@?api=1&map_action=map¶meters
Paramètres
map_action=map
(obligatoire): spécifie le type de vue plan à afficher. Maps et Street View partagent le même point de terminaison. Pour vous assurer qu'une carte s'affiche,map_action
doit être défini surmap
.center
(facultatif): définit le centre de la fenêtre de carte et accepte les coordonnées de latitude/longitude en tant que valeurs séparées par une virgule (par exemple,-33.8569,151.2152
).zoom
(facultatif): définit le niveau de zoom initial de la carte. Les valeurs acceptées sont des entiers compris entre 0 (monde entier) et 21 (bâtiments individuels). La limite supérieure peut varier en fonction des données de carte disponibles pour le lieu sélectionné. La valeur par défaut est 15.basemap
(facultatif): définit le type de carte à afficher. La valeur peut êtreroadmap
(par défaut),satellite
outerrain
.layer
(facultatif): définit un calque supplémentaire à afficher sur la carte, le cas échéant. La valeur peut être l'une des suivantes:none
(par défaut),transit
,traffic
oubicycling
.
Exemples de carte
Cet exemple d'URL lance une carte Google Maps par défaut, centrée sur la position actuelle de l'utilisateur.
https://www.google.com/maps/@?api=1&map_action=map
L'exemple suivant affiche une carte centrée sur Katoomba, en Nouvelle-Galles du Sud, en Australie (à -33.712206,150.311941
), et définit les paramètres zoom
et basemap
facultatifs.
Afficher un panorama Street View
L'action de panorama vous permet de lancer une visionneuse pour afficher les images Street View sous forme de panoramas interactifs. Chaque panorama Street View offre une vue complète à 360 degrés d'un même lieu. Les images proposent une vue horizontale à 360 degrés (tour d'horizon complet) et une vue verticale à 180 degrés (de droite à droite). L'action de panorama lance une visionneuse qui affiche le panorama obtenu sous la forme d'une sphère avec une caméra au centre. Vous pouvez manipuler l'appareil photo pour contrôler le zoom et l'orientation.
Google Street View offre des vues panoramiques à partir de lieux spécifiques dans sa zone de couverture. Des photo-sphères ajoutées par les utilisateurs et des collections spéciales Street View sont également disponibles.
Créer l'URL Street View
https://www.google.com/maps/@?api=1&map_action=pano¶meters
Paramètres
map_action=pano
(obligatoire): spécifie le type de vue à afficher. Maps et Street View partagent le même point de terminaison. Pour vous assurer qu'un panorama s'affiche,action
doit être défini surpano
.
L'un des paramètres d'URL suivants est également obligatoire:
viewpoint
: la visionneuse affiche le panorama photographié le plus proche du lieuviewpoint
, spécifié sous forme de coordonnées de latitude/longitude séparées par une virgule (par exemple, 46.414382,10.013988). Étant donné que les images Street View sont régulièrement actualisées et que les photos peuvent être prises à des emplacements légèrement différents à chaque fois, il est possible que votre position soit prise en compte sur un panorama différent lors de la mise à jour des images.pano
: ID de panorama spécifique de l'image à afficher. Si vous spécifiez unpano
, vous pouvez également spécifier unviewpoint
. L'élémentviewpoint
n'est utilisé que si Google Maps ne trouve pas l'ID de panorama. Sipano
est spécifié mais introuvable, et qu'viewpoint
est NON spécifié, aucune image de panorama n'est affichée. Au lieu de cela, Google Maps s'ouvre en mode par défaut et affiche une carte centrée sur la position actuelle de l'utilisateur.
Les paramètres d'URL suivants sont facultatifs :
heading
: indique le cap de la boussole de la caméra en degrés dans le sens horaire à partir du nord. Les valeurs acceptées sont comprises entre -180 et 360 degrés. En cas d'omission, un en-tête par défaut est choisi en fonction du point de vue (le cas échéant) de la requête et de l'emplacement réel de l'image.pitch
: spécifie l'angle, vers le haut ou le bas, de l'appareil photo. La hauteur est exprimée en degrés, de -90 à 90. Les valeurs positives orientent l'appareil photo vers le haut, tandis que les valeurs négatives orientent l'appareil photo vers le bas. La hauteur par défaut de 0 est définie en fonction de la position de la caméra lors de la capture. De ce fait, un ton de 0 est souvent, mais pas toujours, horizontal. Par exemple, une image prise sur une colline présentera probablement une inclinaison par défaut qui n'est pas horizontale.fov
: détermine le champ de vision horizontal de l'image. Le champ de vision est exprimé en degrés, compris entre 10 et 100. La valeur par défaut est 90. Dans le cas d'une fenêtre d'affichage à taille fixe, le champ de vision est considéré comme le niveau de zoom. Plus le nombre est faible, plus le niveau de zoom est élevé.
Exemples Street View
Les deux premiers exemples offrent un panorama de la tour Eiffel. L'exemple 1 n'utilise qu'un viewpoint
pour l'emplacement et définit les paramètres facultatifs heading
, pitch
et fov
. À titre de comparaison, l'exemple 2 utilise un ID pano
ainsi que les mêmes paramètres que ceux du premier exemple. Le troisième exemple affiche une image panoramique intérieure.
Exemple 1: Utilise uniquement un viewpoint
pour spécifier l'emplacement.
Exemple 2: Il utilise un ID pano
ainsi qu'un emplacement viewpoint
.
L'ID pano
est prioritaire par rapport au viewpoint
.
Dans cet exemple, l'identifiant de panorama est trouvé. Par conséquent, viewpoint
est ignoré. Notez que l'image panoramique affichée pour l'ID pano
est légèrement différente et plus récente que l'image trouvée en utilisant uniquement viewpoint
.
Exemple 3: affiche un panorama de l'intérieur du restaurant Sarastro à Londres, au Royaume-Uni, spécifié avec un ID de panorama.
https://www.google.com/maps/@?api=1&map_action=pano&pano=4U-oRQCNsC6u7r8gp02sLA
Trouver un ID de panorama
Pour trouver l'ID d'une image panoramique spécifique, plusieurs méthodes s'offrent à vous.
- Pour JavaScript, utilisez la classe StreetViewPanorama.
- Pour Android, utilisez la classe publique StreetViewPanoramaLocation.
- Pour iOS, utilisez la classe GMSPanorama.
- Vous pouvez également envoyer des requêtes de métadonnées à l'aide de l'API Google Street View Image. Les requêtes de métadonnées d'image fournissent des données sur les panoramas Street View, y compris l'ID de panorama.
Autres exemples
Exemples d'itinéraires utilisant des points de cheminement
Les exemples d'itinéraires suivants permettent de lancer Google Maps et d'afficher l'itinéraire en voiture entre Paris (France) et Cherbourg (France), en suivant les points de cheminement suivants:
Ville, pays | Nom | ID d'emplacement |
---|---|---|
1. Versailles, France | Château de Versailles | ChIJdUyx15R95kcRj85ZX8H8OAU |
2. Chartres, France | Cathédrale de Chartres | ChIJKzGHdEgM5EcR_OBTT3nQoEA |
3. Le Mans, France | Cathédrale Saint-Julien du Mans | ChIJG2LvQNCI4kcRKXNoAsPi1Mc |
4. Caen, France | Château de Caen | ChIJ06tnGbxCCkgRsfNjEQMwUsc |
Dans les exemples d'URL, les points de cheminement sont définis de différentes manières, ce qui vous permet de comparer les différences d'affichage des points de cheminement sur les cartes obtenues.
Exemple 1: Points de cheminement définis comme ville, pays:
Exemple 2: Points de cheminement définis comme des noms de lieux spécifiques:
Exemple 3: des points de cheminement définis comme ville et pays, et fournit également waypoint_place_ids
pour un établissement spécifique dans chaque point de cheminement:
Exemple 4: Les points de cheminement sont définis sur "Ville, Pays", mais sont listés dans un ordre différent de ceux des exemples précédents. montre que la carte affiche les points de cheminement dans l'ordre dans lequel ils sont listés dans l'URL.
Exemples de carte
Affiche une carte avec les valeurs basemap
(satellite) et layer
(transit) spécifiées.
Exemples Street View
Affiche un panorama Street View en utilisant une clé d'image FIFE comme ID pano
. Notez que l'ID pano
est précédé de F:.