Method: places.photos.getMedia

Obtén un medio fotográfico con una cadena de referencia de foto.

Solicitud HTTP

GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

Obligatorio. El nombre del recurso de un medio de foto en el formato: places/{placeId}/photos/{photo_reference}/media.

El nombre de recurso de una foto 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 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 devolverá la imagen original. Si la imagen es más grande en 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. Las propiedades maxHeightPx y maxWidthPx aceptan un número entero entre 1 y 4,800, inclusive. Si el valor no está dentro del rango permitido, se mostrará un error INVALID_ARGUMENT.

Se debe especificar al menos uno de los valores de maxHeightPx o maxWidthPx. Si no se especifica maxHeightPx ni maxWidthPx, se mostrará un error INVALID_ARGUMENT.

maxHeightPx

integer

Opcional. Especifica la altura máxima deseada (en píxeles) para la imagen. Si la imagen es más pequeña que los valores especificados, se devolverá la imagen original. Si la imagen es más grande en 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. Las propiedades maxHeightPx y maxWidthPx aceptan un número entero entre 1 y 4,800, inclusive. Si el valor no está dentro del rango permitido, se mostrará un error INVALID_ARGUMENT.

Se debe especificar al menos uno de los valores de maxHeightPx o maxWidthPx. Si no se especifica maxHeightPx ni maxWidthPx, se mostrará un error INVALID_ARGUMENT.

skipHttpRedirect

boolean

Opcional. Si se configura, omite el comportamiento predeterminado de redireccionamiento HTTP y renderiza una respuesta en formato de texto (por ejemplo, en formato JSON para casos de uso de HTTP). Si no se establece, se emitirá un redireccionamiento HTTP para redireccionar la llamada al medio de la imagen. Esta opción se ignora para solicitudes que no son HTTP.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Un contenido multimedia fotográfico 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

El nombre del recurso de un medio de foto en 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.