Vue d'ensemble

Sélectionnez une plate-forme: Android iOS JavaScript Service Web
L'API Places est un service qui accepte les requêtes HTTP pour les données de localisation via diverses méthodes. Elle renvoie des données de localisation mises en forme et des images sur des établissements, des emplacements géographiques ou des points d'intérêt importants.

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.