O que você recebe
Links para imagens,
não as imagens.
Esta é a distinção que vale deixar clara de saída. O que volta são os links de
foto que o Google publica para um local - o mesmo tipo de valor que o campo
photo_url do Extrator do Maps carrega, descrito no nosso dicionário de dados como
"link to the image of the place". Não arquivos de imagem num zip.
Para a maior parte do trabalho é isso que você quer: links são leves, se juntam limpo a uma tabela de locais,
e você busca ou exibe apenas os que realmente precisa. Se o seu fluxo exige cópias
locais, baixar a partir dos links é uma etapa que você controla - o que também mantém a questão
do licenciamento nas suas mãos, e não nas nossas. Mais sobre isso abaixo.
- query
- O local que você enviou, repetido em cada uma das suas linhas de foto.
- name
- O nome do local no Google Maps. Preenchido quando você envia um nome ou uma busca; fica vazio se enviar um ID, porque o nome vem da resposta de busca e não do feed de fotos.
- google_id
- O feature ID do Google para o local — o par 0x…:0x… no qual o feed de fotos é indexado.
- place_id
- O Place ID do Google (ChIJ…) — sua chave de junção para uma tabela de locais que você já mantém.
- location_link
- A URL do Google Maps do local, incluindo suas coordenadas.
- photo_id
- O identificador do Google para esta foto específica — use para remover duplicatas entre execuções.
- photo_url
- O link da foto. Esta é a linha: um link por linha, não uma linha por local.
- photo_url_big
- A mesma foto em até 2048×2048, para quando o tamanho padrão é pequeno demais para avaliar detalhes.
- latitude
- Latitude do local ao qual a foto pertence.
- longitude
- Longitude do local ao qual a foto pertence.
- photo_date
- Quando a foto foi publicada.
- photo_upload_source
- De qual app do Google veio e como foi publicada — gmm_android, gmm_ios e as variantes _review_post / _photo_post, que indicam se veio junto de uma avaliação.
- photo_source_video
- Um link de vídeo quando o item é um vídeo em vez de uma imagem estática. Vazio na maioria das linhas: vídeos são uma parcela pequena de qualquer galeria.
- photo_tags
- As próprias tags de galeria do Google para a foto — front, food, vibe — as mesmas abas que você vê na ficha.
- photo_tag_ids
- Os IDs numéricos por trás dessas tags, para filtrar sem comparação de texto.
- original_photo_url
- A variante em miniatura da foto, como é servida na grade da galeria.
16 colunas por foto - todas as colunas acima em todos os planos, incluindo o gratuito.
Três identificadores — place_id, google_id e photo_id — tornam a exportação combinável com os dados de locais que você já tem e deduplicável entre execuções repetidas, de modo que as fotos viram uma tabela adicional em vez de uma cópia paralela da sua lista de locais. Espere muitas linhas por local: um negócio bem fotografado pode produzir dezenas, então a contagem de linhas é definida pelo volume de fotos e não por quantos locais você enviou.