Method: places.photos.getMedia

• Solicitud HTTP
• Parámetros de ruta de acceso
• Parámetros de consulta
• Cuerpo de la solicitud
• Cuerpo de la respuesta
  • Representación JSON

Obtén un contenido multimedia 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 contenido multimedia de fotos en el siguiente 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 fotos 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 cualquiera de las dimensiones, se ajustará 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 se encuentra dentro del rango permitido, se mostrará un error INVALID_{8/}. Se debe especificar, al menos, uno de los valores maxHeightPx o maxWidthPx. Si no se especifica maxHeightPx ni maxWidthPx, se mostrará un error INVALID_ATTRIBUTE.
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 mostrará la imagen original. Si la imagen es más grande en cualquiera de las dimensiones, se ajustará 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 se encuentra dentro del rango permitido, se mostrará un error INVALID_{8/}. Se debe especificar, al menos, uno de los valores maxHeightPx o maxWidthPx. Si no se especifica maxHeightPx ni maxWidthPx, se mostrará un error INVALID_ATTRIBUTE.
skipHttpRedirect	boolean Opcional. Si se configura, omite el comportamiento predeterminado de redireccionamiento HTTP y procesa una respuesta de formato de texto (por ejemplo, en formato JSON para el caso de uso de HTTP). Si no la estableces, 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 medio 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 contenido multimedia de fotos en el siguiente formato: places/{placeId}/photos/{photo_reference}/media.
photoUri	string Un URI de corta duración que se puede usar para renderizar la foto.