L'API Places est compatible avec Place Photo (ancienne version). Si vous connaissez Place Photo (ancienne version), Place Photo (nouvelle version) apporte les modifications suivantes:
- La photo de lieu (nouvelle) nécessite que vous transmettiez le nom de la 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 Modifier les références photo.
- La fonctionnalité Photo de lieu (nouvelle) accepte à la fois les clés API et les OAuth comme mécanisme d'authentification.
Le tableau suivant liste les paramètres de la fonctionnalité Photo de lieu (ancienne) qui ont été renommés ou modifiés pour la fonctionnalité Photo de lieu (nouvelle), ou les paramètres 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
La photo de lieu (ancienne version) acceptait une taille maximale de 1 600 x 1 600 pixels. La fonctionnalité Placer une photo (nouvelle) accepte des tailles maximales de 4 800 x 4 800 pixels.
Passer aux références photo
L'API Place Photo (nouvelle) vous oblige à transmettre le nom de la ressource de la photo demandée, qui comprend 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 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 la ressource de la photo. Cette chaîne se présente sous la forme suivante: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 obligatoires. Ce champ est toujours présent, mais peut être vide.
Avec l'API existante, il vous suffit de transmettre la référence de la photo, sous la forme suivante:
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 obligatoires. Ce champ est toujours présent, mais peut être vide.