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 et des images mises en forme concernant des établissements, des emplacements géographiques ou des points d'intérêt.Pourquoi utiliser l'API Places (nouvelle version) ?
Créez des fonctionnalités de 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, à jour et complets du monde réel. Voici des exemples de cas d'utilisation pour les applications :
- Afficher des locations d'appartements dans les grandes zones métropolitaines avec des résultats ciblant spécifiquement les villes.
- Inclure des informations sur le lieu dans une mise à jour de l'état d'un retrait ou d'une livraison.
- Afficher une liste de parcs dans une zone, ainsi que des photos et des avis envoyés par les utilisateurs.
- Fournir 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.
Que pouvez-vous faire avec l'API Places (nouvelle version) ?
Vous pouvez utiliser l'API Places (nouvelle version) 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, tels que des saisies de texte, des lieux à proximité et des requêtes utilisateur ambiguës ou catégorielles
- Activer 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.
- Affiner le type d'informations renvoyées sur un lieu, telles que les horaires d'ouverture, un résumé, les avis des utilisateurs et une photo.
- Ajouter 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 manière 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 à partir 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 (nouvelle version) pour demander plus d'informations sur un établissement ou un point d'intérêt particulier, comme son adresse complète, son numéro de téléphone, la note des utilisateurs et les avis.
Fonctionnement de l'API Places (nouvelle version)
L'API Places (nouvelle version) 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.
L'API Places (nouvelle version) est compatible avec l'autorisation par clé API et jeton OAuth.
L'exemple suivant effectue une requête Place Details (nouvelle version) 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
Comment utiliser l'API Places (nouvelle version) ?
Les étapes ci-dessous couvrent un scénario d'utilisation typique du service de l'API Places. Lorsque vous développez votre solution, vous pouvez utiliser des points de terminaison supplémentaires, tels que Nearby Search (nouvelle version) et Place Photos (nouvelle version).| 1 | Configurer vos écouteurs | Configurez la facturation, activez l'API Places (nouvelle version) et effectuez votre première requête. |
| 2 | Essayer une recherche textuelle de base | Effectuez une recherche textuelle à 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 le cadre d'une réponse. Utilisez des ID de lieu pour obtenir des informations sur un lieu (nouvelle version). |
| 4 | Obtenir une photo d'un lieu | Place Photos (nouvelle version) vous donne accès à des millions de photos stockées dans la base de données Places. Utilisez Place Photos (nouvelle version) pour accéder aux photos d'un lieu. |