Es obligatorio. Es el nombre del recurso de un contenido multimedia de fotos con el formato: places/{placeId}/photos/{photo_reference}/media.
El nombre del recurso de una foto, tal como se muestra en el campo photos.name de un objeto Place, tiene el formato places/{placeId}/photos/{photo_reference}. Debes agregar /media al final del recurso de foto para obtener el nombre del recurso de contenido multimedia de la foto.
Parámetros de consulta
Parámetros
maxWidthPx
integer
Opcional. Especifica el ancho máximo deseado, en píxeles, de la imagen. Si la imagen es más pequeña que los valores especificados, se mostrará la imagen original. Si la imagen es más grande en alguna dimensión, se ajustará para que coincida con la más pequeña de las dos dimensiones, restringida a su relación de aspecto original. Tanto maxHeightPx como maxWidthPx aceptan un número entero entre 1 y 4800 inclusive. Si el valor no está dentro del rango permitido, se mostrará un error INVALID_ARGUMENT.
Se debe especificar al menos uno de maxHeightPx o maxWidthPx. Si no se especifican maxHeightPx ni maxWidthPx, se mostrará un error INVALID_ARGUMENT.
maxHeightPx
integer
Opcional. Especifica la altura máxima deseada, en píxeles, de la imagen. Si la imagen es más pequeña que los valores especificados, se mostrará la imagen original. Si la imagen es más grande en alguna dimensión, se ajustará para que coincida con la más pequeña de las dos dimensiones, restringida a su relación de aspecto original. Tanto maxHeightPx como maxWidthPx aceptan un número entero entre 1 y 4800 inclusive. Si el valor no está dentro del rango permitido, se mostrará un error INVALID_ARGUMENT.
Se debe especificar al menos uno de maxHeightPx o maxWidthPx. Si no se especifican maxHeightPx ni maxWidthPx, se mostrará un error INVALID_ARGUMENT.
skipHttpRedirect
boolean
Opcional. Si se establece, se omite el comportamiento predeterminado de redireccionamiento HTTP y se renderiza una respuesta de formato de texto (por ejemplo, en formato JSON para el caso de uso de HTTP). Si no se establece, se emitirá un redireccionamiento HTTP para redireccionar la llamada al contenido multimedia de la imagen. Esta opción se ignora para las solicitudes que no son HTTP.
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Un elemento multimedia de foto de la API de Places.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON
{"name": string,"photoUri": string}
Campos
name
string
Es el nombre del recurso de un contenido multimedia de fotos con el formato: places/{placeId}/photos/{photo_reference}/media.
photoUri
string
Es un URI de corta duración que se puede usar para renderizar la foto.
[[["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-08-31 (UTC)"],[[["\u003cp\u003eRetrieve a photo media resource using a specific photo reference string through a GET request.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a \u003ccode\u003ename\u003c/code\u003e path parameter specifying the photo media resource, formatted as \u003ccode\u003eplaces/{placeId}/photos/{photo_reference}/media\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eOptionally customize the retrieved photo's dimensions using \u003ccode\u003emaxWidthPx\u003c/code\u003e and \u003ccode\u003emaxHeightPx\u003c/code\u003e query parameters, with values ranging from 1 to 4800.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides a JSON object containing the photo media's resource name (\u003ccode\u003ename\u003c/code\u003e) and a temporary URI (\u003ccode\u003ephotoUri\u003c/code\u003e) for rendering the photo.\u003c/p\u003e\n"]]],["This outlines how to retrieve photo media using a `GET` request to the specified URL, which requires a photo resource `name` in the path parameters. Optional query parameters `maxWidthPx` and `maxHeightPx` allow for image resizing (1-4800 pixels). `skipHttpRedirect` is another optional parameter. The request body must be empty. The response includes `name` and a short-lived `photoUri` for the photo. Access requires the `cloud-platform` authorization scope.\n"],null,["# Method: places.photos.getMedia\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.PhotoMedia.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nGet a photo media with a photo reference string.\n\n### HTTP request\n\n`GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The resource name of a photo media in the format: `places/{placeId}/photos/{photo_reference}/media`. The resource name of a photo as returned in a Place object's `photos.name` field comes with the format `places/{placeId}/photos/{photo_reference}`. You need to append `/media` at the end of the photo resource to get the photo media resource name. |\n\n### Query parameters\n\n| Parameters ||\n|--------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `maxWidthPx` | `integer` Optional. Specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio. Both the maxHeightPx and maxWidthPx properties accept an integer between 1 and 4800, inclusively. If the value is not within the allowed range, an INVALID_ARGUMENT error will be returned. At least one of maxHeightPx or maxWidthPx needs to be specified. If neither maxHeightPx nor maxWidthPx is specified, an INVALID_ARGUMENT error will be returned. |\n| `maxHeightPx` | `integer` Optional. Specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio. Both the maxHeightPx and maxWidthPx properties accept an integer between 1 and 4800, inclusively. If the value is not within the allowed range, an INVALID_ARGUMENT error will be returned. At least one of maxHeightPx or maxWidthPx needs to be specified. If neither maxHeightPx nor maxWidthPx is specified, an INVALID_ARGUMENT error will be returned. |\n| `skipHttpRedirect` | `boolean` Optional. If set, skip the default HTTP redirect behavior and render a text format (for example, in JSON format for HTTP use case) response. If not set, an HTTP redirect will be issued to redirect the call to the image media. This option is ignored for non-HTTP requests. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA photo media from Places API.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------|\n| ``` { \"name\": string, \"photoUri\": string } ``` |\n\n| Fields ||\n|------------|---------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The resource name of a photo media in the format: `places/{placeId}/photos/{photo_reference}/media`. |\n| `photoUri` | `string` A short-lived uri that can be used to render the photo. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`"]]
