A API Places oferece suporte ao Place Photo. Se você já conhece a Foto do lugar atual, a nova versão da Foto do lugar faz as seguintes mudanças:
- O novo serviço Place Photo exige que você transmita o nome do recurso da foto, que inclui o ID do lugar no URL da 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 de fotos de lugar oferece suporte a chaves de API e tokens OAuth como mecanismo de autenticação.
A tabela a seguir lista parâmetros na foto de lugar atual que foram renomeados ou modificados para a nova foto de lugar ou que não são mais aceitos.
| 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 já existente oferecia suporte a fotos de até 1.600 x 1.600 pixels. A foto do lugar (nova) aceita tamanhos de até 4.800 x 4.800 pixels.
Mudar para referências de fotos
A nova API Place Photo exige que você transmita o nome do recurso da foto solicitada, que inclui um ID do lugar e a referência da foto, no formulário:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
As novas versões do Nearby Search, do Text Search e do Place Details retornam uma matriz photos[] na resposta que oferece suporte a esse formato. Cada
elemento de photos[] na nova resposta contém os seguintes campos:
name: uma string que contém o nome do recurso da 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. Esse campo está sempre presente, mas pode estar vazio.
Com a API atual, você só precisa transmitir a referência da foto, no formulário:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
O Find Place, a Nearby Search, a Text Search e o Place Details retornam uma matriz photos[] na resposta que oferece suporte a esse formato. Cada elemento photo na resposta
atual 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[]: todas as atribuições necessárias. Esse campo está sempre presente, mas pode estar vazio.