Method: places.photos.getMedia

Acesse 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, conforme retornado no campo photos.name de um objeto do Place, vem com o formato places/{placeId}/photos/{photo_reference}. É necessário anexar /media ao final do recurso de foto para conseguir 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 uma das dimensões, 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 4.800, inclusive. Se o valor não estiver dentro do intervalo permitido, será retornado um erro INVALID_ ARGUMENT.

Pelo menos um dos valores maxHeightPx ou maxWidthPx precisa ser especificado. Se maxHeightPx e maxWidthPx não 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 uma das dimensões, 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 4.800, inclusive. Se o valor não estiver dentro do intervalo permitido, será retornado um erro INVALID_ ARGUMENT.

Pelo menos um dos valores maxHeightPx ou maxWidthPx precisa ser especificado. Se maxHeightPx e maxWidthPx não forem especificados, um erro INVALID_ ARGUMENT será retornado.

skipHttpRedirect

boolean

Opcional. Se definido, ignore o comportamento padrão de redirecionamento HTTP e renderize uma resposta em formato de texto (por exemplo, em formato JSON para 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 nas solicitações que não sã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.