Présentation

Sélectionnez une plate-forme : Android iOS JavaScript Services Web
L'API Places est un service qui accepte les requêtes HTTP pour la localisation les données par différentes méthodes. Elle renvoie des données de localisation formatées. des établissements, des emplacements géographiques ou des images les points d'intérêt.

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 outils les plus précis, à jour des modèles de lieux 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 votre applications:

  • Proposez des résultats de recherche de lieux correspondant à différents types de requêtes des utilisateurs : saisie de texte, les emplacements à proximité et les requêtes utilisateur 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 textuelles spécifiques ou catégorielles.
  • Affinez le type d'informations renvoyées sur un lieu (horaires d'ouverture, résumé, des avis d'utilisateurs et une photo.
  • Ajoutez des photos de haute qualité aux lieux diffusés par votre application.

Compatibilité avec de nombreuses API Google Maps Platform ID de lieu, où l'ID de lieu de manière unique identifie 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 un établissement ou un point d'intérêt spécifique, comme son adresse complète, son numéro de téléphone, notes et avis des visiteurs.

Choisir votre version de l'API Places

L'API Places est compatible avec deux versions d'API: L'API Places est la API existantes et API Places (Nouveau) sont les versions nouvelle génération des API.

Avec le lancement de l'API Places (nouvelle version), votre première tâche consiste à choisir ensemble d'API à utiliser. Cela est vrai si vous êtes un nouveau client ou un client existant qui utilisent déjà les API. Utilisez ce guide pour vous familiariser les 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 nom point de terminaison de service, tel que /places ou places:searchText et renvoie une réponse JSON. L'API Places (nouvelle version) est compatible avec les autorisations Clé API et jeton OAuth. L'exemple suivant exécute une requête Places Details pour renvoyer les composants d'adresse d'une 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 nom point de terminaison du service, tel que /place ou /photo. Les points de terminaison acceptent le type de format spécifié dans la requête, JSON ou XML. Le 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 Places Details pour renvoyer les composants d'adresse d'une 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'identifiant 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 le 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) ne prend pas en charge 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 créez votre solution, vous pouvez utiliser d'autres points de terminaison, tels que Nearby Search et Place Photos.
1 Configuration Commencez par Configurer votre votre projet Google Cloud et suivez les instructions de configuration ci-dessous. découvrez comment utiliser votre clé API. Pour l'API Places (nouvelle version), vous pouvez aussi utiliser Jetons OAuth :
2 Effectuer une recherche textuelle simple Effectuez une recherche textuelle simple à l'aide de Text Search (nouvelle version). 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 les 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 permet d'accéder aux millions de photos stockées dans Places. base de données. Utiliser Place Photo (nouvelle version) ou Place Details pour accéder aux photos d'un lieu.