Introduction
Une fois que vous disposez d'un ID de lieu, vous pouvez demander plus d'informations sur un établissement ou un point d'intérêt particulier en envoyant une requête Place Details (New). Une requête Place Details (New) renvoie des informations plus complètes sur le lieu indiqué, comme son adresse complète, son numéro de téléphone, ainsi que les avis et notes des visiteurs.
Il existe de nombreuses façons d'obtenir un ID de lieu. Voici ce que vous pouvez utiliser :
- Text Search (New) ou Nearby Search (New)
- API Geocoding
- API Routes
- API Address Validation
- Autocomplete (New)
APIs Explorer vous permet d'effectuer des requêtes en direct afin de vous familiariser avec l'API et ses options :
Requêtes Place Details (New)
Une requête Place Details (New) 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 de la requête GET. Exemple :
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEYOu 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 un objet JSON en réponse. Dans la réponse :
- La réponse est représentée par un objet
Place. L'objetPlacecontient des informations détaillées sur le lieu. - Le FieldMask transmis dans la requête spécifie la liste des champs renvoyés dans l'objet
Place.
L'objet JSON complet est au format suivant :
{ "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. Transmettez le masque de champ de réponse à la méthode à l'aide du paramètre d'URL
$fieldsoufields, ou 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 de champ est une bonne pratique à appliquer pour vous assurer de ne pas demander de données inutiles. Vous pourrez ainsi réduire le temps de traitement et les 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: *
Spécifiez un ou plusieurs des champs suivants :
Les champs suivants déclenchent le SKU Place Details Essentials IDs Only :
attributions
consumerAlert
id
movedPlace
movedPlaceId
name*
photos
* Le champ
nameinclut le nom de ressource du lieu dans le formulaire :places/PLACE_ID. Pour obtenir le nom textuel du lieu, demandez le champdisplayNamedans le SKU Pro.Pour obtenir la liste complète des champs et de leurs SKU associés, consultez Champs de données de lieu (New).
Les champs suivants déclenchent le SKU Place Details Essentials :
addressComponents
addressDescriptor*
adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport
* Les descripteurs d'adresse sont en disponibilité générale pour les clients en Inde et sont expérimentaux ailleurs.
Pour obtenir la liste complète des champs et de leurs SKU associés, consultez Champs de données de lieu (New).
Les champs suivants déclenchent le SKU Place Details Pro :
accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks
googleMapsTypeLabel
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
openingDate
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
timeZone
utcOffsetMinutes
Pour obtenir la liste complète des champs et de leurs SKU associés, consultez Champs de données de lieu (New).
Les champs suivants déclenchent le SKU Place Details Enterprise :
currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
transitStation
userRatingCount
websiteUriPour obtenir la liste complète des champs et de leurs SKU associés, consultez Champs de données de lieu (New).
Les champs suivants déclenchent le SKU Place Details Enterprise + Atmosphere :
allowsDogs
curbsidePickup
delivery
dineIn
editorialSummary
evChargeAmenitySummary
evChargeOptions
fuelOptions
generativeSummary
goodForChildren
goodForGroups
goodForWatchingSports
liveMusic
menuForChildren
neighborhoodSummary
parkingOptions
paymentOptions
outdoorSeating
reservable
restroom
reviews
reviewSummary
routingSummaries*
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
* Text Search et Nearby Search uniquementPour obtenir la liste complète des champs et de leurs SKU associés, consultez Champs de données de lieu (New).
-
placeId
Identifiant textuel qui identifie un lieu de manière unique, renvoyé par une requête Text Search (New) ou Nearby Search (New). Pour en savoir plus sur les ID de lieu, consultez la présentation des ID de lieu.
La chaîne
places/PLACE_IDest également appelée nom de ressource du lieu. Dans la réponse d'une requête Place Details (New), Nearby Search (New) et Text Search (New), cette chaîne est contenue dans le champnamede la réponse. L'ID de lieu autonome est contenu dans le champidde la réponse.
Paramètres facultatifs
languageCode
Langue dans laquelle les résultats doivent être renvoyés.
- Consultez la liste des langues acceptées. Google met souvent à jour les langues acceptées. Cette liste n'est donc pas exhaustive.
-
Si
languageCoden'est pas fourni, l'API utilise par défauten. 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 à la fois pour l'utilisateur et les habitants. Pour atteindre cet objectif, elle renvoie les adresses postales dans la langue locale, translittérées dans un script lisible par l'utilisateur si nécessaire, en respectant la langue préférée. Toutes les autres adresses sont renvoyées dans la langue préférée. Les composants d'adresse sont tous renvoyés dans la même langue, qui est choisie à partir du premier composant.
- Si aucun nom n'est disponible dans la langue préférée, l'API utilise la correspondance la plus proche.
- La langue préférée a une légère influence sur l'ensemble des résultats que l'API choisit de renvoyer et l'ordre dans lequel ils sont renvoyés. Le geocoder interprète les abréviations différemment selon la langue, par exemple les abréviations des types de rues ou les synonymes qui peuvent être valides dans une langue, mais pas dans une autre.
regionCode
Code de région utilisé pour mettre en forme la réponse, spécifié sous la forme d'un code CLDR à deux caractères. Il n'existe pas de valeur par défaut.
Si le nom du pays du champ
formattedAddressde la réponse correspond àregionCode, le code pays est omis deformattedAddress. Ce paramètre n'a aucun effet suradrFormatAddress, qui inclut toujours le nom du pays, ni 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 du Royaume-Uni est "uk" (.co.uk), tandis que son code ISO 3166-1 est "gb" (techniquement pour l'entité "Royaume-Uni de Grande-Bretagne et d'Irlande du Nord"). Le paramètre peut affecter 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 les appels Autocomplete (New) en tant que "sessions". Autocomplete (New) utilise des jetons de session pour regrouper les phases de requête et de sélection de lieu d'une recherche de saisie semi-automatique d'un utilisateur dans une session distincte à des fins de facturation. Les jetons de session sont transmis aux appels Place Details (New) qui suivent les appels Autocomplete (New). Pour en savoir plus, consultez Jetons de session.
Exemple de Place Details (New)
L'exemple suivant demande les détails d'un lieu par 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 spécifie que la 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 l'adresse et le Plus Code dans la 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" } }
Obtenir les notes, le nombre d'avis et les avis
Pour récupérer la note moyenne d'un établissement, le nombre total de notes (nombre total d'avis) ou le texte des avis clients, incluez les champs correspondants dans l'en-tête X-Goog-FieldMask :
ratingetuserRatingCount: renvoient la note moyenne du lieu (de1.0à5.0) et le nombre total d'avis. La demande de ces champs déclenche le SKU Place Details Enterprise.reviewsetreviewSummary: renvoient jusqu'à cinq objetsReviewenvoyés par l'utilisateur et un résumé des avis généré par l'IA. La demande de ces champs déclenche le SKU Place Details Enterprise + Atmosphere.
Si votre application n'a besoin que de la note et du nombre total d'avis, demandez rating et userRatingCount sans reviews pour que la requête reste dans le niveau SKU Place Details Enterprise :
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,rating,userRatingCount" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Pour récupérer également jusqu'à cinq objets Review envoyés par l'utilisateur, ajoutez reviews au masque de champ (facturé au niveau du SKU Place Details Enterprise + Atmosphere) :
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,rating,userRatingCount,reviews" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
La réponse inclut la note, le nombre total de notes et le tableau reviews :
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "displayName": { "text": "Googleplex", "languageCode": "en" }, "rating": 4.2, "userRatingCount": 2594, "reviews": [ { "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/...", "relativePublishTimeDescription": "a month ago", "rating": 5, "text": { "text": "Iconic tech campus with visitor areas and cafes.", "languageCode": "en" }, "authorAttribution": { "displayName": "Alex Rivera" } } ] }
Obtenir des descripteurs d'adresse
Les descripteurs d'adresse fournissent des informations relationnelles sur l'emplacement d'un lieu, y compris les points de repère à proximité et les zones environnantes.
L'exemple suivant montre une requête Place Details (New) pour un grand magasin dans un centre commercial de San José. Dans cet exemple, vous incluez addressDescriptors dans le masque de champ :
curl -X GET https://places.googleapis.com/v1/places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4 \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: name,displayName,addressDescriptor"
La réponse inclut le lieu spécifié dans la requête, une liste des points de repère à proximité et leur distance par rapport au lieu, ainsi qu'une liste des zones et leur relation de confinement avec le lieu :
{ "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4", "displayName": { "text": "Macy's", "languageCode": "en" }, "addressDescriptor": { "landmarks": [ { "name": "places/ChIJVVVVUB7Lj4ARXyb4HFVDV8s", "placeId": "ChIJVVVVUB7Lj4ARXyb4HFVDV8s", "displayName": { "text": "Westfield Valley Fair", "languageCode": "en" }, "types": [ "clothing_store", "department_store", "establishment", "food", "movie_theater", "point_of_interest", "restaurant", "shoe_store", "shopping_mall", "store" ], "spatialRelationship": "WITHIN", "straightLineDistanceMeters": 220.29175 }, { "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4", "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4", "displayName": { "text": "Nordstrom", "languageCode": "en" }, "types": [ "clothing_store", "department_store", "establishment", "point_of_interest", "shoe_store", "store" ], "straightLineDistanceMeters": 329.45178 }, { "name": "places/ChIJmx1c5x7Lj4ARJXJy_CU_JbE", "placeId": "ChIJmx1c5x7Lj4ARJXJy_CU_JbE", "displayName": { "text": "Monroe Parking Garage", "languageCode": "en" }, "types": [ "establishment", "parking", "point_of_interest" ], "straightLineDistanceMeters": 227.05153 }, { "name": "places/ChIJxcwBziHLj4ARUQLAvtzkRCM", "placeId": "ChIJxcwBziHLj4ARUQLAvtzkRCM", "displayName": { "text": "Studios Inn by Daiwa Living California Inc.", "languageCode": "en" }, "types": [ "establishment", "lodging", "point_of_interest", "real_estate_agency" ], "straightLineDistanceMeters": 299.9955 }, { "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI", "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI", "displayName": { "text": "Din Tai Fung", "languageCode": "en" }, "types": [ "establishment", "food", "point_of_interest", "restaurant" ], "straightLineDistanceMeters": 157.70943 } ], "areas": [ { "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI", "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI", "displayName": { "text": "Westfield Valley Fair", "languageCode": "en" }, "containment": "WITHIN" }, { "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q", "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q", "displayName": { "text": "Valley Fair", "languageCode": "en" }, "containment": "WITHIN" }, { "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM", "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM", "displayName": { "text": "Central San Jose", "languageCode": "en" }, "containment": "WITHIN" } ] } }
Obtenir des détails sur un lieu déplacé
Si un lieu référencé dans votre application a été déplacé, vous pouvez utiliser les champs movedPlace et movedPlaceId pour obtenir les détails du nouveau lieu.
Pour les lieux fermés définitivement, Place Details (New) renvoie CLOSED_PERMANENTLY dans le champ businessStatus et omet les champs movedPlace et movedPlaceId dans le corps de la réponse.
Pour les lieux qui ont changé d'adresse, Place Details (New) renvoie CLOSED_PERMANENTLY dans le champ businessStatus et la nouvelle adresse dans les champs movedPlace et movedPlaceId du corps de la réponse.
Pour les lieux qui n'ont pas été déplacés, Place Details (New) ne renvoie pas movedPlace ni movedPlaceId dans le corps de la réponse.
L'exemple suivant demande des informations sur le lieu "Marche IGA St-Canut" au Québec (Canada) :
curl -X GET -H 'Content-Type: application/json' \ -H 'x-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: id,displayName,businessStatus,movedPlace,movedPlaceId' \ https://places.googleapis.com/v1/places/ChIJUfQdGInVzkwRzAjmjzWB7CQ
La requête renvoie la réponse suivante :
{ "id": "ChIJUfQdGInVzkwRzAjmjzWB7CQ", "businessStatus": "CLOSED_PERMANENTLY", "displayName": { "text": "Marche IGA St-Canut", "languageCode": "en" }, "movedPlace": "places/ChIJ36QT7n8qz0wRDqVZ_UBlUlQ", "movedPlaceId": "ChIJ36QT7n8qz0wRDqVZ_UBlUlQ" }
Pour demander des détails sur le nouveau lieu, utilisez le nom de la ressource Place dans le champ movedPlace d'une nouvelle requête Place Details (New).
Pour les lieux qui ont changé d'adresse plusieurs fois, l'obtention d'informations sur l'emplacement actuel peut nécessiter plusieurs requêtes Place Details (New) enchaînées. Les champs movedPlace et movedPlaceId d'un résultat de lieu pointent uniquement vers l'emplacement suivant, et non vers le dernier emplacement connu. Un lieu se trouve à son emplacement actuel si une requête Place Details (New) omet les champs movedPlace et movedPlaceId dans le corps de la réponse.
Trouver des établissements qui ouvriront prochainement
Vous pouvez demander des informations sur les établissements qui devraient ouvrir à l'avenir.
Nearby Search (New) renseignera le champ openingDate si la date d'ouverture prévue inclut au moins le mois et est inférieure à 90 jours.
L'exemple suivant montre une requête Nearby Search (New) pour un établissement qui ouvrira prochainement à New Meadows, dans l'Idaho :
curl -X GET \ -H "Content-Type: application/json" \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,businessStatus,openingDate" \ "https://places.googleapis.com/v1/places/ChIJp1-VoKWJplQRMz8g-7Wa3Do"
La réponse inclut l'état de l'établissement et la date d'ouverture prévue :
{ "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do", "businessStatus": "FUTURE_OPENING", "openingDate": { "year": 2026, "month": 4, "day": 15 } }
Obtenir des informations sur les arrêts de transports en commun
Vous pouvez utiliser Place Details (New) pour obtenir des informations sur les stations de transports en commun. Le corps de la réponse inclut des informations sur la station, y compris son nom, les agences de transports en commun affiliées et les lignes de transports en commun qui la desservent. De plus, la réponse inclut une icône de véhicule et des couleurs que vous pouvez utiliser pour afficher les informations sur la station de transports en commun.
L'exemple suivant montre une requête d'informations sur la station de transports en commun Grand Central Station :
curl -X GET \ -H "Content-Type: application/json" \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,transitStation" \ "https://places.googleapis.com/v1/places/ChIJLVaKiQFZwokRgcybX3K6Pzg"
Le corps de la réponse inclut des informations sur chaque station dans le rayon, les lignes desservies par la station, les alertes émises par les agences de transports en commun à cet arrêt et les informations de départ :
{ "id": "ChIJLVaKiQFZwokRgcybX3K6Pzg", "displayName": { "text": "Grand Central", "languageCode": "en" }, "transitStation": { "displayName": { "text": "Grand Central", "languageCode": "en" }, "agencies": [ { "displayName": { "text": "MTA New York City Transit", "languageCode": "en" }, "url": "http://www.mta.info/", "lines": [ { "id": "ChIJ420yFwBZwokR903kVZLSsFc", "vehicleType": "SUBWAY", "displayName": { "text": "42 St Shuttle", "languageCode": "en" }, "shortDisplayName": { "text": "S", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#808183", "url": "https://www.mta.info/schedules/subway/42-st-shuttle", "icon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/S.svg", "nameIncluded": true }, "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg" } }, { "id": "ChIJDdd_uEdfwokRHbLvWrdBdDM", "vehicleType": "SUBWAY", "displayName": { "text": "5 Train (Lexington Av Express)", "languageCode": "en" }, "shortDisplayName": { "text": "5 Line", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#00933C", "url": "https://www.mta.info/schedules/subway/5-train", "icon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/5.svg", "nameIncluded": true }, "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg" } } ... ] }, { "displayName": { "text": "MTA", "languageCode": "en" }, "url": "https://new.mta.info/", "lines": [ { "id": "ChIJcwVpzKpZwokR24EBeh8arww", "vehicleType": "BUS", "displayName": { "text": "United Nations - W 42 St Pier", "languageCode": "en" }, "shortDisplayName": { "text": "M42", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#1D59B3", "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg" } } ] }, { "displayName": { "text": "Long Island Rail Road", "languageCode": "en" }, "url": "http://www.mta.info/lirr", "lines": [ { "id": "ChIJv9m8uWM56IkRUcVBQ6Q_In0", "vehicleType": "HEAVY_RAIL", "displayName": { "text": "Ronkonkoma Branch", "languageCode": "en" }, "shortDisplayName": { "text": "LIRR", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#A626AA", "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/rail2.svg" } } ... ] } ], "stops": [ { "id": "ChIJRcemlf1YwokRhFqqw5jKBFM", "stopCode": { "text": "GCT" }, "location": { "latitude": 40.755161, "longitude": -73.975456 }, "wheelchairAccessibleEntrance": true }, { "id": "ChIJ57l2zANZwokRD1pyhuwpfKY", "signageText": { "text": "34 St-Hudson Yards & Main St-Flushing, Queens, 7", "languageCode": "en" }, "location": { "latitude": 40.750983, "longitude": -73.9750686 }, "wheelchairAccessibleEntrance": true }, { "id": "ChIJoVXJgQFZwokR1yzq_WVuEuc", "displayName": { "text": "E 42 St/Park Av", "languageCode": "en" }, "location": { "latitude": 40.7518199, "longitude": -73.9771918 }, "wheelchairAccessibleEntrance": true } ... ] } }
Obtenir les entrées et les points de navigation
Vous pouvez demander des entrées et des points de navigation pour une destination. Les entrées définissent les points d'entrée et de sortie d'un lieu (par exemple, les différentes portes d'un aéroport ou d'un centre commercial). Les points de navigation définissent les emplacements en bord de route où la navigation doit se terminer. Cela est utile pour diriger les utilisateurs vers le bon côté de la route ou un point de dépose spécifique.
Les points de navigation renvoient un navigationPointToken. Vous pouvez transmettre ce jeton au SDK Navigation (disponible pour Android ou iOS) ou à l'API Routes pour guider les conducteurs vers cet emplacement spécifique. Pour en savoir plus, consultez Jetons de point de navigation.
L'exemple suivant demande des détails sur l'aéroport international de San Francisco (ID de lieu ChIJVVVVVYx3j4ARP-3NGldc8qQ), y compris entrances et navigationPoints dans le masque de champ :
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,entrances,navigationPoints" \ https://places.googleapis.com/v1/places/ChIJVVVVVYx3j4ARP-3NGldc8qQ
La réponse inclut les entrées et les points de navigation du lieu :
{ "id": "ChIJVVVVVYx3j4ARP-3NGldc8qQ", "displayName": { "text": "San Francisco International Airport", "languageCode": "en" }, "entrances": [ { "location": { "latitude": 37.6172154, "longitude": -122.3839724 } }, { "location": { "latitude": 37.6174073, "longitude": -122.384196 } }, ... ], "navigationPoints": [ { "navigationPointToken": "ChIJoioBjMLOQkAR0A3yH_eYXsA...", "displayName": { "text": "International Terminal Departures Level", "languageCode": "en" }, "location": { "latitude": 37.6153121, "longitude": -122.3900833 }, "travelModes": ["WALK"] }, { "navigationPointToken": "ChIJy5JKws_OQkAROx0jNN2YXsA...", "displayName": { "text": "Domestic Garage - SFO Short Term Parking", "languageCode": "en" }, "location": { "latitude": 37.6157153, "longitude": -122.3885012 }, "travelModes": ["DRIVE", "WALK"], "usages": ["PARKING"] }, ... ] }
Essayer
APIs Explorer vous permet d'effectuer des exemples de requêtes afin de vous familiariser avec l'API et ses options.
Sélectionnez l'icône API api sur le côté droit de la page.
Vous pouvez modifier les paramètres de la requête.
Sélectionnez le bouton Exécuter. Dans la boîte de dialogue, choisissez le compte que vous souhaitez utiliser pour effectuer la requête.
Dans le panneau APIs Explorer, sélectionnez l'icône Plein écran fullscreen pour agrandir la fenêtre APIs Explorer.