Pourquoi utiliser l'API Places ?
Créez des fonctionnalités de détection de la position pour que vos utilisateurs aient facilement accès à 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 récents et les plus complets du monde réel. Voici des exemples de cas d'utilisation d'applications:
- Afficher les locations de copropriétés dans les principales zones métropolitaines avec des résultats ciblant spécifiquement les villes.
- Incluez des informations sur le lieu dans les informations sur l'état du retrait ou de la livraison.
- Affichez la liste des parcs d'une zone, ainsi que les photos et les 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 en cours de 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 issus de différents types de requêtes des utilisateurs (saisie de texte, adresses à proximité, requêtes ambiguës ou catégorielles, par exemple).
- 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 affichées sur un lieu (horaires d'ouverture, résumé, avis des utilisateurs et photo, par exemple).
- Ajoutez des photos de haute qualité aux lieux diffusés 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, 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, comme son adresse complète, son numéro de téléphone, les notes des visiteurs et les avis associés.
Choisir votre version de l'API Places
L'API Places est compatible avec deux versions d'API : l'API Places correspond aux API existantes et l'API Places (nouvelle version) est la nouvelle génération des API.
Avec le lancement de l'API Places (nouvelle version), votre première tâche consiste à choisir l'ensemble d'API à utiliser. Cela est vrai si vous êtes un nouveau client ou un client existant qui utilise déjà les API. Utilisez ce guide pour découvrir les principales différences entre les deux API.
Fonctionnement de l'API Places
API Places (New)
L'API Places (nouvelle version) 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 (nouvelle version) accepte les autorisations par clé API et par jeton OAuth.
L'exemple suivant envoie 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, à savoir JSON ou XML. La requête de service utilise des paramètres pertinents pour ce point de terminaison spécifique pour affiner les données renvoyées.
L'exemple suivant exécute une requête Place 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 rechercher 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 | Text Search (nouvelle version) | Il n'existe pas de nouvelle version de Find Place. Text Search (nouvelle version) l'a remplacé. |
| Nearby Search | Nearby Search (nouveau) | Toutes les requêtes utilisant l'API existante qui incluent une requête textuelle doivent utiliser Text Search (nouvelle version), car Nearby Search (nouvelle version) n'accepte pas la saisie de texte. |
| Text Search | Text Search (nouvelle version) | |
| Place Details | Place Details (New) | |
| Place Photo | Place Photo (nouveauté) | |
| Place Autocomplete | Saisie semi-automatique (nouveauté) | |
| Query Autocomplete | Saisie semi-automatique (nouveauté) | Fonctionnalités ajoutées à la saisie semi-automatique (nouveau) |
Utiliser l'API Places
Les étapes ci-dessous couvrent un scénario type d'utilisation 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 (nouvelle version), vous pouvez également utiliser des jetons OAuth. |
| 2 | Effectuer une recherche textuelle simple | Effectuez une recherche textuelle simple à l'aide de Text Search (nouvelle version) ou de Text Search. |
| 3 | Utilisez l'ID de lieu pour en savoir plus | De nombreuses API Google Maps Platform renvoient un ID de lieu dans la réponse. Utilisez l'ID de lieu pour obtenir des informations sur un lieu. Consultez Place Details (nouvelle version) 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 (nouvelle version) ou Place Details pour accéder aux photos d'un lieu. |