Commencer

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Présentation

Les URL Maps vous permettent de créer une URL universelle multiplate-forme pour lancer Google Maps, effectuer des recherches, obtenir un itinéraire et des fonctionnalités de navigation, et afficher des cartes 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, d'une application iOS ou d'un site Web, vous pouvez créer une URL commune. Google Maps ouvre alors l'application et effectue 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, puis effectue l'action demandée.
    • Si l'application Google Maps n'est pas installée ou 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, puis 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 à une plate-forme pour Android ou iOS. Consultez la documentation suivante:

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 correspondant à l'une des formes suivantes, en fonction de l'action demandée:

  • Recherche : lancez une carte Google 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&parameters
  • Itinéraire : demandez un itinéraire et lancez Google Maps avec les résultats suivants :
    https://www.google.com/maps/dir/?api=1&parameters
  • Afficher une carte : lancez Google Maps sans repère ni itinéraire :
    https://www.google.com/maps/@?api=1&map_action=map&parameters
  • Afficher un panorama Street View : lancez une image panoramique interactive :
    https://www.google.com/maps/@?api=1&map_action=pano&parameters

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 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 des valeurs de type "Ville", "État". Vous devez encoder la virgule en tant que %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

Actions de recherche disponibles: recherche, itinéraire, affichage de carte et 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 les URL, vous devez séparer les paramètres à l'aide d'une esperluette (&). Pour chaque action, la liste des paramètres et leurs valeurs possibles sont énumérées dans la section Paramètres de recherche.

Réseau de Recherche

L'action de recherche affiche les résultats d'une recherche dans la région visible de 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éer l'URL de recherche

https://www.google.com/maps/search/?api=1&parameters

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 "City Hall, 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 ou restaurants+in+seattle+wa.
  • query_place_id (facultatif) : un ID de lieu est un identifiant textuel qui identifie un lieu de manière unique. Pour l'action search, vous devez spécifier un query, mais vous pouvez également spécifier un query_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'identifiant de lieu constitue la meilleure garantie que vous établirez un lien vers l'établissement approprié. Il est également recommandé d'envoyer un query_place_id lorsque vous interrogez un lieu spécifique à l'aide de ses coordonnées de latitude/longitude.

Exemples de recherches

Recherche de lieu

Dans ce cas, 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 à ce lieu. Ces trois exemples illustrent des recherches sur le même lieu, le CenturyLink Field (un stade de Seattle, dans l'État de Washington), qui utilise des valeurs de localisation différentes.

Exemple 1: Si vous recherchez le nom du lieu "CenturyLink Field", vous obtenez la carte suivante:

https://www.google.com/maps/search/?api=1&query=centurylink+field

Exemple 2: La recherche d'un champ CenturyLink à l'aide de ses coordonnées de latitude/longitude et de l'identifiant de lieu aboutit à la carte suivante:

https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393&query_place_id=ChIJKxjxuaNqkFQR3CK6O1HNNqY

Exemple 3: La recherche d'un champ CenturyLink en n'utilisant que des coordonnées de latitude/longitude entraîne les résultats dans la carte suivante. Notez qu'un repère s'affiche 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 le cadre d'une recherche par catégorie, 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 aucun lieu n'est spécifié, Google Maps tente de trouver des fiches à proximité de votre position actuelle. Si vous préférez indiquer 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, la recherche d'une pizzeria à Seattle, WA, renvoie la carte suivante:

https://www.google.com/maps/search/?api=1&query=pizza+seattle+wa


Directions

L'action Itinéraire permet d'afficher le chemin entre deux points ou plus spécifiés sur la carte, ainsi que la distance et la durée du trajet.

Format de l'URL d'itinéraire

https://www.google.com/maps/dir/?api=1&parameters

Paramètres

  • origin : définit le point de départ de l'affichage des itinéraires. Il s'agit du lieu de départ le plus pertinent (par exemple, celui de l'utilisateur, si disponible). Si ce n'est pas le cas, la carte générée peut fournir un formulaire vide pour permettre à un 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 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.

    Remarque : Ce paramètre est facultatif, sauf si vous spécifiez un origin_place_id dans votre URL. Si vous choisissez de spécifier une propriété origin_place_id, vous devez également inclure un élément origin 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 définitivement un établissement, nous vous recommandons d'utiliser un identifiant de lieu pour associer le bon établissement. Les URL qui utilisent ce paramètre doivent également inclure un origin.
  • destination : définit le point de terminaison de l'itinéraire. Si ce n'est pas le cas, la carte générée 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 en City+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 une propriété destination_place_id, vous devez également inclure un élément destination 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 définitivement un établissement, nous vous recommandons d'utiliser un identifiant de lieu pour associer le bon établissement. Les URL qui utilisent ce paramètre doivent également inclure un destination.
  • travelmode (facultatif) : définit le mode de transport. Les options disponibles sont driving, walking (qui privilégie les voies piétonnes et les trottoirs), le cas échéant, bicycling (qui empruntent les pistes cyclables et les rues privilégiées le cas échéant) ou transit. Si aucun travelmode 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 ou non. Si l'utilisateur indique un point de départ et qu'il n'est pas situé à proximité de la position actuelle de l'utilisateur, ou que celle-ci 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 l'origine est définie par défaut sur l'emplacement actuel de l'utilisateur) 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 est ignoré.
  • waypoints : spécifie un ou plusieurs endroits intermédiaires pour acheminer l'itinéraire entre origin et destination. 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 autorisés varie selon la plate-forme sur laquelle le lien s'ouvre. Jusqu'à trois points de cheminement sont acceptés dans les navigateurs mobiles, et neuf points de cheminement sont acceptés dans le cas contraire. Les points de cheminement s'affichent sur la carte dans l'ordre dans lequel ils apparaissent 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 en Berlin%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écifier waypoint_place_ids, vous devez également inclure waypoints 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 lieux correspondant à la liste de waypoints. 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 (URL sous la forme %7C). Si vous essayez de spécifier définitivement certains établissements, les ID de lieu vous offriront une meilleure garantie que vous établirez un lien vers les bonnes adresses. Les URL qui utilisent ce paramètre doivent également inclure waypoints.

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 indiquant l'itinéraire à vélo entre Space Needle et Pike Place Market, à Seattle (Washington).

https://www.google.com/maps/dir/?api=1&origin=Space+Needle+Seattle+WA&destination=Pike+Place+Market+Seattle+WA&travelmode=bicycling

L'exemple suivant permet de lancer une carte avec des itinéraires à pied au départ de Google à Sydney, en Australie, et à destination du Queen Victoria Building.

https://www.google.com/maps/dir/?api=1&origin=Google+Pyrmont+NSW&destination=QVB&destination_place_id=ChIJISz8NjyuEmsRFTQ9Iw7Ear8&travelmode=walking


Afficher une carte

Cette action renvoie une carte sans repère ni itinéraire.

Format de l'URL de la carte

https://www.google.com/maps/@?api=1&map_action=map&parameters

Paramètres

  • map_action=map (obligatoire): spécifie le type de vue de la carte à afficher. Maps et Street View partagent le même point de terminaison. Pour vous assurer qu'une carte s'affiche, map_action doit être spécifié en tant que map.
  • center (facultatif): définit le centre de la fenêtre de la carte, et accepte les coordonnées de latitude et de 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 à l'emplacement sélectionné. La valeur par défaut est 15.
  • basemap (facultatif): définit le type de carte à afficher. La valeur peut être roadmap (par défaut), satellite ou terrain.
  • 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 ou bicycling.

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, NSW, en Australie (à -33.712206,150.311941), et définit les paramètres facultatifs zoom et basemap.

https://www.google.com/maps/@?api=1&map_action=map&center=-33.712206%2C150.311941&zoom=12&basemap=terrain


Afficher un panorama Street View

L'action de panorama vous permet de lancer une visionneuse pour afficher des 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 incluent une vue horizontale à 360 degrés (tour d'horizon complet) et une vue verticale à 180 degrés (du zénith au nadir). 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 sur l'ensemble de 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&parameters

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 garantir l'affichage d'un panorama, action doit être défini sur pano.

L'un des paramètres d'URL suivants est également obligatoire:

  • viewpoint : le lecteur affiche le panorama photographié le plus proche du lieu viewpoint, 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 prise sur un panorama différent lorsque les images sont mises à jour.
  • pano : l'ID de panorama spécifique de l'image à afficher. Si vous spécifiez un pano, vous pouvez également spécifier un viewpoint. viewpoint n'est utilisé que si Google Maps ne trouve pas l'ID de panorama. Si pano est spécifié, mais introuvable, et qu'un élément viewpoint est NON spécifié, aucune image de panorama n'est affichée. À 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 le cap de la boussole, en degrés, dans le sens des aiguilles d'une montre à 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 de la caméra (vers le haut ou vers le bas). Vous devez indiquer la hauteur en degrés comprise entre -90 et 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 (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 illustrent un panorama de la tour Eiffel. L'exemple 1 utilise uniquement 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 définis dans le premier exemple. Le troisième exemple affiche une image panoramique intérieure.

Exemple 1: Utilise uniquement un viewpoint pour spécifier l'emplacement.

https://www.google.com/maps/@?api=1&map_action=pano&viewpoint=48.857832%2C2.295226&heading=-45&pitch=38&fov=80

Exemple 2: Utilise un ID pano et un emplacement viewpoint. L'ID pano est prioritaire sur viewpoint. Dans cet exemple, l'ID de panorama a été 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 uniquement à l'aide de viewpoint.

https://www.google.com/maps/@?api=1&map_action=pano&pano=tu510ie_z4ptBZYo2BGEJg&viewpoint=48.857832%2C2.295226&heading=-45&pitch=38&fov=80

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'identifiant d'une image de panorama spécifique, plusieurs méthodes s'offrent à vous.

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 de Paris à France, à Cherbourg (France), en empruntant les points de cheminement suivants:

Ville, paysNomID d'emplacement
1. Versailles, France Le 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 par ville ou pays

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CChartres%2CFrance%7CLe+Mans%2CFrance%7CCaen%2CFrance

Exemple 2 : Points de cheminement définis comme des noms de lieux spécifiques

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Palace+of+Versailles%7CChartres+Cathedral%7CCathedral+of+Saint+Julian+of+Le+Mans%7CCaen+Castle

Exemple 3: les points de cheminement définis comme ville, pays, et fournissent également waypoint_place_ids pour un établissement spécifique dans chaque point de cheminement:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CChartres%2CFrance%7CLe+Mans%2CFrance%7CCaen%2CFrance&waypoint_place_ids=ChIJdUyx15R95kcRj85ZX8H8OAU%7CChIJKzGHdEgM5EcR_OBTT3nQoEA%7CChIJG2LvQNCI4kcRKXNoAsPi1Mc%7CChIJ06tnGbxCCkgRsfNjEQMwUsc

Exemple 4: définit des points de cheminement comme ville, pays, mais les répertorie dans un ordre différent de ceux des exemples précédents. Cet exemple montre que la carte affiche les points de cheminement dans l'ordre dans lequel ils sont répertoriés dans l'URL.

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CCaen%2CFrance%7CLe+Mans%2CFrance%7CChartres%2CFrance

Exemples de cartes

Affiche une carte avec les champs basemap (Satellite) et layer (transports en commun) spécifiés.

https://www.google.com/maps/@?api=1&map_action=map&center=37.7992940%2C-122.3976113&zoom=15&basemap=satellite&layer=transit

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:.

https://www.google.com/maps/@?api=1&map_action=pano&pano=F:-ud6AZSB-sQg/V0cfCSV3OWI/AAAAAAAAG1U/UQEoc5sXPQEIP7zzD6SWzmKb8Vbug47uQCLIB&heading=22&pitch=-5&fov=55