Pronto!

Para começar a desenvolver, acesse nossa documentação do desenvolvedor.

Ativar o serviço web da API do Google Places

Para começar, orientaremos você pelo Console do Desenvolvedor do Google para realizar algumas atividades:

  1. Criar ou selecionar um projeto
  2. Ativar o serviço web da API do Google Places
  3. Criar chaves apropriadas
Continuar

Place Photos

O serviço Place Photo, que faz parte da Google Places API Web Service, é uma API somente leitura que permite adicionar conteúdo fotográfico de alta qualidade ao seu aplicativo. O serviço Place Photo dá acesso a milhões de fotografias armazenadas nos bancos de dados de locais do Places e do Google+. Ao obter informações de local usando uma solicitação de Place Details, referências de fotos serão retornadas, oferecendo conteúdo fotográfico relevante. As solicitações de Nearby Search e Text Search também retornam uma única referência de fotografia por local, quando relevante. Ao usar o serviço Photo, é possível acessar as fotos referenciadas e redimensionar a imagem para o tamanho ideal para seu aplicativo.

Referências de fotos

Todas as solicitações para o serviço Place Photo devem conter uma photoreference, retornada em resposta a uma solicitação de Nearby Search, Text Search ou Place Details. A resposta a essas solicitações conterá um campo photos[] se o local tiver conteúdo fotográfico relacionado.

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

  • Uma Nearby Search ou Text Search retorna no máximo um elemento photo na matriz.
  • Radar Searches não retornam informações de fotos.
  • Uma solicitação de Details retornará até dez elementos photo.

Cada elemento photo contém os seguintes campos:

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

Fotos retornadas pelo serviço Photo têm origem em vários locais, inclusive de proprietários de empresas e usuários do Google+. 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, será necessário incluir a atribuição adicional no aplicativo em qualquer lugar que exibir a imagem.

Um exemplo de uma matriz photos[] é exibido abaixo.

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

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 E comercial (&). A lista de parâmetros e os possíveis valores estão enumerados abaixo.

Parâmetros obrigatórios

  • key — a chave de API do aplicativo. Essa chave identifica o aplicativo para fins de gerenciamento de cotas. Acesse Obter uma chave para obter mais informações.
  • photoreference — um identificador de string que identifica uma foto de forma exclusiva. Referências de fotos são retornadas de uma solicitação de Place Search ou Place Details.
  • maxheight ou maxwidth — especifica em pixels a altura ou largura máxima desejada da imagem retornada pelo serviço Place Photos. 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 à taxa de proporção original. As propriedades maxheight e maxwidth aceitam um número inteiro entre 1 e 1.600.

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

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photoreference=CnRtAAAATLZNl354RwP_9UKbQ_5Psy40texXePv4oAlgP4qNEkdIrkyse7rPXYGd9D_Uj1rVsQdWT4oRz4QrYAJNpFX7rzqqMlZw2h2E2y5IKMUZ7ouD_SlcHxYq1yL4KbKUv3qtWgTK0A6QbGh87GB3sscrHRIQiG2RrmU_jF4tENr9wGS_YxoUSSDrYjWmrNfeEHSGSc3FyhNLlBU&key=YOUR_API_KEY

Observação: será necessário substituir a chave de API nesse exemplo para que a solicitação funcione no seu aplicativo.

Resposta de Place Photos

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

Se a solicitação exceder a 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á um status HTTP 400, que indica uma solicitação inválida. Os motivos mais comuns pelos quais você poderá ver uma solicitação inválida incluem:

  • A referência da foto enviada foi especificada incorretamente.
  • A solicitação não inclui um parâmetro maxwidth ou maxheight.

Mensagens de erro

Quando o serviço Places retorna um status HTTP 400, pode haver um campo error_message adicional dentro do objeto da resposta. Esse campo contém informações mais detalhadas sobre os motivos por trás do código de status.

O parâmetro sensor

A Google Places API Web Service anteriormente exigia a inclusão do parâmetro sensor para indicar se o aplicativo usou um sensor para determinar a localização do usuário. Esse parâmetro não é mais obrigatório.

Enviar comentários sobre…

location_on
Google Places API Web Service