L'API Places est compatible avec Place Photo. Si vous connaissez bien Place Photo, 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 de photos.
- 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 la photo de lieu existante qui ont été renommés ou modifiés pour la nouvelle photo de lieu, 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. |
Taille des photos augmentée
La taille maximale des photos était de 1 600 x 1 600 pixels pour l'élément Place Photo existant. Place Photo (nouvelle version) accepte les tailles jusqu'à 4 800 x 4 800 pixels.
Modifier les références à des photos
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 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 sous la forme:places/PLACE_ID/photos/PHOTO_REFERENCE
heightPx: hauteur maximale de l'image, en pixels.widthPx: largeur maximale de l'image, en pixels.authorAttributions[]: 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 photo, au format suivant:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Les requêtes Find Place, Nearby Search, Text Search et Place Details renvoient tous un tableau photos[] dans la réponse compatible avec ce format. Chaque élément photo de la réponse existante contient les champs suivants:
photo_reference: chaîne permettant d'identifier la photo lorsque vous effectuez une requête de photo.height: hauteur maximale de l'image.width: largeur maximale de l'image.html_attributions[]: attributions requises. Ce champ est toujours présent, mais peut être vide.