Migrar para o Place Photos (novo)

Desenvolvedores do Espaço Econômico Europeu (EEE)

Introdução

A API Places é compatível com o Place Photos (legado). Se você já conhece o Place Photos (legado), o Place Photos (novo) faz as seguintes mudanças:

  • O Place Photos (novo) exige que você transmita o nome do 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 Mudança nas referências de fotos.
  • O Place Photos (novo) aceita chaves de API e tokens OAuth como mecanismo de autenticação.

A tabela a seguir lista os parâmetros da Place Photos (legada) que foram renomeados ou modificados para a Place Photos (nova) 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.

Tamanho da foto aumentado

O Place Photos (legado) aceitava um tamanho máximo de foto de 1.600 por 1.600 pixels. O Place Photos (novo) oferece suporte a tamanhos de até 4.800 x 4.800 pixels.

Mudar para referências de fotos

A API Place Photos (nova) 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

Nearby Search (novo), Text Search (novo) e Place Details (novo) retornam uma matriz photos[] na resposta que aceita 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[]: as atribuições necessárias. Este campo está sempre presente, mas pode estar vazio.

Com a API legada, basta transmitir a referência da foto no formato:

https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY

Find Place (legado), Nearby Search (legado), Text Search (legado) e Place Details (legado) retornam uma matriz photos[] na resposta que aceita esse formato. Cada elemento photo na resposta legada 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[]: as atribuições necessárias. Esse campo está sempre presente, mas pode estar vazio.