O serviço Place Photo, que faz parte da API Places, é um serviço de leitura que permite adicionar conteúdo fotográfico de alta qualidade aos seus para o aplicativo. O serviço Place Photo dá acesso a milhões de fotos armazenadas no banco de dados do Places. Quando você recebe informações de um lugar usando um local Solicitação de detalhes, serão retornadas referências fotográficas relevantes conteúdo. As solicitações de Find Place, Nearby Search e Text Search também retornam uma única foto. referência por local, quando relevante. Com o serviço Fotos, você pode acessar as fotos referenciadas e redimensione-a para o tamanho ideal para seu para o aplicativo.
Solicitações de Place Photo
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 é o padrão
em URLs, todos os parâmetros são separados usando o caractere E comercial (&
). O
lista de parâmetros e seus 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.
maxheight or maxwidth
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.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
andmaxwidth
properties accept an integer between1
and1600
.You must specify either
maxheight
, ormaxwidth
, or both.
Referências de fotos
Todas as solicitações para o serviço Place Photo devem incluir photo_reference
,
retornados na resposta a uma função Find Place, Nearby Search, Text Search ou Place Details
solicitação. A resposta a essas solicitações conterá um campo photos[]
se o
lugar tem conteúdo fotográfico relacionado.
Observação: o número de fotos retornadas varia de acordo com a solicitação.
- Uma solicitação de 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ê executar 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. Isso campo sempre estará presente, mas pode estar vazio.
Fotos retornadas pelo serviço Photo têm origem em vários locais,
incluindo proprietários de empresas e fotos enviadas por usuários. Na maioria dos casos,
fotos podem ser usadas sem atribuição ou terão a atribuição necessária
incluída na imagem. No entanto, se o elemento photo
retornado
incluir um valor no campo html_attributions
, será necessário incluir o
atribuição adicional em seu aplicativo sempre que você exibir a imagem.
O exemplo a seguir mostra uma solicitação do Place Details:
curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"
Um exemplo da matriz photos[]
na resposta é mostrado abaixo.
...
"photos" : [
{
"html_attributions" : [],
"height" : 853,
"width" : 1280,
"photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
}
...
Exemplo de Place Photo
Um exemplo de solicitação é mostrado abaixo. Essa solicitação retornará o tipo de arquivo redimensionando para ter no máximo 400 pixels de largura.
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q &key=YOUR_API_KEY
Resposta do Place Photo
A resposta de uma solicitação de Place Photo bem-sucedida será uma imagem. O tipo a imagem depende do tipo de foto enviada originalmente.
Se sua solicitação exceder a cota disponível, o servidor retornará um HTTP 403 e exibir a imagem abaixo para indicar que a cota foi foi excedido:
Se o servidor não entender sua solicitação, ele retornará HTTP 400. que indica uma solicitação inválida. As razões mais comuns para uma solicitação inválida incluem:
- A referência da foto enviada não foi especificada corretamente.
- A solicitação não incluiu
maxwidth
nemmaxheight
parâmetros. - O valor do parâmetro
maxwidth
oumaxheight
foi definido. paranull
. photo_reference
expirou. Sephoto_reference
expirar, faça uma solicitação para Place Details, Find Place Nearby Search, ou Text Search para receber o valor atualizado dephoto_reference
.