Aperçu

Sélectionnez une plate-forme : Android iOS JavaScript Services Web

Développeurs de l'Espace économique européen (EEE)

Si votre adresse de facturation se trouve dans l'Espace économique européen, les Conditions d'utilisation de Google Maps Platform pour l'EEE s'appliqueront à votre utilisation des Services à compter du 8 juillet 2025. La fonctionnalité varie selon la région. En savoir plus

Introduction

L'API Places est un service qui accepte les requêtes HTTP de données de localisation via différentes méthodes. Elle renvoie des données de localisation formatées et des images concernant des établissements, des emplacements géographiques ou des points d'intérêt.

Remarque  : Google Maps Platform propose des versions distinctes de la bibliothèque Places pour Android, iOS et JavaScript. Nous vous recommandons d'utiliser la version de la bibliothèque Places spécifique à votre plate-forme. Autrement dit, si vous développez une application Android, vous devez utiliser la version Android de Places.

Pourquoi utiliser l'API Places (nouvelle version) ?

Créez des fonctionnalités basées sur la localisation pour mettre des données de localisation détaillées à la disposition de vos utilisateurs. Les données disponibles via l'API Places (nouvelle version) sont basées sur l'un des modèles de lieux les plus précis, les plus à jour et les plus complets du monde réel. Voici des exemples de cas d'utilisation pour les applications :

• Affichez des locations de condos dans les grandes agglomérations, avec des résultats ciblant spécifiquement les villes.
• Incluez les détails du lieu dans une mise à jour de l'état de la commande à retirer ou à livrer.
• Affichez une liste de parcs dans une zone, ainsi que des photos et des avis envoyés par les utilisateurs.
• Fournissez aux personnes qui planifient des voyages des coordonnées, des avis et des niveaux de prix pour les établissements situés sur leur itinéraire.

Remarque : L'API Places (nouveau) est la version actuelle. L'API Places est désormais une ancienne API et ne peut plus être activée. Les anciens guides de documentation et de migration sont disponibles dans l'onglet Anciens.

Que pouvez-vous faire avec l'API Places (nouvelle version) ?

Vous pouvez utiliser l'API Places (nouveau) pour inclure les fonctionnalités suivantes dans vos applications :

• Fournir des résultats de recherche de lieux à partir de différents types de requêtes utilisateur, telles que des saisies de texte, des lieux à proximité et des requêtes utilisateur ambiguës ou catégorielles.
• Activez les fonctionnalités de saisie semi-automatique pour différents types de recherche, qu'il s'agisse de requêtes textuelles spécifiques ou de requêtes catégorielles.
• Affinez le type d'informations renvoyées sur un lieu, comme les horaires d'ouverture, un résumé, les avis des utilisateurs et une photo.
• Ajoutez des photos de haute qualité aux lieux desservis par votre application.

De nombreuses API Google Maps Platform sont compatibles avec les ID de lieu, qui identifient de façon unique un lieu dans la base de données Google Places et sur Google Maps. Il existe de nombreuses façons d'obtenir un ID de lieu, y compris à partir de l'API Places (nouvelle version), mais aussi de l'API Geocoding, de l'API Routes et de l'API Address Validation.

Une fois que vous disposez d'un ID de lieu, vous pouvez utiliser l'API Places (New) pour demander plus d'informations sur un établissement ou un point d'intérêt spécifique, comme son adresse complète, son numéro de téléphone, sa note et ses avis.

Fonctionnement de l'API Places (nouvelle version)

L'API Places (nouveau) accepte les requêtes sous forme d'URL standard avec un point de terminaison de service spécifique, tel que /places ou places:searchText, et renvoie une réponse JSON. La nouvelle API Places est compatible avec l'autorisation par clé API et jeton OAuth. L'exemple suivant effectue une requête Place Details (New) pour renvoyer les composants d'adresse d'un ID de lieu à l'aide d'une clé API :

https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents&key=YOUR_API_KEY

Utiliser l'API Places (nouvelle version)

Les étapes ci-dessous couvrent un scénario d'utilisation typique du service Places API. À mesure que vous développez votre solution, vous pouvez utiliser des points de terminaison supplémentaires, tels que Nearby Search (New) et Place Photos (New).

1	Configurer	Configurez la facturation, activez l'API Places (nouveau) et envoyez votre première requête.
2	Essayer une recherche textuelle de base	Effectuez une recherche de texte à l'aide de Text Search (nouvelle version).
3	Utiliser l'ID de lieu pour obtenir plus d'informations	De nombreuses API Google Maps Platform renvoient un ID de lieu dans une réponse. Utilisez des identifiants de lieu pour obtenir des informations détaillées sur un lieu (nouveau).
4	Obtenir une photo d'un lieu	Place Photos (nouveau) vous donne accès à des millions de photos stockées dans la base de données Places. Utilisez Photos de lieux (nouveau) pour accéder aux photos d'un lieu.