Dans le monde actuel où la localisation est omniprésente, les utilisateurs s'attendent à accéder facilement aux informations sur les lieux, aux itinéraires et à la navigation. Que ce soit dans une application de messagerie, une application de découverte du contexte local, une plate-forme de logistique et de transport, un planificateur de voyage ou une plate-forme d'annonces immobilières, les utilisateurs ont souvent besoin de consulter rapidement les détails d'un lieu ou de trouver le meilleur itinéraire d'un point A à un point B. Bien que les développeurs puissent créer leur propre expérience dans l'application, l'utilisation de l'interface complète et familière de Google Maps offre une expérience supérieure.
Une URL Google Maps bien structurée est essentielle pour offrir une expérience utilisateur fluide. Les URL incorrectes compromettent cette expérience, car elles redirigent les utilisateurs vers le mauvais emplacement, affichent une vue de carte générique au lieu de détails spécifiques ou même entraînent un lien rompu. Cela frustre les utilisateurs et les empêche d'atteindre leur objectif. Par exemple, même avec une URL Maps valide, un utilisateur qui s'attend à obtenir des informations sur un établissement spécifique peut être redirigé vers une vue générale de la carte sans aucune information pertinente. Exemple :
https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152
Cette URL Maps est valide pour ouvrir Google Maps et afficher une position en fonction de la latitude et de la longitude. Toutefois, il ne fournit pas aux utilisateurs d'informations sur un lieu spécifique.
Faire le lien entre votre application et Google Maps grâce à des URL précises
Google Maps Platform (GMP) propose deux méthodes principales pour créer des URL précises : l'API Places(nouveau), qui nécessite une clé API, et les URL Maps, qui sont sans frais et ne nécessitent pas de clé. Les solutions suivantes répondent à différents scénarios et cas d'utilisation :
Utiliser le champ googleMapsUri ou googleMapsLinks de l'API Places(nouveau) de GMP
La nouvelle API Places de GMP renvoie un ensemble complet d'informations sur un lieu spécifique. Lorsque vous demandez le champ googleMapsUri ou googleMapsLinks (en le spécifiant dans le masque de champ), la réponse de l'API inclut un objet lieu.
Cet objet contient des URL préformatées qui peuvent être utilisées pour ouvrir directement la vue correspondante, telle que la vue des détails du lieu, dans Google Maps.
Exemple :
Requête Place Details
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: YOUR_API_KEY" \ -H "X-Goog-FieldMask: googleMapsUri,googleMapsLinks" \ https://places.googleapis.com/v1/places/ChIJ3S-JXmauEmsRUcIaWtf4MzE
Réponse Place Details :
{
"googleMapsUri": "https://maps.google.com/?cid=3545450935484072529",
"googleMapsLinks": {
"directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!3e0",
"placeUri": "https://maps.google.com/?cid=3545450935484072529",
"writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!12e1",
"reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!9m1!1b1",
"photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!10e5"
}
}Dans l'exemple ci-dessus, ChIJ3S-JXmauEmsRUcIaWtf4MzE correspond à l'ID du lieu de l'opéra de Sydney. Un ID de lieu est un identifiant textuel qui identifie de façon unique un lieu dans la base de données Google Places et sur Google Maps.
Récupérer des ID de lieu sans frais
Pour récupérer des ID de lieu de manière programmatique, vous pouvez utiliser la fonctionnalité Places API : Text Search(ID Only). Il s'agit d'une méthode sans frais pour obtenir des ID de lieux. En savoir plus sur l'ID de lieu et sur la requête Place API(New)
Requête Places API Text Search(ID uniquement) :
curl -X POST -d '{"textQuery" : "Sydney Opera House"}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'Réponse de l'API Places Text Search(ID uniquement) :
{
"places": [
{
"id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
}
]
}Les ID de lieu peuvent également être récupérés lorsqu'un utilisateur clique ou appuie sur un POI sur les cartes. En savoir plus sur les icônes de POI cliquables(JavaScript, Android, iOS)
Implémentation
Lorsqu'ils utilisent l'API Places, les développeurs peuvent simplement extraire le champ googleMapsUri ou googleMapsLinks de la réponse et l'utiliser pour lancer la vue correspondante dans l'application Google Maps ou dans un navigateur si l'application n'est pas installée.
| Fonctionnalité | Description |
|---|---|
| directionsUri | Lien permettant d'ouvrir Google Maps pour afficher l'itinéraire de la position actuelle de l'utilisateur vers ce lieu |
| placeUri | Lien permettant d'ouvrir la page d'informations de ce lieu dans Google Maps |
| writeAReviewUri | Lien permettant d'ouvrir la page Google Maps pour rédiger un avis sur ce lieu |
| reviewsUri | Lien permettant d'ouvrir la page Google Maps des avis sur ce lieu |
| photosUri | Lien permettant d'ouvrir la page Google Maps des photos de ce lieu |
Consultez les conseils pour les développeurs et essayez la fonctionnalité dès aujourd'hui.
Utiliser les URL Maps
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 de clé API Google pour utiliser les URL Maps.
Les actions disponibles sur la carte sont les suivantes :
La fonction de recherche lance une application Google Maps ou un navigateur si l'application n'est pas installée. Elle affiche un repère pour un lieu spécifique ou effectue une recherche générale et lance une carte pour afficher les résultats.
La fonction d'itinéraire lance une application Google Maps ou un navigateur si l'application n'est pas installée. Elle affiche l'itinéraire entre des points ou permet la navigation détaillée sur Google Maps pour les appareils mobiles.
La fonction de panorama Street View vous permet de lancer un lecteur pour afficher les images Street View sous forme de panoramas interactifs.
Consultez la documentation pour les développeurs sur les URL Maps de GMP pour découvrir d'autres fonctions et exemples.
Nous allons à présent examiner deux fonctionnalités clés des URL Maps :
Afficher les détails d'un lieu sur Google Maps : cette section explique comment créer des URL qui affichent les détails d'un lieu spécifique sur Google Maps. Il explique également comment utiliser les ID de lieu et les requêtes précises pour travailler avec des lieux dont le nom n'est pas unique.
Fournir des itinéraires à l'aide d'URL Maps : cette section explique comment créer des URL qui fournissent des itinéraires entre des lieux, y compris des itinéraires avec plusieurs points de passage et la navigation guidée.
Afficher les détails d'un lieu sur Google Maps
La fonction de recherche prend deux paramètres pour effectuer la recherche de lieux : query(obligatoire) et query_place_id(facultatif).
Le paramètre query est obligatoire pour toutes les requêtes de recherche. Il accepte un nom de lieu, des coordonnées de latitude/longitude séparées par une virgule ou un terme de recherche général.
Structure de l'URL de recherche :
https://www.google.com/maps/search/?api=1¶meters
Scénario 1 : Afficher les détails d'un lieu à partir d'un nom unique
https://www.google.com/maps/search/?api=1&query=Sydney%20Opera%20House
Prenons maintenant l'exemple d'un lieu dont le nom n'est pas unique. Que se passe-t-il lorsque vous effectuez une recherche uniquement par ce nom non unique ? Voir le scénario suivant.
Scénario 2 : Rechercher des lieux avec un nom non unique
https://www.google.com/maps/search/?api=1&query=7-Eleven
Comme le nom du lieu n'est pas unique, cette URL ouvre une liste des magasins 7-Eleven à proximité dans la fenêtre d'affichage. Les utilisateurs peuvent ensuite sélectionner un magasin spécifique pour en afficher les détails.
Pour éviter la liste des établissements et accéder directement à une page d'informations spécifique, vous pouvez utiliser une méthode plus précise. Consultez l'exemple suivant.
Scénario 3 : Afficher les détails d'un lieu dont le nom n'est pas unique
Lorsqu'il s'agit de noms de lieux courants, une simple recherche de nom renvoie souvent une liste de lieux. Pour créer un lien direct vers une page d'informations spécifique, vous pouvez utiliser l'une des méthodes suivantes :
Méthode 1 : Utiliser une requête précise avec le nom et l'adresse du lieu
https://www.google.com/maps/search/?api=1&query=7-Eleven%2C37%20Swanston%20St%2C%20Melbourne%20Australia
Dans cette URL, le paramètre query est formaté sous la forme "nom du lieu, adresse". Cela permet d'affiner la recherche et de rediriger directement vers l'emplacement souhaité.
Méthode 2 : Utiliser l'identifiant du lieu
Les ID de lieu identifient de façon unique un lieu dans la base de données Google Places et sur Google Maps.
https://www.google.com/maps/search/?api=1&query=7-Elevan&query_place_id=ChIJGcmcg7ZC1moRAOacd3HoEwM
Ici, ChIJGcmcg7ZC1moRAOacd3HoEwM est l'ID de lieu unique pour le lieu spécifique. Le paramètre query est toujours requis, mais ne sera utilisé que si Google Maps ne parvient pas à trouver l'identifiant de lieu.
Scénario 4 : Afficher les détails d'un lieu à l'aide de ses coordonnées de latitude et de longitude, ainsi que de son ID de lieu
L'utilisation de l'ID de lieu permet à Google Maps d'afficher des informations détaillées sur le lieu.
https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE
Récupérer des ID de lieux sans frais
Pour récupérer des ID de lieux de manière programmatique, vous pouvez utiliser la fonctionnalité Places API : Text Search(ID uniquement). Il s'agit d'une méthode sans frais pour obtenir des ID de lieu. En savoir plus sur l'ID de lieu et la requête Place API(New)
Requête Places API Text Search(ID uniquement) :
curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'Réponse de l'API Places Text Search(ID uniquement) :
{
"places": [
{
"id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
}
]
}Les ID de lieu peuvent également être récupérés lorsqu'un utilisateur clique ou appuie sur un POI sur les cartes. En savoir plus sur les icônes de POI cliquables(JavaScript, Android, iOS)
Conclusion
Il est essentiel de fournir des informations précises sur les lieux pour offrir une expérience positive. Pour vous assurer que les utilisateurs accèdent à la page de détails du lieu appropriée, créez les URL de recherche en utilisant l'un des formats recommandés suivants :
query=PLACE_NAME, ADDRESSquery=PLACE_NAME&query_place_id=PLACE_ID
Évitez d'utiliser uniquement des coordonnées de latitude/longitude dans le paramètre query lorsque votre objectif est d'afficher les détails d'un lieu spécifique. Les formats tels que query=latitude,longitude, query=PLACE_NAME,latitude,longitude ou query=ADDRESS,latitude,longitude ne permettent pas d'accéder de manière cohérente à la page d'informations sur le lieu souhaitée. À la place, la latitude et la longitude de l'établissement s'affichent.
Recherche par catégorie à l'aide des URL Maps
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é de l'emplacement que vous spécifiez. Si aucun lieu n'est spécifié, Google Maps tente de trouver des fiches à proximité de votre position actuelle.
Scénario 1 : Recherche de lieux à proximité
https://www.google.com/maps/search/?api=1&query=Cafe%20near%20Sydney%20Opera%20House%20that%20are%20open%20now
Fournir des itinéraires à l'aide d'URL Maps
La fonction Itinéraire affiche le chemin entre deux points ou plus spécifiés sur la carte, ainsi que la distance et la durée du trajet. Elle offre aux développeurs plus de contrôle sur les itinéraires fournis. La documentation URL Maps de GMP : instructions fournit des instructions détaillées sur la création d'URL pour des instructions personnalisées.
Structure de l'URL d'itinéraire :
https://www.google.com/maps/dir/?api=1¶meters
Scénario 1 : Trouver le meilleur itinéraire de l'emplacement actuel de l'utilisateur vers une destination
https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving
Cette URL ouvre Google Maps et affiche un itinéraire depuis la position actuelle de l'utilisateur.
Dans cette URL, origin est omis. Lorsque origin est omis, le chemin d'accès est défini par défaut sur l'emplacement de départ le plus pertinent, tel que la position de l'appareil, si elle est disponible.
Si aucune n'est trouvée, la carte résultante fournit un formulaire permettant à l'utilisateur de saisir l'origine.
La valeur de l'origine et de la destination peut être un nom de lieu, une adresse ou des coordonnées de latitude/longitude séparées par une virgule.
travelmode est un paramètre facultatif. Il définit le mode de transport.
Ce paramètre peut être défini comme suit :
- conduite
- marche
- vélo
- deux-roues
- transit
Si aucun mode de déplacement 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.
Les développeurs peuvent également spécifier des ID de lieux à l'aide du paramètre origin_place_id et de destination_place_id. Utiliser un ID de lieu est le meilleur moyen de vous assurer de créer un lien vers le bon lieu.
Récupérer des ID de lieux sans frais
Pour récupérer des ID de lieux de manière programmatique, vous pouvez utiliser la fonctionnalité Places API : Text Search(ID uniquement). Il s'agit d'une méthode sans frais pour obtenir des ID de lieu. En savoir plus sur l'ID de lieu et la requête Place API(New)
Requête Places API Text Search(ID uniquement) :
curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'Réponse de l'API Places Text Search(ID uniquement) :
{
"places": [
{
"id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
}
]
}Les ID de lieu peuvent également être récupérés lorsqu'un utilisateur clique ou appuie sur un POI sur les cartes. En savoir plus sur les icônes de POI cliquables(JavaScript, Android, iOS)
Scénario 3 : Fournir une navigation détaillée
https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving&dir_action=navigate
Si vous définissez dir_action=navigate dans l'URL, Google Maps se lancera en mode navigation guidée si la position actuelle de l'utilisateur(position de l'appareil) est disponible et utilisée comme point de départ (fournie explicitement ou utilisée implicitement lorsque le paramètre d'origine est omis). Sinon, un aperçu de l'itinéraire s'affichera.
La navigation détaillée est lancée lorsque dir_action=navigate est défini et :
- L'origine est spécifiée et proche de la position actuelle de l'utilisateur.
- L'origine est omise et la position actuelle de l'utilisateur est disponible.
L'aperçu de l'itinéraire est lancé dans les cas suivants :
dir_action=navigaten'est pas définidir_action=navigateest défini et l'origine est spécifiée, mais elle n'est pas proche de la position actuelle de l'utilisateur.dir_action=navigateest défini et l'origine est omise, et la position actuelle de l'utilisateur n'est pas disponible.
Notez que la navigation n'est pas disponible sur tous les produits Google Maps, comme Google Maps sur le Web, ni entre toutes les destinations. Dans ce cas, ce paramètre sera ignoré.
 |
 |
Conclusion
En construisant correctement les URL Maps, vous pouvez vous assurer que les utilisateurs obtiennent rapidement et efficacement les informations dont ils ont besoin.
Spécifiez toujours la destination et utilisez l'ID de lieu chaque fois que possible pour garantir la précision.
Lorsque l'objectif est de fournir une navigation immédiate, incluez le paramètre dir_action=navigate pour déclencher la navigation détaillée. La navigation commence à partir de la position actuelle de l'utilisateur si la position de l'appareil est disponible et utilisée comme point de départ (définie explicitement ou omise).
Choisir la bonne approche pour votre application
Vous avez deux options principales : utiliser les URL préformatées fournies par l'API Places ou créer manuellement des URL Maps dans votre application. Chacune présente ses propres avantages et inconvénients.
API Places :
Les champs
googleMapsUrietgoogleMapsLinksde la réponse Place Details fournissent des URL prêtes à l'emploi. Cela réduit le temps de développement et minimise le risque d'erreurs dans le formatage des URL.Vous avez moins de contrôle sur la configuration des itinéraires.
googleMapsLinkspropose des itinéraires de base, mais n'est pas compatible avec les points de cheminement ni la personnalisation avancée. De plus, il est relativement moins simple de déclencher directement la navigation guidée.
URL Maps :
Offre plus de flexibilité et de contrôle. Les développeurs peuvent créer des URL pour afficher les détails d'un lieu et configurer différents aspects des itinéraires, y compris ajouter des points de passage, spécifier des modes de transport et lancer la navigation guidée.
Nécessite une compréhension approfondie des paramètres et de la structure des URL. La construction manuelle augmente le risque d'erreurs si elle n'est pas effectuée avec soin.
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 habitudes d'utilisation et d'améliorer le produit URL Maps.
Pour le paramètre utm_source, utilisez le nom de votre application. Le paramètre utm_campaign doit refléter l'action souhaitée par l'utilisateur, comme "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=YourAppName&utm_campaign=place_details_search
L'utilisation cohérente de ces paramètres nous aide à identifier les points à améliorer, à résoudre les problèmes plus efficacement et, en fin de compte, à offrir une meilleure expérience à tous les utilisateurs.
Étapes suivantes
Lectures complémentaires suggérées :
Contributeurs
Auteurs principaux :
Teresa Qin | Ingénieure des solutions Google Maps Platform