Une version plus récente de ce document est disponible. Elle contient des exemples d'utilisation des nouvelles API Places et Routes.
En général, lorsqu'un utilisateur se rend en voiture à un point d'intérêt, il a en fait besoin d'un itinéraire vers un lieu à proximité, comme un parking ou un point d'accès. Imaginez un chauffeur qui doit se rendre à l'aéroport ou dans un centre commercial. Lorsque vous vous rendez à l'aéroport, le chauffeur essaie d'atteindre un terminal ou un point de dépose 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 avec une voiture. Dans ce cas, lorsque vous développez une application ou un service pour guider le conducteur, commencez par trouver le lieu où il se rend, puis proposez-lui des destinations facultatives à proximité. Cette approche vous permet de fournir un meilleur service à vos clients et de leur montrer que vous accordez de l'importance à leur temps, grâce à un effort de développement petit mais intelligent qui exploite les données de localisation fournies par Google Maps Platform.
Vue simplifiée des systèmes impliqués lorsque le conducteur est guidé vers un lieu en voiture

Nous vous montrerons comment utiliser les API Places et Directions de manière séquentielle ou combinée pour identifier le bon emplacement de stationnement à proximité de votre destination. Cette solution vise à éliminer l'incertitude et les interactions multiples pour trouver une place de parking une fois plus près de la destination finale. Examinons en détail deux exemples d'implémentation de ces cas.
Exemple 1 : une attraction touristique sans parking
Choisissons un lieu qui n'est pas directement relié à 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 station à environ 16 minutes au nord de Notre-Dame. Notre-Dame est une célèbre attraction touristique située sur une île accessible par un pont. Certaines rues sont à sens unique et il n'y a pas de grand parking à proximité. Ce sera donc un défi intéressant.
Requête de l'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, "YOUR_KEY" correspond à la clé API que vous avez pour les API Places et Directions de Google Maps Platform activées dans la console Google Cloud. Pour obtenir 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 de demander automatiquement au conducteur "Vous cherchez un parking près de Notre-Dame ?". L'expérience utilisateur varie en fonction de l'appareil et de l'écran, mais un pop-up discret qui disparaît au bout de quelques secondes peut être une option à envisager dans ce cas. Pour trouver un parking à proximité de Notre-Dame, effectuez une recherche textuelle dans l'API Places en définissant les paramètres de type sur "parking" et de rayon sur "300". Cet exemple biaisera les résultats vers les zones de stationnement situées à 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" aux coordonnées 48.850591, 2.3486436. Utilisons cet emplacement dans la partie suivante, où nous allons effectuer une requête Directions API.
Requête de l'API Directions
Pour trouver l'itinéraire de la gare à un parking proche de Notre-Dame, vous devez envoyer une requête à l'API Directions. Il vous suffit de définir les paramètres d'origine et de destination. Pour en savoir plus, consultez la documentation pour les 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 "tronçons", qui contiennent eux-mêmes plusieurs "étapes" indiquant la distance parcourue et les coordonnées. Pour trouver les coordonnées finales accessibles en voiture, utilisez le champ "end_location" de la dernière étape de la dernière section d'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 à quelques minutes à pied de Notre-Dame, environ six à sept minutes.

Itinéraire à pied du parking à Notre-Dame
Récapitulatif pour l'exemple 1
Comme vous pouvez le voir, trouver une place de 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 à chercher une place de parking dans un lieu touristique bondé ni à faire le tour du pâté de maisons pour trouver une place. En résumé, nous avons effectué les requêtes d'API suivantes :
- Requête API Places pour trouver les coordonnées de Notre-Dame
- Requête de l'API Places pour trouver une aire de stationnement à moins de 300 mètres de ces coordonnées
- Requête de l'API Directions pour trouver un itinéraire vers le parking
Exemple 2 : Guider un utilisateur vers un terminal dans un grand aéroport

"types" : [ "airport", "point_of_interest", "establishment" ],
Cependant, quiconque a visité un grand aéroport sait qu'il faut beaucoup de temps pour se rendre d'un terminal à un autre si vous arrivez au mauvais endroit. Dans ce cas, étant donné que le type de résultat de recherche est "aéroport", il est utile de faire automatiquement une recherche complémentaire sur "terminal" en utilisant 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 une 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 identifiant de lieu :
"place_id" : "ChIJtQRd6XVxdkgRTUGZtcsoGNc",
En utilisant le 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 ainsi que les coordonnées de latitude et de longitude des lieux de destination (51.47079979999999,-0.4896765).

Récapitulatif de l'exemple 2
Comme dans l'exemple précédent, l'effort de développement pour fournir de meilleurs conseils au conducteur est très faible et les avantages en termes de temps gagné pour le conducteur sont facilement mesurables. Nous avons effectué les demandes 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 d'Heathrow
- Requête 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 voyageant en voiture est plutôt faible et vous permet de montrer facilement que vous pensez aux 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 destinés à vos clients. Consultez notre dépôt GitHub public pour la plate-forme Google Maps.
Actions suivantes
- Navigation de l'extérieur vers l'intérieur
- Créer une fonctionnalité de validation de la localisation avec Google Maps
Auteur principal
Mikko Toivanen | Ingénieur de solutions Google Maps Platform