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. Es el nombre del recurso de un contenido multimedia de fotos con 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 mostrará la imagen original. Si la imagen es más grande en dimensión, se ajustará en escala para coincidir 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 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, 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 dimensión, se ajustará en escala para coincidir 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 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 especifica 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 en 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.