Metadados do Google Takeout: os arquivos JSON explicados e aplicados

Cada foto de um Takeout do Google Photos vem com um arquivo JSON que guarda a data real, a localização e a descrição. Solte suas partes ZIP abaixo para associá-los e gravar as datas de volta — ou continue lendo para ver o que há dentro deles.

Solte aqui todos os arquivos ZIP do seu Takeout

Todas as partes de uma vez — takeout-…-001.zip, -002.zip … O JSON de uma foto muitas vezes está em outra parte. Os arquivos não saem do seu computador.

O que há em um arquivo JSON do Takeout

Para IMG_1234.jpg, o Google adiciona um arquivo como IMG_1234.jpg.supplemental-metadata.json (em exportações anteriores a 2024: IMG_1234.jpg.json). Os campos que importam:

CampoSignificadoUso aqui
titleo nome original do arquivopara associar arquivos cujos nomes foram encurtados
photoTakenTime.timestampquando a foto foi tirada, em segundos desde 1970, em UTCa data gravada
creationTime.timestampquando ela foi enviada ao Google Photossó se faltar a data de captura
geoDatalatitude, longitude e altitude como aparecem no Google Photos (0,0 significa nenhuma)GPS para fotos JPEG e HEIC sem localização
geoDataExifa localização que estava no arquivo originalalternativa para o GPS
description, people, urllegenda, marcações de rostos, linknão são gravados nas fotos

As pastas de álbuns também contêm um metadata.json (título e data do álbum). Ele não é o arquivo JSON de uma foto e é mantido como está.

Como o Google nomeia os arquivos JSON

FotoArquivo JSONMotivo
IMG_1234.jpgIMG_1234.jpg.supplemental-metadata.jsonnomenclatura atual
Screenshot_20231027_123303_Facebook.jpg…Facebook.jpg.supple.jsonos nomes de JSON são cortados em 51 caracteres
PXL_20230809_203449253.LONG_EXPOSURE-02.ORIGINA.jpg…LONG_EXPOSURE-02.ORIGIN.jsonnomes longos de fotos também são cortados (em 51 caracteres)
IMG_1234(1).jpgIMG_1234.jpg.supplemental-metadata(1).json ou IMG_1234.jpg(1).jsonsegundo arquivo com o mesmo nome na mesma pasta
IMG_1234-edited.jpgnenhum — usa o JSON de IMG_1234.jpgcópia editada
IMG_4488.MP4nenhum — usa o JSON de IMG_4488.HEICvídeo de Live Photo

A ferramenta testa essas regras da mais literal à mais flexível, dentro da mesma pasta em todas as partes ZIP, e informa no relatório qual regra associou cada arquivo.

Como aplicar os metadados

  1. Solte todas as partes ZIP acima. Você vê quantas fotos foram associadas e quais não foram.
  2. Escolha um fuso horário e as opções e depois clique em Corrigir e salvar.
  3. Extraia o resultado. As fotos JPEG e HEIC levam a data e a localização no EXIF. Os vídeos MP4 e MOV levam a data no cabeçalho. Todos os arquivos a levam como data do arquivo.

Perguntas frequentes

Posso simplesmente apagar os arquivos JSON?

Só depois que as datas deles forem aplicadas. Fotos sem data EXIF própria — capturas de tela, imagens do WhatsApp, cópias editadas, muitos vídeos — têm a data real apenas no arquivo JSON. Por padrão, o ZIP corrigido deixa os arquivos JSON de fora; marque Manter os arquivos .json para mantê-los.

Por que uma foto não tem arquivo JSON?

Cópias editadas e vídeos de Live Photo nunca recebem um (a ferramenta dá a eles a data do original). As demais geralmente estão em uma parte ZIP que você não adicionou, ou o Google as deixou de fora. A aba Sem correspondência lista esses arquivos.

O que acontece com fotos e vídeos sem arquivo JSON?

Se o nome do arquivo contém uma data, ela é usada: IMG_20190704_150000.jpg, VID_20190101_101010.mp4, PXL_20190809_203449253.jpg (Pixel, em UTC), Screenshot_20190305-101010.png, 20190704_150000.jpg (Samsung) e o IMG-20190812-WA0003.jpg do WhatsApp. Os nomes são lidos no fuso horário que você escolheu. Uma data do nome só preenche um arquivo que não tem data interna — ela nunca substitui os dados da câmera —, e os nomes do WhatsApp indicam só o dia, então esses arquivos recebem uma data do arquivo (meio-dia) e nada internamente. O relatório os marca como “do nome”; desmarque a opção para deixar esses arquivos como estão. Arquivos sem JSON e sem data no nome mantêm os bytes e a data do ZIP.

Quais arquivos recebem a data gravada internamente?

As fotos JPEG recebem a data (e, se faltar, a localização) gravada nos dados EXIF, o primeiro lugar que os apps de fotos leem. As fotos HEIC recebem o mesmo no bloco EXIF, quando têm um, como as fotos do iPhone; um HEIC sem bloco EXIF recebe apenas a data do arquivo. Os vídeos MP4, MOV, M4V e 3GP recebem a data nos cabeçalhos do vídeo e das faixas — a “data de criação” que os apps de vídeo leem —, alterada no próprio arquivo, sem recodificação. PNG, GIF, WebP, AVI, MKV e outros formatos não são modificados: recebem a data como data do arquivo (a data de “modificação”) quando você extrai o ZIP corrigido.

Em qual fuso horário ficam as datas?

O Google armazena o momento em que a foto foi tirada em UTC. A ferramenta converte esse horário para o fuso que você escolher (por padrão, o do seu computador) e também grava a diferença em relação ao UTC (OffsetTimeOriginal), para que os apps possam mostrar o momento exato. Os cabeçalhos de vídeo armazenam UTC por definição; por isso, os vídeos recebem o momento exato e os apps o exibem no próprio fuso. Fotos tiradas em viagens vão mostrar o horário no fuso que você escolheu, não o horário local da viagem.

Minhas fotos são enviadas para algum lugar?

Não. Os arquivos ZIP são lidos pelo seu navegador, no seu próprio computador, e o arquivo corrigido também é gravado nele. Nada é enviado a um servidor: você pode se desconectar da internet depois que a página carregar, e ela continua funcionando.