A API Places suporta a Place Photo. Se você estiver familiarizado com o Place Photo, o nova versão do Place Photo faz as seguintes alterações:
- O novo serviço Place Photo exige que você passe o nome de recurso da foto, que inclui o ID de lugar na URL de solicitação, em vez de apenas a referência da foto. Para mais informações, consulte Mudar para referências de fotos.
- O novo serviço Place Photo é compatível com Chaves de API e OAuth como mecanismo de autenticação.
A tabela a seguir lista os parâmetros no sistema Place Photo que foi renomeado ou modificado para um novo Place Photo ou parâmetros que não são mais suporte.
| Parâmetro atual | Novo parâmetro | Observações |
|---|---|---|
maxheight |
maxHeightPx |
É necessário especificar maxHeightPx,
maxWidthPx ou ambos. |
maxwidth |
maxWidthPx |
É necessário especificar maxHeightPx,
maxWidthPx ou ambos. |
Aumento do tamanho da foto
O Place Photo existente aceitava o máximo de fotos tamanho de 1.600 por 1.600 pixels. Place Photo (novo) é compatível com tamanhos de até 4.800 por 4.800 pixels.
Mudar para referências de fotos
A nova Place Photo exige que você transmita o nome do recurso da foto solicitada, que inclui um ID de lugar e a referência de foto, no formato:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
As novas versões do Nearby Search,
Text Search e Place Details
retornam uma matriz photos[] na resposta que aceita esse formato. Cada
o elemento de photos[] na nova resposta contém os seguintes campos:
name: uma string contendo o nome do recurso do foto. Essa string está no formato:places/PLACE_ID/photos/PHOTO_REFERENCE
heightPx: a altura máxima da imagem em pixels.widthPx: a largura máxima da imagem em pixels.authorAttributions[]: todas as atribuições necessárias. Isso campo está sempre presente, mas pode estar vazio.
Com a API existente, você só precisa transmitir a referência de fotos, no formulário:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
O Find Place,
Nearby Search, Text Search e
Todos os Place Details retornam uma matriz photos[] na
com suporte para esse formato. Cada elemento photo na
A resposta 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[]: todas as atribuições necessárias. Isso campo está sempre presente, mas pode estar vazio.