L'API Places est compatible avec les Place Details existantes. 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 qui doivent être renvoyés dans la réponse. Il n'existe pas de liste par défaut des champs renvoyés. Si vous omettez cette liste, les méthodes renvoient une erreur. Pour en savoir plus, consultez la section FieldMask.
- La nouvelle interface Place Details est compatible avec les clés API et les jetons OAuth en tant que mécanisme d'authentification.
- Seul le format JSON est accepté comme format de réponse dans la nouvelle version de Place Details.
- Le format de réponse JSON de l'API Place Details (New) a été modifié par rapport au format des API existantes. Pour en savoir plus, consultez Migrer la réponse de l'API Places.
Le tableau suivant répertorie les paramètres de Place Details existants qui ont été renommés ou modifiés pour le nouveau Place Details, ou ceux 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 (New) et Text Search (New), 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 de requête GET suivant utilise les détails Place Details existants. Dans cet exemple, vous demandez une réponse JSON contenant des informations sur un ID de lieu et transmettez tous les paramètres en tant que paramètres d'URL. Cet exemple utilise également fields afin que la réponse n'inclut que le nom à afficher et l'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 transmettez tous les paramètres des paramètres d'URL et des en-têtes dans la requête. Cet exemple utilise également un masque de champ afin que la réponse n'inclut 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 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 champ name de la réponse. L'ID de lieu autonome est contenu dans le champ id de la réponse.