Fotos do lugar

Selecione a plataforma: Android iOS JavaScript Serviço da Web

O serviço Place Photo, parte da API Places, é uma API somente leitura que permite adicionar conteúdo fotográfico de alta qualidade ao seu aplicativo. O serviço Place Photo permite acessar milhões de fotos armazenadas no banco de dados do Places. Quando você receber informações do lugar usando uma solicitação do Place Details, fotos de referência serão retornadas para conteúdo fotográfico relevante. As solicitações do Find Place, Nearby Search e Text Search também retornam uma única referência de foto por lugar, quando relevante. Com o serviço de fotos, é possível acessar as fotos referenciadas e redimensionar a imagem para o tamanho ideal para seu aplicativo.

Solicitações de Place Photos

Uma solicitação de Place Photo é um URL HTTP no seguinte formato:

https://maps.googleapis.com/maps/api/place/photo?parameters

Certos parâmetros são obrigatórios para iniciar uma solicitação de pesquisa. Como é padrão em URLs, todos os parâmetros são separados usando o caractere de"e"comercial (&). A lista de parâmetros e os possíveis valores estão enumerados abaixo.

Required parameters

  • photo_reference

    A string identifier that uniquely identifies a photo. Photo references are returned from either a Place Search or Place Details request.

Optional parameters

  • maxheight

    Specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio. Both the maxheight and maxwidth properties accept an integer between 1 and 1600.

  • maxwidth

    Specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio. Both the maxheight and maxwidth properties accept an integer between 1 and 1600.

Generated from the OpenAPI specification. Edit Report bug

Referências de fotos

Todas as solicitações ao serviço Place Photo precisam incluir um photoreference, retornado em resposta a uma solicitação do Find Place, Nearby Search, Text Search ou Place Details. A resposta a essas solicitações conterá um campo photos[] se o lugar tiver conteúdo fotográfico relacionado.

Observação: o número de fotos retornadas varia de acordo com a solicitação.

  • Uma solicitação do Find Place, Nearby Search ou Text Search retorna no máximo um elemento photo na matriz.
  • Uma solicitação do Place Details retorna até dez elementos photo.

Cada elemento photo contém os seguintes campos:

  • photo_reference: uma string usada para identificar a foto quando você executa uma solicitação de foto.
  • height: a altura máxima da imagem.
  • width: a largura máxima da imagem.
  • html_attributions[]: contém as atribuições necessárias. Este campo está sempre presente, mas pode estar vazio.

As fotos retornadas pelo serviço de fotos são provenientes de vários locais, incluindo proprietários de empresas e fotos de usuários. Na maioria dos casos, essas fotos podem ser usadas sem atribuição ou terão a atribuição necessária incluída como parte da imagem. No entanto, se o elemento photo retornado incluir um valor no campo html_attributions, vai ser necessário incluir a atribuição adicional no seu aplicativo sempre que exibir a imagem.

Veja um exemplo de uma matriz photos[].

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"
   }
...

Exemplo de foto de lugar

Veja abaixo um exemplo de solicitação. Essa solicitação retornará a imagem referenciada, redimensionando-a para que tenha no máximo 400 pixels de largura.

https://maps.googleapis.com/maps/api/place/photo
  ?maxwidth=400
  &photo_reference=Aap_uEA7vb0DDYVJWEaX3O-AtYp77AaswQKSGtDaimt3gt7QCNpdjp1BkdM6acJ96xTec3tsV_ZJNL_JP-lqsVxydG3nh739RE_hepOOL05tfJh2_ranjMadb3VoBYFvF0ma6S24qZ6QJUuV6sSRrhCskSBP5C1myCzsebztMfGvm7ij3gZT
  &key=YOUR_API_KEY

Resposta do Place Photos

A resposta de uma solicitação de Place Photo bem-sucedida será uma imagem. O tipo de imagem depende do tipo de foto enviada originalmente.

Se a solicitação exceder sua cota disponível, o servidor retornará um status HTTP 403 e exibirá a imagem abaixo para indicar que a cota foi excedida:

Imagem de cota excedida

Se o servidor não entender a solicitação, ele retornará o status HTTP 400, que indica uma solicitação inválida. Os motivos mais comuns para uma solicitação inválida incluem:

  • A referência de foto enviada não foi especificada corretamente.
  • A solicitação não incluiu os parâmetros maxwidth ou maxheight.
  • O valor do parâmetro maxwidth ou maxheight foi definido como null.