Une fois que vous disposez d'un ID de lieu, vous pouvez demander plus de détails sur un établissement ou point d'intérêt en lançant une Place Details (nouveau) requête. A Place Details (nouveau) renvoie des informations plus complètes sur le lieu indiqué. comme l'adresse complète, le numéro de téléphone, les notes et les avis des visiteurs.
Il existe de nombreuses façons d'obtenir un ID de lieu. Vous pouvez utiliser :
- Text Search (nouvelle version) ou Nearby Search (nouveau)
- API Geocoding
- API Routes
- API Address Validation
- Place Autocomplete
APIs Explorer vous permet d'effectuer des requêtes en direct afin que vous puissiez vous familiariser avec l'API et la Options d'API:
EssayerRequêtes Place Details (New)
Une requête Places Details est une requête HTTP GET au format suivant:
https://places.googleapis.com/v1/places/PLACE_ID
Transmettez tous les paramètres en tant que paramètres d'URL ou dans les en-têtes dans le cadre de la méthode GET. Exemple :
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY
Ou dans une commande cURL:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Réponses Place Details (New)
Place Details (New) renvoie une JSON comme réponse. Dans la réponse :
- La réponse est représentée par
Place
. L'objetPlace
contient des informations détaillées sur le à un emplacement. - Le champ FieldMask transmis dans la requête spécifie la liste des champs.
renvoyées dans l'objet
Place
.
L'objet JSON complet se présente sous la forme suivante:
{ "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g", "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g", "displayName": { "text": "Trinidad" } ... }
Paramètres obligatoires
-
FieldMask
Spécifiez la liste des champs à renvoyer dans la réponse en créant un masque de champ de réponse. Transmettre le masque de champ de réponse à la méthode à l'aide du paramètre d'URL
$fields
oufields
, ou à l'aide de l'en-tête HTTPX-Goog-FieldMask
Il n'existe pas de liste par défaut des champs renvoyés dans la réponse. Si vous omettez le masque de champ, la méthode renvoie une erreur.Le masquage du champ est une bonne pratique de conception pour vous assurer que vous ne demandez pas des données inutiles, ce qui permet d'éviter les délais de traitement et frais facturés.
Spécifiez une liste de types de données de lieu à renvoyer, séparés par une virgule. Par exemple : pour récupérer le nom à afficher et l'adresse du lieu.
X-Goog-FieldMask: displayName,formattedAddress
Utilisez
*
pour récupérer tous les champs.X-Goog-FieldMask: *
Renseignez un ou plusieurs des champs suivants:
Les champs suivants déclenchent le SKU Place Details (IDs Only):
attributions
,id
,name
*,photos
* Le champname
contient le nom de ressource du lieu. au format suivant:places/PLACE_ID
. UtilisezdisplayName
pour accéder au nom textuel du lieu.Les champs suivants déclenchent le SKU Place Details (Location Only):
addressComponents
,adrFormatAddress
,formattedAddress
,location
,plusCode
,shortFormattedAddress
,types
,viewport
Les champs suivants déclenchent le SKU Place Details (Basic):
accessibilityOptions
,businessStatus
,displayName
,googleMapsUri
,iconBackgroundColor
,iconMaskBaseUri
,primaryType
,primaryTypeDisplayName
,subDestinations
,utcOffsetMinutes
Les champs suivants déclenchent le SKU Place Details (Advanced):
currentOpeningHours
,currentSecondaryOpeningHours
,internationalPhoneNumber
,nationalPhoneNumber
,priceLevel
,rating
,regularOpeningHours
,regularSecondaryOpeningHours
,userRatingCount
,websiteUri
Les champs suivants déclenchent le SKU Place Details (Preferred):
allowsDogs
,curbsidePickup
,delivery
,dineIn
,editorialSummary
,evChargeOptions
,fuelOptions
,goodForChildren
,goodForGroups
,goodForWatchingSports
,liveMusic
,menuForChildren
,parkingOptions
,paymentOptions
,outdoorSeating
,reservable
,restroom
,reviews
,servesBeer
,servesBreakfast
,servesBrunch
,servesCocktails
,servesCoffee
,servesDessert
,servesDinner
,servesLunch
,servesVegetarianFood
,servesWine
,takeout
.
-
placeId
Identifiant textuel qui identifie un lieu de façon unique, renvoyé par une Text Search (nouvelle version) ou Nearby Search (nouveau) : Pour en savoir plus sur les ID de lieu, consultez les présentation des ID de lieu.
La chaîne
places/PLACE_ID
est également appelée le lieu nom de ressource. Dans la réponse d'une requête Place Details (New), Nearby Search (nouvelle version) et Text Search (nouvelle version) requête, cette chaîne est contenue dans le champname
de la réponse. Version autonome l'ID de lieu est contenu dans le champid
de la réponse.
Paramètres facultatifs
languageCode
Langue dans laquelle les résultats doivent être renvoyés.
- Consultez le liste des langues acceptées Google met souvent à jour les langages pris en charge, cette liste n'est donc peut-être pas exhaustive.
-
Si
languageCode
n'est pas fourni, l'API est définie par défaut suren
. Si si vous spécifiez un code de langue non valide, l'API renvoie une erreurINVALID_ARGUMENT
. - L'API s'efforce de fournir une adresse postale lisible par à la fois l’utilisateur et les locaux. Pour atteindre cet objectif, la fonction dans la langue locale, transcrites en un script lisible par l'utilisateur si nécessaire, en tenant compte de la langue préférée. Toutes les autres sont renvoyées dans la langue de votre choix. Les composants d'adresse sont tous renvoyés dans la même langue, celle choisie .
- Si un nom n'est pas disponible dans la langue préférée, l'API utilise le la correspondance la plus proche.
- La langue préférée a une petite influence sur l'ensemble des résultats l'API choisit de les renvoyer, ainsi que l'ordre dans lequel ils sont renvoyés. La le geocoder interprète les abréviations différemment selon la langue, comme les abréviations de types de rues ou des synonymes est valide dans une langue, mais pas dans une autre.
regionCode
Code régional utilisé pour mettre en forme la réponse, spécifié sous la forme d'une CLDR à deux caractères. Il n'existe pas de valeur par défaut.
Si le nom de pays du champ
formattedAddress
dans la réponse correspond auregionCode
, le code pays est omis deformattedAddress
. Ce paramètre n'a aucun effet suradrFormatAddress
, qui inclut toujours le pays ou surshortFormattedAddress
, qui ne l'inclut jamais.La plupart des codes CLDR sont identiques aux codes ISO 3166-1, à quelques exceptions près. Par exemple, le ccTLD au Royaume-Uni est "uk" (.co.uk), tandis que son code ISO 3166-1 est "gb". (d'un point de vue technique, du Royaume-Uni de Grande-Bretagne et d'Irlande du Nord). Ce paramètre peut avoir un impact sur les résultats en fonction de la législation applicable.
-
sessionToken
Les jetons de session sont des chaînes générées par l'utilisateur qui suivent la saisie semi-automatique (Nouveau) les appels en tant que "sessions". La saisie semi-automatique (nouveau) utilise des jetons de session pour regrouper les phases de requête et de sélection de lieux d'une recherche avec saisie semi-automatique d'un utilisateur dans une session distincte ; à des fins de facturation. Les jetons de session sont transmis à Place Details (nouveau) qui suivent les appels de saisie semi-automatique (nouveau). Pour en savoir plus, consultez Jetons de session :
Exemple Place Details
L'exemple suivant demande les détails d'un lieu en
placeId
:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Notez que l'en-tête X-Goog-FieldMask
indique que
réponse
contient les champs de données suivants: id,displayName
.
La réponse se présente alors sous la forme suivante:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "displayName": { "text": "Googleplex", "languageCode": "en" } }
Ajoutez d'autres types de données au masque de champ pour renvoyer des informations supplémentaires.
Par exemple, ajoutez formattedAddress,plusCode
pour inclure le
et le Plus Code dans le
réponse:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
La réponse se présente désormais sous la forme suivante:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "plusCode": { "globalCode": "849VCWC7+RW", "compoundCode": "CWC7+RW Mountain View, CA, USA" }, "displayName": { "text": "Googleplex", "languageCode": "en" } }
Essayer
APIs Explorer vous permet de créer des exemples de requêtes afin de vous familiariser avec l'API et ses options.
Pour envoyer une demande:
- Sélectionnez l'icône API
, sur le côté droit de la page.
- Vous pouvez également définir le paramètre
name
sur:places/PLACE_ID
- Vous pouvez également développer Afficher les paramètres standards et définir
Le paramètre
fields
au masque de champ. - Sélectionnez le bouton Execute (Exécuter). Dans la fenêtre pop-up, sélectionnez le compte utiliser pour effectuer la requête.
Dans le panneau APIs Explorer, sélectionnez l'icône de développement,
, pour développer la fenêtre de l'explorateur d'API.