Pourquoi utiliser l'API Places ?
Créez des fonctionnalités basées sur la position pour faciliter l'accès à vos données de localisation. Les données disponibles via l'API Places reposent sur l'un des modèles de lieu réels les plus précis, les plus complets et les plus récents. Voici des exemples de cas d'utilisation pour les applications:
- Affichez des copropriétés dans les grandes zones métropolitaines avec des résultats ciblés sur les villes.
- Incluez les détails sur le lieu dans une notification sur l'état du retrait ou de la livraison.
- Affichez la liste des parcs dans une zone ainsi que les photos et les avis des utilisateurs.
- Fournissez des coordonnées, des avis et des niveaux de prix aux établissements qui planifient leurs trajets.
Que pouvez-vous faire avec l'API Places ?
Vous pouvez utiliser l'API Places pour inclure les fonctionnalités suivantes dans vos applications:
- fournir des résultats de recherche de lieu pour différents types de requêtes d'utilisateur, comme des requêtes de texte, des lieux à proximité, et des requêtes ambiguës ou catégorielles ;
- Activez les fonctionnalités de saisie semi-automatique pour différents types de recherche, qu'il s'agisse de requêtes de texte spécifiques ou catégorielles.
- Affiner le type de détails renvoyés 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 de diffusion de votre application.
Fonctionnement de l'API Places
L'API Places accepte les requêtes en tant qu'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. Enfin, la requête de service utilise les paramètres pertinents pour ce point de terminaison spécifique afin d'affiner les données renvoyées.
Par exemple, la requête Place Details suivante pour les composants d'adresse fonctionne comme suit, en supposant un retour 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 et les données renvoyées.
Ressources de données | Données renvoyées | Format renvoyé |
---|---|---|
Place Search | Affiche une liste de lieux en fonction de la position de l'appareil ou d'une chaîne de recherche.
Consultez les informations pour les réponses à la recherche de lieux, les réponses de recherche à proximité et les réponses de recherche textuelle. |
|
Place Details | Affiche des informations plus détaillées sur un lieu spécifique, y compris des avis d'utilisateurs.
Pour en savoir plus, consultez la section Réponses Place Details. |
|
Placer des photos | Permet d'accéder aux millions de photos d'un lieu stockées dans la base de données Google Adresses.
Consultez les détails de la réponse Place Photos. |
|
Placer la saisie semi-automatique | Saisie automatique du nom et/ou de l'adresse d'un lieu au fur et à mesure de la saisie.
Pour en savoir plus, consultez la section Réponses de la saisie semi-automatique Place. |
|
Saisie semi-automatique des requêtes | Fournit un service de prédiction de requêtes pour les recherches géographiques textuelles, en affichant des suggestions de requêtes lors de la saisie.
Pour en savoir plus, consultez la section Réponses de la saisie semi-automatique des requêtes. |
|
Utiliser l'API Places
Les étapes ci-dessous couvrent un cas d'utilisation type pour l'utilisation de trois des points de terminaison dans le service de l'API Places. Lorsque vous créez votre solution, vous pouvez utiliser des points de terminaison supplémentaires, tels que Nearby Search, Place Photos et Query Autocomplete.1 | Configuration | Commencez par configurer votre projet Google Cloud et suivez les instructions de configuration ci-dessous, puis découvrez comment utiliser votre clé API. |
2 | Effectuer une recherche textuelle simple | Une fois que vous disposez d'une clé API, effectuez une simple recherche de texte, comme indiqué dans les exemples de recherche de texte de base du guide Recherche de texte. |
3 | Utiliser une requête Find Place | Les requêtes Find Place renvoient un ID de lieu, ainsi que des champs de données que vous demandez, comme les horaires d'ouverture, l'adresse et des photos. Consultez des exemples Find Place et essayez-en un plus adapté à votre cas d'utilisation. |
4 | Comprendre les principes de base de la réponse Find Place | Explorer les données renvoyées par la réponse Find Place Pour en savoir plus, consultez Rechercher des réponses de lieux. |
5 | Utiliser l'ID de lieu pour en savoir plus | Les réponses Find Place ne fournissent pas toutes les données disponibles pour un lieu spécifique. Vous pouvez utiliser l'ID de lieu renvoyé par une réponse Find Place pour obtenir plus d'informations sur un lieu. Consultez Place Details. |
Bibliothèques clientes disponibles
Appelez cette API dans le langage de votre choix via l'une des bibliothèques clientes suivantes:
- Client Java pour les services Google Maps
- Client Python pour les services Google Maps
- Client Go pour les services Google Maps
- Client Node.js pour les services Google Maps
Les clients Java, Python, Go et Node.js pour les services Google Maps sont des bibliothèques clientes alimentées par la communauté, disponibles en Open Source sous la licence Apache 2.0. Téléchargez-les sur GitHub, où vous trouverez également des instructions d'installation et un exemple de code.
Étapes suivantes
- Pour effectuer une recherche dans l'API Places: accédez à Place Search.
- Obtenir une clé API: consultez la page Utiliser des clés API.