Présentation
En utilisant les URL Maps, vous pouvez créer une URL universelle multiplate-forme permettant de lancer Google Maps et d'effectuer des recherches, d'obtenir un itinéraire et de naviguer, et d'afficher des cartes et des images panoramiques. La syntaxe de l'URL est la même quelle que soit la plate-forme utilisée.
Vous n'avez pas besoin d'une clé API Google pour utiliser les URL Maps.
Syntaxe multiplate-forme universelle
En tant que développeur d'une application Android, d'une application iOS ou d'un site Web, vous pouvez créer une URL commune. Celle-ci ouvrira Google Maps et effectuera l'action demandée, quelle que soit la plate-forme utilisée au moment 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 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 cette application 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. En effet, ces URL universelles permettent de traiter plus largement les demandes de cartes, quelle que soit la plate-forme utilisée. Pour les fonctionnalités susceptibles de ne fonctionner que sur une plate-forme mobile (par exemple, la navigation détaillée), vous pouvez 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
- Schéma d'URL Google Maps pour iOS : spécifiquement pour lancer l'application Google Maps pour iOS
Lancer Google Maps et effectuer une action spécifique
Pour lancer Google Maps et éventuellement exécuter l'une des fonctions compatibles, utilisez un schéma d'URL au format suivant, en fonction de l'action demandée:
- Rechercher : lancez une carte Google qui affiche un repère sur 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 :
https://www.google.com/maps/dir/?api=1¶meters
- Afficher une carte : lancez Google Maps sans repère ni itinéraire :
https://www.google.com/maps/@?api=1&map_action=map¶meters
- Afficher un panorama Street View : lancez une image de panorama 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 présent dans l'URL, tous les paramètres sont ignorés et l'application Google Maps par défaut se lance soit dans un navigateur, soit 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 les coordonnées de latitude/longitude ou la ville et l'État. Vous devez encoder la virgule au format %2C
. Encodez les 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
Vous pouvez effectuer des recherches, obtenir des itinéraires, afficher une carte ou afficher 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 c'est la norme pour les URL, vous devez séparer les paramètres à l'aide de l'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 zone visible de la carte. Lorsque vous recherchez un lieu spécifique, la carte qui en résulte place un repère à l'endroit spécifié et affiche les détails disponibles.
Créer 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 des lieux en tant que nom de lieu, adresse ou coordonnées de latitude/longitude séparées par une virgule. Les chaînes doivent être encodées en URL afin que les adresses telles que "City Hall, New York, NY" soient converties 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 en URL, telle que
grocery+stores
ourestaurants+in+seattle+wa
.
- Spécifiez des lieux en tant que nom de lieu, adresse ou coordonnées de latitude/longitude séparées par une virgule. Les chaînes doivent être encodées en URL afin que les adresses telles que "City Hall, New York, NY" soient converties en
query_place_id
(facultatif) : un ID de lieu est un identifiant textuel qui identifie un lieu de manière unique. Pour l'actionsearch
, vous devez spécifier unequery
, mais vous pouvez également spécifier unequery_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 est la meilleure garantie d'associer le bon lieu. Il est également recommandé d'envoyer unequery_place_id
lorsque vous recherchez un lieu spécifique à l'aide de coordonnées de latitude/longitude.
Exemples de recherches
Recherche de lieux
Lors d'une recherche de lieu, vous recherchez 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 qui en résulte affiche un repère au niveau de ce lieu. Ces trois exemples illustrent les recherches pour le même lieu, CenturyLink Field (un stade de sport à Seattle, dans l'État de Washington), utilisant différentes valeurs de localisation.
Exemple 1: La recherche du nom de lieu "CenturyLink Field" génère la carte suivante:
https://www.google.com/maps/search/?api=1&query=centurylink+field
Exemple 2: La recherche de CenturyLink Field à l'aide de coordonnées de latitude/longitude ainsi que de l'identifiant de lieu donne lieu à la carte suivante:
Exemple 3: La recherche du champ CenturyLink en utilisant uniquement des coordonnées de latitude/longitude génère la carte suivante. Notez qu'il y a un repère sur la carte, mais qu'aucune autre information 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 une recherche par catégorie, vous transmettez un terme de recherche générique. Google Maps tente alors de trouver des fiches correspondant à vos critères à proximité du lieu spécifié.
Si aucun lieu n'est spécifié, Google Maps tente de trouver des fiches à proximité de votre position actuelle. Si vous préférez fournir un lieu pour une recherche par catégorie, incluez-le dans la chaîne de recherche générale (par exemple, pizza+seattle+wa
).
Dans cet exemple, la recherche de pizzerias à Seattle, Washington génère la carte suivante:
https://www.google.com/maps/search/?api=1&query=pizza+seattle+wa
Directions
L'action d'itinéraire affiche le trajet entre deux ou plusieurs points spécifiés sur la carte, ainsi que la distance et le temps de trajet.
Créer l'URL d'itinéraire
https://www.google.com/maps/dir/?api=1¶meters
Paramètres
origin
: définit le point de départ à partir duquel l'itinéraire doit être affiché. Par défaut, le lieu de départ le plus pertinent, tel que la position de l'appareil, est utilisé par défaut, le cas échéant. S'il n'y en a aucune, la carte obtenue peut fournir un formulaire vide permettant à l'utilisateur de saisir le 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 en URL afin qu'une adresse telle que "City Hall, New York, NY" soit 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 ID de lieu est un identifiant textuel qui identifie un lieu de manière unique. Si vous essayez de spécifier un établissement de manière définitive, l'utilisation d'un ID de lieu est la meilleure garantie d'associer l'établissement au bon endroit. Les URL qui utilisent ce paramètre doivent également inclure unorigin
.destination
: définit le point d'arrivée de l'itinéraire. S'il n'y en a pas, la carte obtenue peut fournir un formulaire vide permettant à 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 en URL afin qu'une adresse telle que "City Hall, New York, NY" soit 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 ID de lieu est un identifiant textuel qui identifie un lieu de manière unique. Si vous essayez de spécifier un établissement de manière définitive, l'utilisation d'un ID de lieu est la meilleure garantie d'associer l'établissement au bon endroit. Les URL qui utilisent ce paramètre doivent également inclure undestination
.travelmode
(facultatif) : définit le mode de transport. Les options sontdriving
,walking
(pour les voies piétonnes et les trottoirs, le cas échéant),bicycling
(pour les itinéraires empruntant les pistes cyclables et les rues à privilégier) 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 le point de départ est disponible ou non. Si l'utilisateur spécifie un point de départ et qu'il n'est pas proche de sa position actuelle, ou si la position actuelle de l'appareil n'est pas 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 le point de départ est défini par défaut sur la position actuelle de l'appareil) ou si le point de départ est proche de sa position actuelle, la carte lance la navigation détaillée. Notez que la navigation n'est pas disponible dans tous les produits Google Maps et/ou entre toutes les destinations. Dans ce cas, ce paramètre est ignoré.waypoints
: spécifie un ou plusieurs lieux intermédiaires pour l'itinéraire entre les élémentsorigin
etdestination
. Vous pouvez spécifier plusieurs points de cheminement à l'aide de la barre verticale (|
) pour séparer les lieux (par exemple,Berlin,Germany|Paris,France
). Le nombre de points de cheminement autorisés varie en fonction de la plate-forme sur laquelle le lien s'ouvre. Jusqu'à trois points de cheminement sont acceptés sur les navigateurs mobiles, et neuf autres sont acceptés dans les autres cas. Les points de cheminement sont affichés 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 afin que 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 ID 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 à faire correspondre à la listewaypoints
. Les ID de lieu doivent être listés dans le même ordre que les points de cheminement et séparés à l'aide de la barre verticale "|
" ( encodée en URL sous la forme%7C
). Si vous essayez de spécifier certains établissements de façon définitive, les ID de lieu constituent le meilleur moyen de créer des liens vers les bonnes adresses. Les URL qui utilisent ce paramètre doivent également inclurewaypoints
.avoid
(facultatif) : définit les caractéristiques que l'itinéraire doit essayer d'éviter. Il peut être défini sur une ou plusieurs des options suivantes, séparées par une virgule ",
" ( encodée au format URL sous la forme%2C
) :ferries
highways
tolls
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 des itinéraires à vélo de la Space Needle au marché de Pike Place, à Seattle, dans l'État de Washington.
L'exemple suivant lance une carte avec l'itinéraire à pied de Google à Sydney, en Australie, jusqu'au Queen Victoria Building.
Afficher une carte
L'action sur la carte renvoie une carte sans repère ni itinéraire.
Créer 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 de carte à afficher. Maps et Street View partagent le même point de terminaison. Pour qu'une carte s'affiche, lemap_action
doit être spécifié en tant quemap
.center
(facultatif): définit le centre de la fenêtre de la 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 entiers compris entre 0 (le monde entier) et 21 (bâtiments individuels). La limite supérieure peut varier en fonction des données cartographiques 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 cartes
Cet exemple d'URL lance une carte Google 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, Nouvelle-Galles du Sud, Australie (à -33.712206,150.311941
), et définit les paramètres facultatifs zoom
et basemap
.
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 offrent une vue horizontale à 360 degrés (tour d'horizon complet) et une vue verticale à 180 degrés (du zénith au féminin). 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 la caméra 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 qu'un panorama s'affiche,action
doit être spécifié en tant quepano
.
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 positions légèrement différentes à chaque fois, il est possible que votre position soit associée à un panorama différent lorsque les images sont mises à jour.pano
: identifiant de panorama spécifique de l'image à afficher. Si vous spécifiez unepano
, vous pouvez également spécifier uneviewpoint
. L'identifiantviewpoint
n'est utilisé que si Google Maps ne trouve pas l'identifiant de panorama. Sipano
est spécifié, mais introuvable, et qu'uneviewpoint
n'est PAS spécifiée, aucune image de panorama ne s'affiche. À la place, 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 l'orientation de la boussole de la caméra en degrés dans le sens des aiguilles d'une montre à partir du nord. Les valeurs acceptées sont comprises entre -180 degrés et 360 degrés. S'il est omis, un en-tête par défaut est choisi en fonction du point de vue (s'il est spécifié) de la requête et de l'emplacement réel de l'image.pitch
: spécifie l'angle (vers le haut ou vers le bas) de la caméra. L'inclinaison est spécifiée en degrés, entre -90 et 90. Une valeur positive orientera l'appareil photo vers le haut, tandis qu'une valeur négative l'orientera vers le bas. L'inclinaison par défaut de 0 est définie en fonction de la position de la caméra lorsque l'image a été prise. De ce fait, une tonalité de 0 est souvent, mais pas toujours, horizontale. 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, avec une plage de 10 à 100. La valeur par défaut est 90. Dans le cas d'une fenêtre d'affichage de 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 présentent 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
. À des fins de comparaison, l'exemple 2 utilise un ID pano
ainsi que les mêmes paramètres définis dans le premier exemple. Le troisième exemple montre un panorama d'intérieur.
Exemple 1: N'utilise qu'un élément viewpoint
pour spécifier l'emplacement.
Exemple 2: utilise un ID pano
ainsi qu'un établissement viewpoint
.
L'ID pano
prévaut sur viewpoint
.
Dans cet exemple, l'identifiant du panorama a été trouvé. viewpoint
est donc ignoré. Notez que l'image de panorama affichée pour l'identifiant 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, avec un identifiant de panorama.
Trouver un identifiant de panorama
Pour trouver l'identifiant d'une image de panorama 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 lancent Google Maps et affichent l'itinéraire en voiture de Paris (France) à Cherbourg (France), en passant par les points de cheminement suivants:
Ville, pays | Nom | ID de lieu |
---|---|---|
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 afin que vous puissiez comparer les différences d'affichage des points de cheminement sur les cartes obtenues.
Exemple 1 : Points de cheminement définis en tant que Ville, Pays
Exemple 2 : Points de cheminement définis comme des noms de lieux spécifiques
Exemple 3 : Points de cheminement définis en tant que ville, pays, et fournit également un waypoint_place_ids
pour un établissement spécifique à chaque point de cheminement
Exemple 4: définit les points de cheminement en tant que ville et pays, mais répertorie les points de cheminement dans un ordre différent de celui 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 cartes
Affiche une carte avec les valeurs basemap
(satellite) et layer
(transports en commun) spécifiées.
Exemples Street View
Affiche un panorama Street View en utilisant une clé d'image FIFE comme identifiant pano
. Notez que l'ID pano
est précédé de F:.