A API Places oferece suporte a Place Photo (Legacy). Se você já conhece o Place Photo (legado), Place Photo (novo) faz as seguintes mudanças:
- O recurso "Place Photo (New)" 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 método Place Photo (Novo) oferece suporte a chaves de API e tokens OAuth como mecanismo de autenticação.
A tabela a seguir lista parâmetros em "Foto do lugar (legado)" que foram renomeados ou modificados para "Foto do lugar (novo)" ou parâmetros que não têm 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
A foto do local (legado) aceitava fotos de até 1.600 x 1.600 pixels. O recurso "Foto do lugar (novo)" aceita tamanhos de até 4.800 x 4.800 pixels.
Mudar para referências de fotos
A API Place Photo (nova) 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
O Nearby Search (novo), o Text Search (novo) e o Place Details (novo) 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 obrigatórias. Esse campo está sempre presente, mas pode estar vazio.
Com a API atual, você só precisa transmitir a referência da foto, no formato:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCE maxwidth=400&key=API_KEY
O Find Place (legado), o Nearby Search (legado), o Text Search (legado) e o Place Details (legado) retornam uma matriz photos[] na resposta que oferece suporte a esse formato. Cada elemento photo na resposta
legado contém os seguintes campos:
photo_reference: uma string usada para identificar a foto quando você faz 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 obrigatórias. Esse campo está sempre presente, mas pode estar vazio.