Pourquoi utiliser l'API Places ?
Créez des fonctionnalités de détection de la position afin de fournir facilement des données de localisation détaillées à vos utilisateurs. Les données disponibles via l'API Places sont basées sur l'un des modèles de lieu les plus précis, les plus récents et les plus complets du monde réel. Voici des exemples de cas d'utilisation pour les applications:
- Affichez des locations de copropriétés dans les principales zones métropolitaines avec des résultats ciblant spécifiquement les villes.
- Incluez les détails du lieu dans une mise à jour de l'état du retrait ou de la livraison.
- Affichez la liste des parcs d'une zone spécifique, ainsi que des photos et des avis envoyés par les utilisateurs.
- Fournissez aux personnes qui planifient un voyage les coordonnées, les avis et les niveaux de prix des établissements qui les intéressent.
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 d'utilisateurs, telles que la saisie de texte, les lieux à proximité et les requêtes utilisateur ambiguës ou par catégorie.
- 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 par catégorie.
- Affinez le type d'informations renvoyées sur un lieu (horaires d'ouverture, résumé, avis d'utilisateurs, photo, etc.).
- Ajoutez des photos de haute qualité aux lieux servis par votre application.
De nombreuses API Google Maps Platform acceptent les ID de lieu, qui permettent d'identifier 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, 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 de détails sur un établissement ou un point d'intérêt particulier, tels que son adresse complète, son numéro de téléphone, la note des visiteurs et les avis.
Choisir votre version de l'API Places
L'API Places est compatible avec deux versions d'API : les API Places sont les API existantes et l'API Places (Nouveau) correspond aux versions nouvelle génération des API.
Avec le lancement de l'API Places (nouveau), votre première tâche consiste à décider quel ensemble d'API utiliser. Cela est vrai si vous êtes un nouveau client ou un client existant qui utilise déjà les API. Consultez ce guide pour découvrir les principales différences entre les deux API.
Fonctionnement de l'API Places
API Places (New)
L'API Places (Nouveau) accepte les requêtes en tant qu'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 (Nouveau) accepte l'autorisation par clé API et par jeton OAuth.
L'exemple suivant effectue une requête Places Details 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
API Places
L'API Places accepte les requêtes sous la forme d'une URL standard avec un point de terminaison de service spécifique, tel que /place ou /photo. Les points de terminaison acceptent également le type de format spécifié dans la requête (JSON ou XML). La demande de service utilise des paramètres pertinents pour ce point de terminaison spécifique afin d'affiner les données renvoyées.
L'exemple suivant effectue une requête Places Details pour renvoyer les composants d'adresse d'un ID de lieu au format JSON:
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
Dans ce cas, le service utilise l'ID de lieu fourni pour trouver le lieu demandé et renvoyer les composants d'adresse au format JSON.
Ressources
Le tableau suivant récapitule les ressources disponibles via l'API Places.
| API Places | API Places (New) | Remarque |
|---|---|---|
| Find Place | Recherche textuelle (nouveau) | Il n'existe pas de nouvelle version de Find Place. Text Search (Nouveau) l'a remplacé. |
| Recherche à proximité | Recherche à proximité (nouveau) | Toutes les requêtes utilisant l'API existante qui incluent une requête textuelle doivent utiliser Text Search (New) (Recherche de texte (Nouveau)), car Nearby Search (New) n'est pas compatible avec la saisie de texte. |
| Recherche textuelle | Recherche textuelle (nouveau) | |
| Place Details | Place Details (nouveau) | |
| Place Photo | Place Photo (nouveau) | |
| Place Autocomplete | Aucune version (nouvelle) de l'API Places | |
| Saisie semi-automatique des requêtes | Aucune version (nouvelle) de l'API Places |
Utiliser l'API Places
Les étapes ci-dessous correspondent à un scénario d'utilisation type du service de l'API Places. Au fur et à mesure que vous développez votre solution, vous pouvez utiliser des points de terminaison supplémentaires, tels que Nearby Search et Place Photos.| 1 | Configuration | Commencez par Configurer votre projet Google Cloud, suivez les instructions de configuration ci-dessous, puis découvrez comment utiliser votre clé API. Pour l'API Places (Nouveau), vous pouvez également utiliser des jetons OAuth. |
| 2 | Essayer une recherche textuelle simple | Lancez une recherche textuelle simple à l'aide de Recherche de texte (Nouveau) ou Recherche de texte. |
| 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 l'ID de lieu pour obtenir des informations sur un lieu. Consultez les pages Place Details (Nouveau) et Place Details. |
| 4 | Obtenir une photo d'un lieu | Le service Place Photo vous donne accès à des millions de photos stockées dans la base de données Places. Utilisez Place Photo (New) ou Place Details pour accéder aux photos d'un lieu. |