Pourquoi utiliser l'API Places ?
Créez des fonctionnalités de détection de la position pour que vos utilisateurs puissent accéder facilement à 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 lieu 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:
- Proposez des locations de copropriétés dans les principales zones métropolitaines, avec des résultats ciblant spécifiquement les villes.
- Incluez des détails sur le 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 les photos et avis ajoutés par les utilisateurs.
- Fournissez aux personnes qui planifient des voyages les coordonnées, les avis et les niveaux de prix des établissements sur votre route.
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 utilisateur ambiguës ou par catégorie.
- Activez les fonctionnalités de saisie semi-automatique pour différents types de recherche (requêtes textuelles spécifiques ou requêtes par catégorie).
- Affinez le type d'informations renvoyées sur un lieu (horaires d'ouverture, résumé, avis des utilisateurs, photo, etc.).
- Ajoutez des photos de haute qualité aux lieux couverts par votre application.
De nombreuses API Google Maps Platform acceptent 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 : via l'API Places, l'API Geocoding, l'API Routes et 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, les notes 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 existantes et l'API Places (Nouveau), les 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 (nouveau)
L'API Places (Nouveau) 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 (Nouveau) est compatible avec l'autorisation par clé API et par jeton OAuth.
L'exemple suivant exécute une requête Places Details pour renvoyer les composants d'adresse pour 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 requête 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 exécute 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 (nouveau) | Remarque |
|---|---|---|
| Find Place | Text Search (nouveau) | Il n'existe pas de nouvelle version de Find Place. Text Search (Nouveau) l'a remplacée. |
| Recherche à proximité | Nearby Search (nouveau) | Toutes les requêtes utilisant l'API existante qui incluent une requête textuelle doivent utiliser Text Search (New), car Nearby Search (New) n'est pas compatible avec la saisie de texte. |
| Recherche de texte | Text Search (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 couvrent un cas 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 et suivez les instructions de configuration qui suivent, puis découvrez comment utiliser votre clé API. Pour l'API Places (Nouveau), vous pouvez également utiliser des jetons OAuth. |
| 2 | Essayer une recherche de texte simple | Émettez une recherche de texte simple à l'aide de Text Search (Nouveau) ou Text Search. |
| 3 | Utiliser l'ID de lieu pour en savoir plus | De nombreuses API Google Maps Platform renvoient un ID de lieu dans leur réponse. Utilisez l'ID de lieu pour obtenir des informations sur un lieu. Consultez Place Details (New) et Place Details. |
| 4 | Obtenir la 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. |