Pourquoi utiliser l'API Places ?
Créez des fonctionnalités de détection de la position pour permettre à vos utilisateurs d'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:
- Affichez les locations de appartements 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.
- afficher la liste des parcs d'une zone donnée, ainsi que des photos et des avis d'utilisateurs ;
- Fournissez aux utilisateurs qui planifient leurs voyages les coordonnées, les avis et les niveaux de prix des établissements proposés sur leur parcours.
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 en fonction de différents types de requêtes d'utilisateurs (saisie de texte, lieux à proximité, requêtes utilisateur ambiguës ou catégorielles, par exemple).
- 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 desservies par votre application.
De nombreuses API Google Maps Platform sont compatibles avec 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, sa note et des 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 (nouvelle version) est les versions 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. 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 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) est compatible avec l'autorisation par clé API et jeton OAuth.
L'exemple suivant exécute 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 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 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 de texte (nouveau) | Il n'existe pas de nouvelle version de Find Place. Text Search (New) l'a remplacé. |
Nearby Search | Nearby Search (nouveauté) | 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 textuelle | Recherche de texte (nouveau) | |
Place Details | Place Details (Nouveau) | |
Place Photo | Place Photo (nouvelle version) | |
Place Autocomplete | Saisie semi-automatique (nouveau) | Dans l'aperçu |
Saisie semi-automatique des requêtes | Saisie semi-automatique (nouveau) | Fonctionnalités ajoutées à la version preview d'Autocomplete (nouveau) |
Utiliser l'API Places
Les étapes ci-dessous correspondent à un scénario d'utilisation typique 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 qui suivent, 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 de texte 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 leur réponse. Utilisez l'ID de lieu pour obtenir des informations sur un lieu. Consultez les pages 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. |