Method: places.photos.getMedia

Receba uma mídia de foto com uma string de referência de foto.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. O nome do recurso de uma mídia de foto no formato: places/{placeId}/photos/{photo_reference}/media.

O nome do recurso de uma foto retornada no campo photos.name de um objeto do Place tem o formato places/{placeId}/photos/{photo_reference}. É necessário anexar /media ao final do recurso de foto para receber o nome do recurso de mídia de foto.

Parâmetros de consulta

Parâmetros
maxWidthPx

integer

Opcional. Especifica a largura máxima desejada, em pixels, da imagem. Se a imagem for menor que os valores especificados, a imagem original será retornada. Se a imagem for maior em qualquer dimensão, ela será redimensionada para corresponder à menor das duas dimensões, restrita à proporção original. As propriedades maxHeightPx e maxWidthPx aceitam um número inteiro entre 1 e 4800. Se o valor não estiver dentro do intervalo permitido, um erro INVALID_ARGUMENT será retornado.

Pelo menos um entre maxHeightPx ou maxWidthPx precisa ser especificado. Se nem maxHeightPx nem maxWidthPx forem especificados, um erro INVALID_ARGUMENT será retornado.

maxHeightPx

integer

Opcional. Especifica a altura máxima desejada, em pixels, da imagem. Se a imagem for menor que os valores especificados, a imagem original será retornada. Se a imagem for maior em qualquer dimensão, ela será redimensionada para corresponder à menor das duas dimensões, restrita à proporção original. As propriedades maxHeightPx e maxWidthPx aceitam um número inteiro entre 1 e 4800. Se o valor não estiver dentro do intervalo permitido, um erro INVALID_ARGUMENT será retornado.

Pelo menos um entre maxHeightPx ou maxWidthPx precisa ser especificado. Se nem maxHeightPx nem maxWidthPx forem especificados, um erro INVALID_ARGUMENT será retornado.

skipHttpRedirect

boolean

Opcional. Se definido, pule o comportamento de redirecionamento HTTP padrão e renderize uma resposta de formato de texto (por exemplo, no formato JSON para o caso de uso HTTP). Se não for definido, um redirecionamento HTTP será emitido para redirecionar a chamada para a mídia de imagem. Essa opção é ignorada para solicitações não HTTP.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Uma mídia de foto da API Places.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "name": string,
  "photoUri": string
}
Campos
name

string

O nome do recurso de uma mídia de foto no formato: places/{placeId}/photos/{photo_reference}/media.

photoUri

string

Um URI de curta duração que pode ser usado para renderizar a foto.

Escopos de autorização

Requer o seguinte escopo OAuth:

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