Method: places.photos.getMedia

Acessar 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 de recurso de uma foto, conforme retornado no campo photos.name de um objeto Place, vem com o formato places/{placeId}/photos/{photo_reference}. É necessário anexar /media ao final do recurso de foto para acessar o nome do recurso de mídia de foto.

Parâmetros de consulta

Parâmetros
maxWidthPx

integer

Opcional. Especifica a largura máxima desejada da imagem em pixels. 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, um erro INVALID_MCC será retornado.

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

maxHeightPx

integer

Opcional. Especifica a altura máxima desejada da imagem em pixels. 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, um erro INVALID_MCC será retornado.

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

skipHttpRedirect

boolean

Opcional. Se definido, ignore o comportamento de redirecionamento HTTP padrão e renderize uma resposta de formato de texto (por exemplo, em formato JSON para caso de uso de 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 em 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.