Il existe une nouvelle version de ce document, qui contient des exemples d'utilisation de la nouvelle API Places et de l'API Routes.
En général, lorsqu'un utilisateur se rend en voiture à un point d'intérêt (POI), il a besoin d'accéder à un lieu à proximité, comme un parking ou un point d'accès. Imaginons un conducteur qui doit se rendre à un aéroport ou à un centre commercial. Lorsqu'il se rend à un aéroport, le conducteur essaie d'atteindre un terminal ou un point de dépôt plutôt que le centre de l'aéroport. De même, un parking à côté du centre commercial peut être une bien meilleure option pour un utilisateur disposant d'une voiture. Dans ce cas, lorsque vous développez une application ou un service pour guider le conducteur, commencez par trouver l'endroit où il se rend, puis proposez-lui des destinations facultatives à proximité de cet endroit. Cette approche vous permet de fournir un meilleur service à vos clients et de montrer que vous tenez compte de leur temps, avec un effort de développement limité mais intelligent qui exploite les données de localisation fournies par Google Maps Platform.
Nous allons vous montrer comment utiliser l'API Places et l'API Directions de manière séquentielle ou combinée pour identifier le bon emplacement où vous garer à proximité de votre destination. Cette solution vise à éliminer l'incertitude et les multiples interactions pour trouver une place de parking pendant la conduite, une fois que vous vous approchez de la destination finale. Examinons deux exemples d'implémentation détaillée de ces cas.
Exemple 1 : une attraction touristique sans parking
Choisissons un emplacement qui n'est pas directement connecté au bord de la route afin qu'un itinéraire doive être récupéré séparément. La destination est Notre-Dame à Paris et comme point de départ, utilisons la gare Gare de l'Est (48.87697775149635, 2.3592247806755564).
Le chauffeur quitte la gare à environ 16 minutes au nord de Notre-Dame. Notre-Dame est une attraction touristique célèbre située sur une île accessible par un pont, avec des rues à sens unique et aucun grand parking à proximité. Ce défi devrait donc être intéressant.
Requête API Places
Cet exemple de requête de l'API Places utilise la recherche de texte pour trouver Notre-Dame. Pour en savoir plus, consultez la documentation pour les développeurs. Dans ces exemples, "VOTRE_CLE" correspond à la clé API que vous possédez pour les API Places et Directions de Google Maps Platform activées dans la console Google Cloud. Pour une explication plus détaillée, consultez la documentation sur les premiers pas avec Google Maps Platform.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=notre_dame&location=48.864716%2C2.349014®ion=fr&key=YOUR_KEY
La réponse à la requête ci-dessus fournit les coordonnées de latitude et de longitude suivantes:
"results" : [ { "formatted_address" : "Notre Dame, Paris", "geometry" : { "location" : { "lat" : 48.8527288, }, ...
Comme vous pouvez le voir, les coordonnées indiquent bien Notre-Dame.
|
|
En tant que développeur ou fournisseur de services, il est judicieux d'inviter automatiquement le conducteur à répondre à la question "Cherchez-vous un parking près de Notre-Dame ?". L'expérience utilisateur sera différente selon l'appareil et l'écran, mais un pop-up subtil qui disparaît au bout d'un court laps de temps peut être envisagé dans ce cas. Pour trouver un parking à proximité de Notre-Dame, effectuez une recherche textuelle avec l'API Places en définissant les paramètres de type "parking" et de rayon "300". Cet exemple biaisera les résultats vers les parkings situés à moins de 300 mètres de Notre-Dame.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=parking
&location=48.8527288%2C2.3505635®ion=fr&type=parking&radius=300&key=YOUR_KEY
Le premier résultat est "Parking Saemes Maubert-Lagrange", situé aux coordonnées 48.850591, 2.3486436. Utilisons cet emplacement dans la partie suivante, où nous allons effectuer une requête API Directions.
Requête de l'API Directions
Pour trouver l'itinéraire entre la gare et un parking à proximité de Notre-Dame, vous devez effectuer une requête API Directions. Il vous suffit de définir les paramètres d'origine et de destination. Pour en savoir plus, consultez la documentation destinée aux développeurs.
https://maps.googleapis.com/maps/api/directions/json?origin=48.8767903,2.3592251&destination=48.850591%2C2.3486436&key=YOUR_KEY
La réponse de l'API Directions contient généralement plusieurs suggestions d'itinéraires. Chaque itinéraire se compose de plusieurs "étapes", qui contiennent plusieurs "étapes" indiquant la distance et les coordonnées du trajet. Pour trouver les coordonnées finales accessibles en voiture, utilisez le champ "end_location" de la dernière étape d'un dernier trajet dans un itinéraire que vous avez sélectionné.
Cet emplacement peut sembler ne pas être le premier choix, mais lorsque vous regardez la carte ou Google Street View, vous constaterez qu'il se trouve à une très courte distance à pied, environ 6 à 7 minutes, de Notre-Dame.
Itinéraire à pied depuis le parking jusqu'à Notre-Dame
Résumé de l'exemple 1
Comme vous pouvez le constater, trouver un parking pour une voiture ne nécessite que quelques appels d'API et l'affichage de la suggestion au conducteur. Cela permet à vos utilisateurs de gagner du temps, car ils n'ont pas à circuler dans des rues à sens unique ni à chercher un endroit où garer leur voiture dans une attraction touristique bondée. En résumé, nous avons effectué les requêtes d'API suivantes:
- Requête de l'API Places pour trouver les coordonnées de Notre-Dame
- Requête de l'API Places pour trouver un parking à moins de 300 mètres de ces coordonnées
- Requête envoyée à l'API Directions pour trouver un itinéraire vers le parking
Exemple 2 : Guider vers un terminal dans un grand aéroport
"types" : [ "airport", "point_of_interest", "establishment" ],
Toutefois, toute personne ayant déjà visité un grand aéroport sait qu'il faut un temps considérable pour passer d'un terminal à un autre si vous vous trompez de terminal. Dans ce cas, comme le type du résultat de recherche est "aéroport", il est utile de suivre automatiquement la requête pour rechercher "terminal" à l'aide de l'emplacement de l'aéroport de Londres Heathrow (51,47016927594547, -0,45432767852489075). Dans l'exemple, vous pouvez également voir la limitation facultative du rayon de recherche à 3 000 mètres.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=terminal&location=51.47016927594547%2C-0.45432767852489075®ion=gb&key=YOUR_KEY&radius=3000
La requête ci-dessus nous donne la liste des terminaux et des points de dépôt individuels de ces terminaux. Dans la liste des résultats, nous trouvons "London Heathrow Airport Terminal 5" et son ID de lieu:
"place_id" : "ChIJtQRd6XVxdkgRTUGZtcsoGNc",
À l'aide du paramètre "place_id", nous pouvons indiquer à l'API Directions que nous essayons d'atteindre un lieu plutôt que des coordonnées arbitraires.
https://maps.googleapis.com/maps/api/directions/json?origin=51.557263604707224,-0.2794575145680608&destination=place_id:ChIJtQRd6XVxdkgRTUGZtcsoGNc&key=YOUR_KEY
Comme dans l'exemple précédent, en lisant toutes les étapes de la réponse JSON, vous trouverez la dernière partie du trajet et les coordonnées de latitude et de longitude des emplacements de fin (51.47079979999999,-0.4896765).
Récapitulatif de l'exemple 2
Comme dans l'exemple précédent, l'effort de développement pour fournir des conseils améliorés au conducteur est très faible, et les avantages en termes de temps gagnés pour le conducteur sont facilement mesurables. Nous avons effectué les requêtes suivantes:
- Requête API Places pour trouver l'aéroport d'Heathrow
- Requête de l'API Places pour trouver tous les terminaux à proximité des coordonnées de l'aéroport Heathrow
- Requête de l'API Directions pour obtenir un itinéraire vers le terminal 5
Conclusion
Comme vous pouvez le constater, l'effort de développement requis pour fournir un service premium à vos clients qui se déplacent en voiture est plutôt faible et vous permet de démontrer facilement comment vous tenez compte des besoins de vos clients.
À des fins de développement, vous pouvez utiliser de nombreuses bibliothèques et outils disponibles pour vous aider à créer les services pour vos clients. Consultez notre dépôt GitHub public pour Google Maps Platform.
Étapes suivantes
- Navigation extérieure à intérieure
- Créer une fonctionnalité de validation de position avec Google Maps
Auteur principal
Mikko Toivanen | Ingénieur Solutions Google Maps Platform