L'API Places est compatible avec Place Details. Si vous connaissez l'API Places existante, la nouvelle version de Place Details apporte les modifications suivantes:
- Le masquage du champ est obligatoire. Vous devez spécifier les champs à renvoyer dans la réponse. Il n'existe pas de liste par défaut des champs renvoyés. Si vous omettez de cette liste, les méthodes renvoient une erreur. Pour en savoir plus, consultez FieldMask.
- Le nouveau Place Details est compatible avec Clés API et OAuth comme mécanisme d'authentification.
- Seul le format de réponse JSON est accepté dans le nouveau Place Details.
- Format de réponse JSON pour Place Details (New) Le format des API existantes a été modifié. Pour en savoir plus, consultez Migrez la réponse de l'API Places.
Le tableau suivant répertorie les paramètres des Place Details qui a été renommé ou modifié pour le nouveau Place Details, ou des paramètres qui ne sont plus compatibles.
Paramètre actuel | Nouveau paramètre | Remarques |
---|---|---|
place_id |
places/PLACE_ID |
La chaîne places/PLACE_ID est également appelée
nom de ressource du lieu. 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 champ name de la réponse.
L'ID de lieu autonome est contenu dans le champ id de la réponse. |
language |
languageCode |
|
region |
regionCode |
Exemple de requête
L'exemple suivant de demande GET utilise
Place Details. Dans cet exemple, vous demandez un fichier
Réponse contenant des informations sur un ID de lieu et transmet tous les paramètres en tant qu'URL
paramètres. Cet exemple utilise également fields
. La réponse n'inclut donc que le
Nom à afficher et adresse formatée du lieu:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'
Avec Place Details (New), vous effectuez une requête GET et transmettre tous les paramètres des paramètres d'URL et des en-têtes dans la requête. Ce L'exemple utilise également un masque de champ pour que la réponse n'inclue que le nom à afficher et l'adresse formatée du lieu:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,formattedAddress" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
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
(nouveau), Nearby Search (nouveau) et
requête Text Search (New), cette chaîne est contenue
dans le champ name
de la réponse. L'identifiant de lieu autonome est contenu dans la section
id
de la réponse.