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 de 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 des informations sur un lieu ou de trouver le meilleur itinéraire d'un point A à un point B. Les développeurs peuvent créer leur propre expérience dans l'application, mais 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 une expérience utilisateur fluide. Les URL incorrectes compromettent cette expérience, car elles dirigent les utilisateurs vers le mauvais lieu, affichent une carte générique au lieu d'informations spécifiques, ou même entraînent un lien non fonctionnel. 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 une entreprise spécifique peut être redirigé vers une carte générale sans informations pertinentes. 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 un lieu basé sur la latitude et la longitude. Toutefois, elle ne fournit pas aux utilisateurs d'informations sur un lieu spécifique.
Associer votre application à Google Maps de manière fluide 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(nouvelle version), qui nécessite une clé API, et les URL Maps, qui sont sans frais et ne nécessitent pas de clé. Les solutions suivantes couvrent différents scénarios et cas d'utilisation :
Utiliser le champ googleMapsUri ou googleMapsLinks de l'API Places(nouvelle version) de GMP
L'API Places(nouvelle version) 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 de 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 informations sur le 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"
}
}ChIJ3S-JXmauEmsRUcIaWtf4MzE dans l'exemple ci-dessus est l'ID de lieu de l'opéra de Sydney
dans l'exemple ci-dessus. Un ID de lieu est un identifiant textuel qui
identifie de manière 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 par programmation, vous pouvez utiliser la fonctionnalité API Places: Text Search(ID Only). 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(nouvelle version)
Requête API Places Text Search(ID Only) :
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 API Places Text Search(ID Only) :
{
"places": [
{
"id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
}
]
}Les ID de lieu peuvent également être récupérés lorsqu'un utilisateur clique ou appuie sur un point d'intérêt sur une carte. En savoir plus sur les icônes de points d'intérêt cliquables(JavaScript, Android, iOS)
Implémentation
Lorsque vous utilisez 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 Google Maps sur la page d'informations de ce lieu |
| writeAReviewUri | Lien permettant d'ouvrir Google Maps sur la page de rédaction d'avis pour ce lieu |
| reviewsUri | Lien permettant d'ouvrir Google Maps sur la page d'avis pour ce lieu |
| photosUri | Lien permettant d'ouvrir Google Maps sur la page de photos pour 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 de carte disponibles sont les suivantes :
La fonction de recherche lance une application Google Maps ou un navigateur si l'application n'est pas installée, qui 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 Itinéraire lance une application Google Maps ou un navigateur si l'application n'est pas installée, qui affiche l'itinéraire entre des points ou active la navigation détaillée sur Google Maps pour les appareils mobiles.
La fonction de panorama Street View vous permet de lancer une visionneuse pour afficher des 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 maintenant examiner deux fonctionnalités clés des URL Maps :
Afficher des informations sur un lieu dans Google Maps : cette section explique comment créer des URL qui affichent des informations sur un lieu spécifique dans Google Maps. Elle explique également comment utiliser des lieux dont le nom n'est pas unique à l'aide d' ID de lieu et de requêtes précises.
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 détaillée.
Afficher des informations sur un lieu dans Google Maps
La fonction de recherche utilise deux paramètres pour effectuer la recherche de lieux :
qui 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 des informations sur un lieu dont le nom est unique
https://www.google.com/maps/search/?api=1&query=Sydney%20Opera%20House
Prenons maintenant 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 ? Consultez le scénario suivant.
Scénario 2 : Rechercher des lieux dont le nom n'est pas unique
https://www.google.com/maps/search/?api=1&query=7-Eleven
Étant donné que le nom du lieu n'est pas unique, cette URL ouvre une liste des établissements 7-Eleven à proximité dans la fenêtre d'affichage. Les utilisateurs peuvent ensuite choisir un magasin spécifique pour afficher ses informations.
Pour éviter la liste des lieux 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 des informations sur un lieu dont le nom n'est pas unique
Lorsque vous utilisez des noms de lieux courants, une simple recherche par 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 au format nom du lieu, adresse. Cela
permet d'affiner la recherche et de créer un lien direct vers le lieu souhaité.
Méthode 2 : Utiliser l'ID de 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 obligatoire, mais il ne sera utilisé que si Google
Maps ne trouve pas l'ID de lieu.
Scénario 4 : Afficher des informations sur un lieu à l'aide des coordonnées de latitude et de longitude ainsi que de l'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 lieu sans frais
Pour récupérer des ID de lieu par programmation, 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 lieu. En savoir plus sur l'ID de lieu et la requête Place API(nouvelle version)
Requête API Places Text Search(ID Only) :
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 API Places Text Search(ID Only) :
{
"places": [
{
"id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
}
]
}Les ID de lieu peuvent également être récupérés lorsqu'un utilisateur clique ou appuie sur un point d'intérêt sur une carte. En savoir plus sur les icônes de points d'intérêt cliquables(JavaScript, Android, iOS)
Conclusion
Fournir des informations précises sur les lieux est essentiel pour une expérience positive. Pour vous assurer que les utilisateurs accèdent à la bonne page d'informations sur le lieu, créez les URL de recherche à l'aide de l'un des formats recommandés suivants :
query=PLACE_NAME, ADDRESSquery=PLACE_NAME&query_place_id=PLACE_ID
Évitez d'utiliser uniquement les coordonnées de latitude/longitude dans le query paramètre lorsque
votre objectif est d'afficher les informations d'un lieu spécifique. Les formats tels que
query=latitude,longitude, query=PLACE_NAME,latitude,longitude,
ou query=ADDRESS,latitude,longitude ne mèneront pas toujours à la
page d'informations sur le lieu souhaitée. Au lieu de cela, ils afficheront la latitude et la longitude de
l'emplacement.
Recherche par catégorie à l'aide d'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é 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.
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 d'itinéraire affiche le chemin entre deux points ou plus spécifiés sur la carte, ainsi que la distance et le temps de trajet. Elle offre aux développeurs plus de contrôle sur les itinéraires fournis. La documentation sur les itinéraires des URL Maps de GMP fournit des instructions détaillées sur la création d'URL pour des itinéraires personnalisés.
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 la position actuelle 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 l'itinéraire en voiture depuis la position actuelle de l'utilisateur.
Dans cette URL, origin est omis. Lorsque origin est omis, le chemin est défini par défaut
sur le lieu de départ le plus pertinent, tel que la position de l'appareil, si elle est disponible.
Si ce n'est pas le cas, la carte résultante fournit un formulaire permettant à l'utilisateur de saisir le point de départ.
La valeur du point de départ 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 déplacement.
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é, la carte Google 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 lieu à l'aide du paramètre origin_place_id et
destination_place_id. L'utilisation d'un ID de lieu est la meilleure garantie de créer un lien vers le bon lieu.
Récupérer des ID de lieu sans frais
Pour récupérer des ID de lieu par programmation, 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 lieu. En savoir plus sur l'ID de lieu et la requête Place API(nouvelle version)
Requête API Places Text Search(ID Only) :
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 API Places Text Search(ID Only) :
{
"places": [
{
"id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
}
]
}Les ID de lieu peuvent également être récupérés lorsqu'un utilisateur clique ou appuie sur un point d'intérêt sur une carte. En savoir plus sur les icônes de points d'intérêt cliquables(JavaScript, Android, iOS)
Scénario 3 : Fournir la navigation détaillée
https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving&dir_action=navigate
Définir dir_action=navigate dans l'URL lance Google Maps en mode de navigation détaillé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'affiche.
La navigation détaillée est lancée lorsque dir_action=navigate est défini et que :
- Le point de départ est spécifié et se trouve à proximité de la position actuelle de l'utilisateur.
- Le point de départ est omis et la position actuelle de l'utilisateur est disponible.
L'aperçu de l'itinéraire est lancé lorsque :
dir_action=navigaten'est pas défini.dir_action=navigateest défini et le point de départ est spécifié, mais il ne se trouve pas à proximité de la position actuelle de l'utilisateur.dir_action=navigateest défini et le point de départ est omis, mais la position actuelle de l'utilisateur n'est pas disponible.
Notez que la navigation n'est pas disponible sur tous les produits Google Maps, tels que Google Maps sur le Web, et/ou entre toutes les destinations. Dans ce cas, ce paramètre sera ignoré.
 |
 |
Conclusion
En créant 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 cela est 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 commencera à 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 l'approche adaptée à votre application
Vous disposez de deux options principales : utiliser les URL préformatées fournies par l' API Places ou créer manuellement des URL Maps dans votre application. Chaque approche 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.Offre moins de contrôle sur la configuration des itinéraires. Bien que
googleMapsLinkspropose des itinéraires de base, il n'est pas compatible avec les points de passage ni la personnalisation avancée. De plus, il est relativement moins simple de déclencher directement la navigation détaillée.
URL Maps :
Offre plus de flexibilité et de contrôle. Les développeurs peuvent créer des URL pour afficher des informations sur un lieu et configurer différents aspects des itinéraires, y compris ajouter des points de passage, spécifier des modes de déplacement et lancer la navigation détaillée.
Nécessite une compréhension plus approfondie des paramètres et de la structure de l'URL. La création 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 à
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 schémas d'utilisation et d'améliorer le produit
URL Maps.
Pour le paramètre utm_source, utilisez le nom de votre application. Le
utm_campaign paramètre doit refléter l'action prévue par 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=YourAppName&utm_campaign=place_details_search
L'utilisation cohérente de ces paramètres nous aide à identifier les axes d'amélioration, à résoudre les problèmes plus efficacement et, en fin de compte, à offrir une meilleure expérience à tous les utilisateurs.
Étapes suivantes
Suggestions de lecture supplémentaires :
Contributeurs
Auteurs principaux :
Teresa Qin | Ingénieure de solutions Google Maps Platform