Débuter

Introduction

En utilisant les URL Maps, vous pouvez créer une URL universelle multiplate-forme permettant de lancer Google Maps pour effectuer des recherches, obtenir un itinéraire, utiliser la navigation, et 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 qui ouvrira Google Maps et effectuera l'action demandée, quelle que soit la plate-forme utilisée lorsque la carte est ouverte.

  • 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 depuis votre application ou votre site Web, car ces URL universelles permettent de traiter plus largement les demandes de cartes, quelle que soit la plate-forme utilisée. Pour les fonctionnalités qui ne sont peut-être fonctionnelles que sur une plate-forme mobile (par exemple, la navigation détaillée), vous pouvez préférer utiliser une option spécifique à la 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 de 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 :
    https://www.google.com/maps/dir/?api=1&parameters
  • Afficher une carte — lancer Google Maps sans repères ni itinéraires :
    https://www.google.com/maps/@?api=1&map_action=map&parameters
  • Créer une liste : lancez Google Maps avec une liste de lieux spécifiques :
    https://www.google.com/maps/@?api=1&map_action=shortlist&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, soit dans un navigateur, soit dans l'application mobile Google Maps, selon 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 sous la forme %7C dans l'URL finale. D'autres paramètres utilisent des valeurs séparées par une virgule, comme les coordonnées de latitude/longitude ou la ville et l'état. Vous devez encoder la virgule en tant que %2C. Encodez les espaces avec %20 ou remplacez-les par un signe plus (+).

En outre, les URL sont limitées à 2 048 caractères par requête. Tenez compte de cette limite lorsque vous créez vos URL.

Actions sur la carte

Les actions de carte disponibles sont les suivantes : recherche, itinéraire, affichage d'une carte, création d'une présélection et 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 c'est la norme pour les URL, les différents paramètres sont séparés par 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.

Rechercher

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 qui s'affiche place un repère à l'emplacement indiqué et affiche les détails disponibles sur le lieu.

Former 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 exemple, 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 forme de chaîne encodée au format URL, par exemple 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 de créer un lien définitif vers un établissement spécifique, l'ID de lieu est la meilleure garantie que vous créerez un lien vers le bon lieu. Il est également recommandé d'envoyer un query_place_id lorsque vous recherchez un lieu spécifique à l'aide de coordonnées de latitude/longitude.

Exemples de recherches

Recherche de lieux

Dans 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 obtenue affiche un repère à cet emplacement. Ces trois exemples illustrent des recherches pour le même lieu avec des valeurs de lieu différentes.

Exemple 1 : La recherche du nom de lieu "Lumen Field" donne la carte suivante :

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

Plan du Lumen Field

Exemple 2 : La recherche de Lumen Field en utilisant uniquement les coordonnées de latitude/longitude donne la carte suivante. Notez qu'un repère est présent sur la carte, mais qu'aucune information supplémentaire 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

Exemple 3 : La recherche de Lumen Field à l'aide des coordonnées de latitude/longitude et de l'ID de lieu donne la carte suivante :

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

Exemple 4 : La recherche du nom de lieu "Starbucks" donne la carte suivante :

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

Résultats de recherche pour Starbucks

Exemple 5 : Recherche d'un Starbucks spécifique à l'aide du nom et de l'ID de lieu, ce qui donne la carte suivante :

https://www.google.com/maps/search/?api=1&query=starbucks&query_place_id=ChIJsU30zM1qkFQRbnOm1_LBoG0

Si votre objectif est d'afficher les détails d'un lieu spécifique, créez les URL de recherche en utilisant l'un des formats recommandés suivants :

  • query=PLACE_NAME,ADDRESS
  • query=PLACE_NAME&query_place_id=PLACE_ID

Pour récupérer des ID de lieu de manière programmatique, vous pouvez utiliser les fonctionnalités de l'API Places : Text Search(ID Only). Cette méthode permet d'obtenir des ID de lieu sans frais. En savoir plus sur l'ID de lieu et la requête de l'API Places(New)

Les ID de lieu peuvent également être récupérés lorsqu'un utilisateur clique ou appuie sur un POI sur une carte. En savoir plus sur les icônes de POI cliquables (JavaScript, Android, iOS)

Recherche par catégorie

Dans une recherche par catégorie, vous transmettez un terme de recherche général, et Google Maps tente de trouver des fiches correspondant à vos critères à proximité du lieu que vous spécifiez. 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, une recherche de pizzerias à Seattle, dans l'État de Washington, génère la carte suivante :

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

Itinéraire

L'action "Itinéraire" affiche le chemin 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&parameters

Paramètres

  • origin : définit le point de départ à partir duquel afficher l'itinéraire. Par défaut, il s'agit du point de départ le plus pertinent, comme la position de l'appareil, si elle est disponible. Si aucune n'est trouvée, la carte résultante peut fournir un formulaire vide pour permettre à un utilisateur de saisir l'origine. Cette 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 exemple, une adresse telle que "City Hall, 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 un origin_place_id, vous devez également inclure un 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 un établissement de manière définitive, l'utilisation d'un ID de lieu est la meilleure garantie que vous ferez référence au bon lieu. Les URL qui utilisent ce paramètre doivent également inclure un origin.
  • destination : définit le point de terminaison des directions. Si aucune destination n'est spécifiée, la carte obtenue peut fournir un formulaire vide pour permettre à l'utilisateur de saisir la destination. Cette 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 "City Hall, 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 un destination_place_id, vous devez également inclure un 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, l'utilisation d'un ID de lieu est la meilleure garantie que vous l'associerez au bon endroit. Les URL qui utilisent ce paramètre doivent également inclure un destination.
  • travelmode (facultatif) : définit le mode de transport. Voici la liste des options :
    • driving
    • walking : privilégie les voies piétonnes et les trottoirs, si disponibles.
    • bicycling : itinéraires empruntant des pistes cyclables, si disponibles. "Vélo" fait référence à un mode de déplacement à propulsion humaine.
    • two-wheeler : itinéraires empruntant les rues préférées des deux-roues, si disponibles. "Deux-roues" fait référence aux véhicules motorisés à deux roues, tels que les motos. Pour en savoir plus, consultez Couverture des deux-roues.
    • transit
    Si aucun travelmode n'est spécifié, Google Maps affiche un ou plusieurs des modes les plus pertinents pour l'itinéraire spécifié et/ou les préférences de l'utilisateur.
  • dir_action=navigate (facultatif) : lance la navigation guidé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 spécifie un point de départ qui 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 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 lieux intermédiaires par lesquels l'itinéraire doit passer entre origin et destination. Vous pouvez spécifier plusieurs points de repère en utilisant le caractère barre verticale (|) pour séparer les lieux (par exemple, Berlin,Germany|Paris,France). Le nombre de points de repère autorisés varie en fonction de la plate-forme sur laquelle le lien s'ouvre. Jusqu'à trois points de repère sont acceptés sur les navigateurs mobiles, et un maximum de neuf points de repère est autorisé dans les autres cas. Les points de repère s'affichent sur la carte dans l'ordre dans lequel ils sont listé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 en URL. Par conséquent, les points de cheminement tels que "Berlin,Germany|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 lieu correspondant à la liste de waypoints. Les ID de lieu doivent être listés dans le même ordre que les points de cheminement et séparés par une barre verticale "|" ( encodée en URL sous la forme %7C). Si vous essayez de spécifier définitivement certains établissements, les ID de lieu sont la meilleure garantie que vous ferez le lien avec les bons lieux. Les URL qui utilisent ce paramètre doivent également inclure waypoints.
  • avoid (facultatif) : définit les éléments que l'itinéraire doit essayer d'éviter. Il peut être défini sur une ou plusieurs de ces options, séparées par une virgule "," ( encodée au format URL sous la forme %2C) :
    • ferries
    • highways
    • tolls

Exemples d'instructions

L'URL suivante lance une carte en mode itinéraire et fournit un formulaire permettant à l'utilisateur de saisir l'origine et la destination.

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

Carte du point de départ à la destination

L'exemple suivant lance une carte avec un itinéraire à vélo entre la Space Needle et le marché de Pike Place, à Seattle, dans l'État de Washington.

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

Carte de la destination Seattle

L'exemple suivant lance une carte avec des itinéraires pour deux-roues de Google Mumbai à l'aéroport international de Mumbai.

https://www.google.com/maps/dir/?api=1&origin=Google+Mumbai+India&destination=Mumbai+Airport&travelmode=two-wheeler

Carte de la destination Aéroport international de Mumbai

L'exemple suivant lance une carte avec un itinéraire à pied entre Google Sydney (Australie) et le Queen Victoria Building.

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

Carte de la destination Queen Victoria Building

Afficher une carte

L'action de carte renvoie une carte sans repères ni itinéraires.

Créer 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 carte à afficher. Maps et Street View partagent le même point de terminaison. Pour qu'une carte s'affiche, map_action doit être spécifié comme map.
  • center (facultatif) : définit le centre de la fenêtre de la carte et accepte les coordonnées de latitude/longitude sous forme de 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 nombres 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 à 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 une couche 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 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 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 un lecteur 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 contiennent une vue horizontale à 360 degrés (tour d'horizon complet) et une vue verticale à 180 degrés (du zénith au nadir). L'action pano lance une visionneuse qui affiche le panorama résultant 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 de la caméra.

Google Street View offre des vues panoramiques à partir des lieux sélectionnés dans sa zone de couverture. Les photosphères ajoutées par les utilisateurs et les 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 qu'un panorama s'affiche, action doit être défini sur pano.

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

  • viewpoint : le lecteur affiche le panorama photographié le plus proche de l'emplacement 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 à partir de positions légèrement différentes à chaque fois, il est possible que votre position soit alignée sur un autre panorama lorsque les images sont mises à jour.
  • pano : 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 du panorama. Si pano est spécifié, mais introuvable, et qu'aucun viewpoint n'est spécifié, aucune image panoramique 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 et 360 degrés. Si ce paramètre est omis, un cap par défaut est choisi en fonction du point de vue (si spécifié) 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. L'inclinaison est spécifiée en degrés, de -90 à 90. Les valeurs positives orientent la caméra vers le haut, tandis que les valeurs négatives l'orientent vers le bas. Le pitch par défaut de 0 est défini en fonction de la position de la caméra au moment où l'image a été capturée. Pour cette raison, une inclinaison 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. Lorsque vous utilisez une fenêtre d'affichage de taille fixe, le champ de vision est considéré comme le niveau de zoom, les chiffres les plus petits indiquant un niveau de zoom plus élevé.

Exemples Street View

Les deux premiers exemples affichent un panorama de la tour Eiffel. Le premier exemple 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 que ceux définis dans le premier exemple. Le troisième exemple affiche une image panoramique d'intérieur.

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 ainsi qu'un emplacement viewpoint. L'ID pano est prioritaire sur viewpoint. Dans cet exemple, l'ID du panorama est trouvé, donc 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 celle trouvée en utilisant uniquement 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 identifiant de panorama

Pour trouver l'ID d'une image panoramique spécifique, vous pouvez utiliser plusieurs méthodes.

Créer une sélection

L'action "Sélectionner" affiche une liste de lieux spécifiques et permet à l'utilisateur de les enregistrer dans son profil Google Maps, de les partager avec d'autres personnes ou de les explorer individuellement.

Créer l'URL de la liste de sélection

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

Paramètres

  • map_action=shortlist (obligatoire) : spécifie l'action de présélection.
  • place_ids (obligatoire) : définit les lieux à inclure dans la présélection. Ce paramètre accepte un ou plusieurs ID de lieu sous forme de valeurs séparées par une virgule. Vous pouvez spécifier jusqu'à 20 ID de lieu.

Exemple de sélection

L'exemple suivant lance une carte avec une liste restreinte contenant trois lieux spécifiques.

https://www.google.com/maps/@?api=1&map_action=shortlist&place_ids=ChIJKxjxuaNqkFQR3CK6O1HNNqY,ChIJdWjwULVqkFQRh8ifgzporms,ChIJQ_oEiK1qkFQRg3bU4l3mmWs

Autres exemples

Exemples d'itinéraires utilisant des points de cheminement

Les exemples de directions suivants lancent Google Maps et affichent des itinéraires en voiture de Paris à Cherbourg, en France, en passant par les points de repère suivants :

Ville, paysNomID de lieu
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 repère définis comme ville et 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 repère 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 : Points de cheminement définis comme ville et pays, et fournissant également waypoint_place_ids pour un établissement spécifique à 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 les points de cheminement comme "Ville, Pays", mais les liste dans un ordre différent de celui des exemples précédents. Démontre que la carte affiche les points de repère dans l'ordre où ils sont listé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 paramètres 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 à l'aide d'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

Améliorer les URL Maps avec des paramètres UTM

Pour aider Google à mieux comprendre comment les développeurs intègrent les URL Maps et pour garantir des performances optimales, nous vous encourageons à inclure des paramètres de suivi UTM dans la création de vos URL. En ajoutant les paramètres utm_source et utm_campaign, vous fournissez des données précieuses qui nous permettent d'analyser les modèles d'utilisation et d'améliorer le produit URL Maps.

Pour le paramètre utm_source, veuillez utiliser le nom de votre application. Le paramètre utm_campaign doit refléter l'action prévue de l'utilisateur, par exemple "location_sharing", "place_details_search" ou "directions_request".

Par exemple, une URL avec des paramètres UTM peut se présenter comme suit :

https://www.google.com/maps/search/?api=1&query=Sydney+Opera+House&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE&utm_source=YOUR_APP_NAME&utm_campaign=place_details_search