Introduction
L'API Places est compatible avec Place Photos (ancienne version). Si vous connaissez Place Photos (ancienne version), Place Photos (nouvelle version) voici les modifications apportées :
- Place Photos (nouvelle version) vous oblige à transmettre le nom de ressource de la photo, qui inclut l'ID de lieu dans l' URL de la requête, au lieu de la référence de la photo uniquement. Pour en savoir plus, consultez la section Modification des références de photos.
- Place Photos (nouvelle version) est compatible avec les clés API et les OAuth comme mécanisme d'authentification.
Le tableau suivant répertorie les paramètres de Place Photos (ancienne version) qui ont été renommés ou modifiés pour Place Photos (nouvelle version), ou qui ne sont plus compatibles.
| 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. |
Augmentation de la taille des photos
Place Photos (ancienne version) était compatible avec une taille maximale de 1 600 x 1 600 pixels. Place Photos (nouvelle version) est compatible avec des tailles allant jusqu'à 4 800 x 4 800 pixels.
Modification des références de photos
L'API Place Photos (nouvelle version) vous oblige à transmettre 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 (nouvelle version), Text Search (nouvelle version) et Place Details (nouvelle version) renvoient tous un tableau photos[] dans la réponse 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 est 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 il peut être vide.
Avec l'ancienne API, vous n'avez qu'à 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 (ancienne version), Nearby Search (ancienne version), Text Search (ancienne version) et Place Details (ancienne version) 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 il peut être vide.