A API Places é compatível com o Place Photo. Se você conhece o Place Photo, a nova versão faz as seguintes mudanças:
- O novo serviço Place Photo exige que você transmita o nome de recurso da foto, que inclui o ID de 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 Place Photo aceita chaves de API e tokens OAuth como mecanismo de autenticação.
A tabela a seguir lista os parâmetros do Place Photo atual que foram renomeados ou modificados para o novo Place Photo ou os parâmetros que não são mais compatíveis.
Parâmetro atual | Novo parâmetro | Observações |
---|---|---|
maxheight |
maxHeightPx |
Especifique maxHeightPx ,
maxWidthPx ou ambos. |
maxwidth |
maxWidthPx |
Especifique maxHeightPx ,
maxWidthPx ou ambos. |
Aumento do tamanho da foto
O Place Photo existente aceita um tamanho máximo de foto de 1.600 por 1.600 pixels. O Place Photo (novo) aceita tamanhos de até 4.800 por 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 de lugar e a referência da 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 compatível com esse formato. Cada elemento de photos[]
na nova resposta contém os seguintes campos:
name
: uma string contendo 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. Este campo está sempre presente, mas pode estar vazio.
Com a API existente, você só precisa transmitir a referência de fotos no formato:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
O Find Place, o Nearby Search, o Text Search e o Place Details atuais retornam uma matriz photos[]
na resposta compatível com esse formato. Cada elemento photo
na resposta existente 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.