L'API Places est compatible avec Place Photo. Si vous connaissez la photo de lieu existante, nouvelle version de Place Photo apporte les modifications suivantes:
- Pour utiliser le nouveau service Place Photo, vous devez transmettez le nom de ressource de la photo, qui inclut l'identifiant de lieu dans de la requête, au lieu de la simple référence de la photo. Pour en savoir plus, consultez Modification des références à des photos :
- Le nouveau service Place Photo est compatible avec Clés API et OAuth comme mécanisme d'authentification.
Le tableau suivant répertorie les paramètres des des photos de lieu qui ont été renommées ou modifiées pour le une nouvelle photo de lieu, ou des 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
Vous ne pouvez pas ajouter plus de photos à la photo de lieu existante. de 1 600 x 1 600 pixels. Place Photo (Nouveau) prend en charge des tailles jusqu'à 4800 x 4800 pixels.
Modifier les références à des photos
Les nouvelles Place Photo L'API exige que vous transmettiez le nom de ressource de la photo demandée, qui est 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 tous un tableau photos[] dans la réponse compatible avec ce format. Chaque
de photos[] dans la nouvelle réponse contient les champs suivants:
name: chaîne contenant le nom de la ressource 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 est toujours présent, mais peut être vide.
Avec l'API existante, il vous suffit de transmettre la référence photo, dans le paramètre formulaire:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
La table Find Place existante,
Nearby Search, Text Search et
Les éléments Place Details renvoient tous un tableau photos[] dans la section
compatible avec ce format. Chaque élément photo du
contient les champs suivants:
photo_reference: chaîne permettant d'identifier la photo lorsque vous envoyer une requête de photo.height: hauteur maximale de l'image.width: largeur maximale de l'image.html_attributions[]: attributions requises. Ce est toujours présent, mais peut être vide.