Method: places.photos.getMedia

Obtiene un elemento multimedia de foto 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

Parámetros
name

string

Obligatorio. Es el nombre del recurso de un elemento multimedia de foto con el siguiente formato: places/{placeId}/photos/{photo_reference}/media.

El nombre del 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 de medios de la foto.

Parámetros de consulta

Parámetros
maxWidthPx

integer

Opcional. Especifica el ancho máximo deseado de la imagen en píxeles. 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 cualquiera de las dimensiones, se ajustará su escala 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 4800, 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 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 de la imagen en píxeles. 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 cualquiera de las dimensiones, se ajustará su escala 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 4800, 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 maxHeightPx o maxWidthPx. Si no se especifican maxHeightPx ni maxWidthPx, se mostrará un error INVALID_ARGUMENT.
skipHttpRedirect

boolean

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

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es 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 elemento multimedia de foto con el siguiente formato: places/{placeId}/photos/{photo_reference}/media.
photoUri

string

Es un URI de corta duración que se puede usar para renderizar la foto.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/maps-platform.places.getphotomedia
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform