L'API Places est compatible avec les informations sur le lieu existantes. Si vous connaissez l'API Places existante, la nouvelle version de Place Details apporte les modifications suivantes:
- Le masquage de champ est obligatoire. Vous devez spécifier les champs que vous souhaitez renvoyer 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.
- Les nouvelles informations sur le lieu acceptent à la fois les clés API et les OAuth comme mécanisme d'authentification.
- Seul le format JSON est accepté comme format de réponse dans les nouvelles informations sur le lieu.
- Le format de réponse JSON de l'API Place Details (New) a changé par rapport à celui des API existantes. Pour en savoir plus, consultez la section Migrer la réponse de l'API Places.
Le tableau suivant liste les paramètres des informations sur un lieu existants qui ont été renommés ou modifiés pour les nouvelles informations sur un lieu, ou les paramètres qui ne sont plus acceptés.
| 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 de l'emplacement. 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 informations sur le lieu existantes. 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. La réponse n'inclut donc que le nom à afficher et l'adresse mise en forme 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 envoyez une requête GET et transmettez tous les paramètres dans les paramètres et les en-têtes d'URL dans le cadre de la requête. Cet exemple utilise également un masque de champ afin 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 nom de ressource. 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.