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.
Choisir votre version de l'API Places
L'API Places est compatible avec deux versions : les API Places sont les API existantes, et les API Places (nouvelles) sont les versions de nouvelle génération.
Avec la sortie de l'API Places (nouvelle), 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. 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 (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 envoie une requête Place 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, soit JSON, soit 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 effectue 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 cet exemple, 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 (nouvelle) | 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 et incluant une requête textuelle doivent utiliser Text Search (New), car Nearby Search (New) n'est pas compatible avec la saisie de texte. |
| Recherche dans le texte | Recherche textuelle (nouvelle) | |
| Informations sur le lieu | Informations sur un lieu (nouvelle version) | |
| Placer une photo | Placer une photo (nouveau) | |
| Place Autocomplete | Saisie semi-automatique (nouvelle version) | |
| Saisie semi-automatique des requêtes | Saisie semi-automatique (nouvelle version) | Fonctionnalités ajoutées à la saisie semi-automatique (nouvelle) |
Utiliser l'API Places
Les étapes ci-dessous décrivent un cas d'utilisation classique 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 et Place Photos.| 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. Pour l'API Places (nouvelle), vous pouvez également utiliser des jetons OAuth. |
| 2 | Essayer une recherche de texte de base | Effectuez une recherche de texte à l'aide de Text Search (New) (Recherche de texte (nouvelle version)) ou de Text Search (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 Place Details (New) (Détails du lieu (nouveau)) et Place Details (Détails du lieu). |
| 4 | Obtenir une photo d'un lieu | Le service Place Photo vous permet d'accéder aux millions de photos stockées dans la base de données Places. Utilisez Photo de lieu (nouvelle) ou Informations sur le lieu pour accéder aux photos d'un lieu. |