Pourquoi utiliser l'API Places ?
Créez des fonctionnalités basées sur la position pour mettre à la disposition de vos utilisateurs des données de localisation détaillées. Les données disponibles via l'API Places sont basées sur l'un des modèles de lieux les plus précis, à jour et complets du monde réel. Voici quelques exemples de cas d'utilisation pour les applications:
- Afficher des locations de condos dans les grandes métropoles avec des résultats ciblés spécifiquement sur les villes
- Incluez des informations sur le lieu dans une mise à jour de l'état de la collecte ou de la livraison.
- Afficher 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 les coordonnées, les avis et les niveaux de prix des établissements situés sur leur itinéraire.
Que pouvez-vous faire avec l'API Places ?
Vous pouvez utiliser l'API Places pour inclure les fonctionnalités suivantes dans vos applications:
- Fournissez des résultats de recherche de lieux à partir de différents types de requêtes utilisateur, telles que la saisie de texte, les établissements à proximité et les requêtes ambiguës ou catégoriques.
- Activez les fonctionnalités de saisie semi-automatique pour différents types de recherche, que ce soit des requêtes textuelles spécifiques ou des requêtes par catégorie.
- affiner le type d'informations renvoyées sur un lieu, comme les horaires d'ouverture, un résumé, des avis d'utilisateurs et une photo ;
- Ajoutez des photos de haute qualité aux lieux desservis par votre application.
De nombreuses API Google Maps Platform acceptent 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, 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 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, sa note et ses avis.
Fonctionnement de l'API Places (nouvelle version)
L'API Places (nouvelle) accepte les requêtes sous la forme d'une 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) 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
Les étapes ci-dessous décrivent un cas d'utilisation type de l'API Places. Lorsque vous développez votre solution, vous pouvez utiliser des points de terminaison supplémentaires, tels que Nearby Search (New) et Place Photo (New).| 1 | Configuration | Commencez par Configurer votre projet Google Cloud, puis suivez les instructions de configuration qui suivent. Découvrez ensuite comment utiliser votre clé API. |
| 2 | Essayer une recherche de texte de base | Lancez une recherche textuelle à l'aide de Text Search (nouvelle version). |
| 3 | Utiliser l'ID de lieu pour en savoir plus | De nombreuses API Google Maps Platform renvoient un ID de lieu dans une réponse. Utilisez des ID de lieu pour obtenir des informations sur un lieu (nouveau). |
| 4 | Obtenir une photo d'un lieu | Le service Place Photo (nouveau) vous donne accès à des millions de photos stockées dans la base de données Places. Utilisez Ajouter une photo (nouveau) pour accéder aux photos d'un lieu. |