Migrar para o Place Photo (novo)

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.
.