Method: places.photos.getMedia

Recebe 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 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 da imagem, em pixels. 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á dimensionada 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, inclusive. Se o valor não estiver dentro do intervalo permitido, um erro INVALID_ARGUMENT será retornado.

É necessário especificar pelo menos um dos valores: "maxHeightPx" ou "maxWidthPx". Se nenhum dos dois for especificado, um erro INVALID_ARGUMENT 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 qualquer dimensão, ela será dimensionada 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, inclusive. Se o valor não estiver dentro do intervalo permitido, um erro INVALID_ARGUMENT será retornado.

É necessário especificar pelo menos um dos valores: "maxHeightPx" ou "maxWidthPx". Se nenhum dos dois for especificado, um erro INVALID_ARGUMENT será retornado.
skipHttpRedirect

boolean

Opcional. Se definido, pula o comportamento de redirecionamento HTTP padrão e renderiza uma resposta em formato de texto (por exemplo, em formato JSON para caso de uso HTTP). Se não estiver 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 um dos seguintes escopos do 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