Introduction
L'API Places est compatible avec Place Photos (ancienne version). Si vous connaissez les photos de lieux (ancienne version), voici les modifications apportées par les photos de lieux (nouvelle version) :
- Place Photos (New) requires that you pass the resource name of the photo, which includes the place ID in the request URL, instead of just the photo reference. Pour en savoir plus, consultez Modifications apportées aux références de photos.
- Place Photos (nouveau) est compatible avec les clés API et les jetons OAuth comme mécanisme d'authentification.
Le tableau suivant liste les paramètres de Place Photos (ancienne version) qui ont été renommés ou modifiés pour Place Photos (nouvelle version), ou les paramètres qui ne sont plus acceptés.
| Paramètre actuel | Nouveau paramètre | Remarques |
|---|---|---|
maxheight |
maxHeightPx |
Vous devez spécifier maxHeightPx, maxWidthPx ou les deux. |
maxwidth |
maxWidthPx |
Vous devez spécifier maxHeightPx, maxWidthPx ou les deux. |
Taille de photo plus élevée
Place Photos (ancienne version) acceptait une taille maximale de 1 600 x 1 600 pixels pour les photos. Place Photos (New) accepte les tailles jusqu'à 4 800 x 4 800 pixels.
Passer aux références photo
L'API Place Photos (New) exige que vous transmettiez le nom de ressource de la photo demandée, qui inclut un ID de lieu et la référence de la photo, au format suivant :
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
Nearby Search (New), Text Search (New) et Place Details (New) renvoient tous un tableau photos[] dans la réponse qui est compatible avec ce format. Chaque élément de photos[] dans la nouvelle réponse contient les champs suivants :
name: chaîne contenant le nom de ressource de la photo. Cette chaîne se présente au format suivant :places/PLACE_ID/photos/PHOTO_REFERENCE
heightPx: hauteur maximale de l'image, en pixels.widthPx: largeur maximale de l'image, en pixels.authorAttributions[]: toutes les attributions requises. Ce champ est toujours présent, mais peut être vide.
Avec l'ancienne API, il vous suffit de transmettre la référence de la photo au format suivant :
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Find Place (Legacy), Nearby Search (Legacy), Text Search (Legacy) et Place Details (Legacy) renvoient tous un tableau photos[] dans la réponse compatible avec ce format. Chaque élément photo de l'ancienne réponse contient les champs suivants :
photo_reference: chaîne utilisée pour identifier la photo lorsque vous effectuez une requête photo.height: hauteur maximale de l'image.width: largeur maximale de l'image.html_attributions[]: toutes les attributions requises. Ce champ est toujours présent, mais peut être vide.