Place Photos (nuevo) requiere que pases el nombre del recurso de la foto, que incluye el ID de lugar en la URL de la solicitud, en lugar de solo la referencia de la foto. Para obtener más información, consulta Cambio a referencias de fotos.
Place Photos (nuevo) admite claves de API y tokens de OAuth como mecanismo de autenticación.
En la siguiente tabla, se enumeran los parámetros de Place Photos (heredado) que se cambiaron de nombre o se modificaron para Place Photos (nuevo), o bien los parámetros que ya no se admiten.
Parámetro actual
Parámetro nuevo
Notas
maxheight
maxHeightPx
Debes especificar maxHeightPx, maxWidthPx o ambos.
maxwidth
maxWidthPx
Debes especificar maxHeightPx, maxWidthPx o ambos.
Aumento del tamaño de las fotos
Place Photos (Legacy) admitía un tamaño máximo de foto de 1,600 por 1,600 píxeles. Las fotos de lugares (nuevo) admiten tamaños de hasta 4,800 x 4,800 píxeles.
Cambia a referencias fotográficas
La API de Place Photos (nuevo) requiere que pases el nombre del recurso de la foto solicitada, que incluye un ID de lugar y la referencia de la foto, de la siguiente manera:
Nearby Search (nuevo), Text Search (nuevo) y Place Details (nuevo) devuelven un array photos[] en la respuesta que admite este formato. Cada elemento de photos[] en la nueva respuesta contiene los siguientes campos:
name: Es una cadena que contiene el nombre del recurso de la foto. Esta cadena tiene el siguiente formato:
places/PLACE_ID/photos/PHOTO_REFERENCE
heightPx: Es la altura máxima de la imagen en píxeles.
widthPx: Es el ancho máximo de la imagen en píxeles.
authorAttributions[]: Cualquier atribución requerida. Este campo siempre está presente, pero puede estar vacío.
Con la API heredada, solo tienes que pasar la referencia de la foto, de la siguiente manera:
Find Place (legado), Nearby Search (legado), Text Search (legado) y Place Details (legado) muestran un array photos[] en la respuesta que admite este formato. Cada elemento photo de la respuesta heredada contiene los siguientes campos:
photo_reference: Es una cadena que se usa para identificar la foto cuando realizas una solicitud de foto.
height: Es la altura máxima de la imagen.
width: Es el ancho máximo de la imagen.
html_attributions[]: Cualquier atribución requerida. Este campo siempre está presente, pero puede estar vacío.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[],[],null,["**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\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\nIncreased 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\nChange 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."]]
