L'API Places est compatible avec Place Photo existante. Si vous connaissez l'application Place Photo existante, la nouvelle version de Place Photo apporte les modifications suivantes:
- Le nouveau service Place Photo nécessite que vous transmettiez le nom de ressource de la photo, qui inclut l'identifiant de lieu dans l'URL de la requête, au lieu de simplement transmettre la référence de la photo. Pour en savoir plus, consultez Modifier les références photo.
- Le nouveau service Place Photo est compatible avec les clés API et les jetons OAuth en tant que mécanisme d'authentification.
Le tableau suivant répertorie les paramètres de Place Photo existants qui ont été renommés ou modifiés pour la nouvelle Place Photo, ou ceux 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 des photos agrandie
La photo de lieu existante était compatible avec une taille maximale de 1 600 x 1 600 pixels. Place Photo (New) accepte jusqu'à 4 800 x 4 800 pixels.
Passer aux références photo
La nouvelle API Place Photo nécessite que vous transmettiez le nom de ressource de la photo demandée, qui inclut un identifiant 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
Les nouvelles versions de Nearby Search, Text Search et Place Details renvoient toutes un tableau photos[] dans la réponse qui accepte ce format. Chaque élément de photos[] de 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 peut être vide.
Avec l'API existante, 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
Les éléments Find Place, Nearby Search, Text Search et Place Details existants renvoient tous un tableau photos[] dans la réponse qui accepte ce format. Chaque élément photo de la réponse existante 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.