Place Photos (New) exige que vous transmettiez le nom de ressource de la photo, qui inclut l'ID du lieu dans l'URL de la requête, au lieu de la référence de la photo uniquement. Pour en savoir plus, consultez Modification des références de photos.
Place Photos (nouveau) est compatible avec les clés API et les jetons OAuth comme mécanisme d'authentification.
Le tableau suivant liste les paramètres de Photos de lieux (ancienne version) qui ont été renommés ou modifiés pour Photos de lieux (nouvelle version), ou les paramètres 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 augmentée
L'ancienne fonctionnalité Photos de lieux acceptait une taille maximale de 1 600 x 1 600 pixels pour les photos. Place Photos (New)
accepte les tailles jusqu'à 4 800 x 4 800 pixels.
Passer aux références photo
L'API Place Photos (New) exige que vous transmettiez 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 :
Nearby Search (New), Text Search (New) et Place Details (New) renvoient tous un tableau photos[] dans la réponse qui est 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 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'ancienne API, il vous suffit de transmettre la référence de la photo au format suivant :
Find Place (Legacy), Nearby Search (Legacy), Text Search (Legacy) et Place Details (Legacy) 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 peut être vide.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[],[],null,["# Migrate to Place Photos (New)\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nIntroduction\n------------\n\nThe Places API supports\n[Place Photos (Legacy)](/maps/documentation/places/web-service/photos).\nIf you are familiar with Place Photos (Legacy),\n[Place Photos (New)](/maps/documentation/places/web-service/place-photos)\nmakes the following changes:\n\n- Place Photos (New) requires that you pass the resource name of the photo, which includes the place ID in the request URL, instead of just the photo reference. For more information, see [Change to photo references](#photo-ref).\n- Place Photos (New) supports both [API keys](/maps/documentation/places/web-service/get-api-key) and [OAuth](/maps/documentation/places/web-service/oauth-token) tokens as the authentication mechanism.\n\nThe following table lists parameters in\nPlace Photos (Legacy) that have been renamed or\nmodified for Place Photos (New), or parameters\nthat are no longer supported.\n\n| Current parameter | New parameter | Notes |\n|-------------------|---------------|---------------------------------------------------------------|\n| `maxheight` | `maxHeightPx` | You must specify either `maxHeightPx`, `maxWidthPx`, or both. |\n| `maxwidth` | `maxWidthPx` | You must specify either `maxHeightPx`, `maxWidthPx`, or both. |\n\n### Increased photo size\n\nPlace Photos (Legacy) supported a maximum photo\nsize of 1600 by 1600 pixels. Place Photos (New)\nsupports sizes up to 4800 by 4800 pixels.\n\n### Change to photo references\n\n[Place Photos (New)](/maps/documentation/places/web-service/place-photos)\nAPI requires that you pass the *resource name* of the requested photo, which\nincludes a **place ID** and the **photo reference**, in the form: \n\n```json\nhttps://places.googleapis.com/v1/places/\u003cvar translate=\"no\"\u003ePLACE_ID\u003c/var\u003e/photos/\u003cvar translate=\"no\"\u003ePHOTO_REFERENCE\u003c/var\u003e/media?maxWidthPx=400&key=\u003cvar translate=\"no\"\u003eAPI_KEY\u003c/var\u003e\n```\n\nNearby Search (New),\nText Search (New), and\nPlace Details (New)\nall return a `photos[]` array in the response that supports this format. Each\nelement of `photos[]` in the new response contains the following fields:\n\n- `name` --- A string containing the resource name of the\n photo. This string is in the form:\n\n ```\n places/PLACE_ID/photos/PHOTO_REFERENCE\n ```\n- `heightPx` --- The maximum height of the image, in pixels.\n- `widthPx` --- The maximum width of the image, in pixels.\n- `authorAttributions[]` --- Any required attributions. This field is always present, but might be empty.\n\nWith the legacy API, you only have to pass the **photo reference**, in the\nform: \n\n```json\nhttps://maps.googleapis.com/maps/api/place/photo?photo_reference=\u003cvar translate=\"no\"\u003ePHOTO_REFERENCE\u003c/var\u003emaxwidth=400&key=\u003cvar translate=\"no\"\u003eAPI_KEY\u003c/var\u003e\n```\n\nFind Place (Legacy),\nNearby Search (Legacy),\nText Search (Legacy), and\nPlace Details (Legacy) all return a `photos[]` array in\nthe response that supports this format. Each `photo` element in the legacy\nresponse contains the following fields:\n\n- `photo_reference` --- A string used to identify the photo when you perform a Photo request.\n- `height` --- The maximum height of the image.\n- `width` --- The maximum width of the image.\n- `html_attributions[]` --- Any required attributions. This field is always present, but might be empty.\n\n| **Note:** The `photo_reference` field does not include the place ID. If you want to use Place Photos (New) with these legacy APIs, you must add the place ID to construct the full resource name."]]
