O que é JSON da imagem? O arquivo .json das suas fotos
O que é JSON da imagem: o arquivo .json que o Google Takeout coloca ao lado de cada foto, com a data, o GPS e a legenda. Pode apagar? Veja.
O JSON da imagem é um pequeno arquivo de texto com os dados de uma foto: a data e a hora em que ela foi tirada, a localização GPS, a legenda e o nome original. Ele aparece com o mesmo nome da foto e final .json (por exemplo IMG_3391.jpg.supplemental-metadata.json), quase sempre depois de baixar as fotos do Google Fotos pelo Google Takeout. Não é vírus nem lixo: sem ele, muitas fotos perdem a data certa.
Você baixou as fotos do Google, descompactou o zip e metade dos arquivos não abre. Ao lado de cada foto e de cada vídeo tem um .json com o mesmo nome. São milhares, o Windows não sabe o que fazer com eles e a vontade é apagar tudo. Espere um pouco.
Por que cada imagem vem com um JSON
O Google Fotos guarda o que sabe de cada foto no próprio banco de dados: quando foi tirada, onde, em qual álbum está, se é favorita e qualquer data ou lugar que você corrigiu no app. O arquivo da foto pode ou não ter essas informações dentro dele, no bloco EXIF. Prints e imagens do WhatsApp quase nunca têm. As correções feitas no Google Fotos nunca vão para dentro do arquivo.
Na exportação, o Google entrega a foto mais ou menos como ela foi enviada. Em vez de gravar os dados dentro de cada imagem, ele escreve a ficha da foto em um arquivo de texto separado, ao lado dela. Esse arquivo se chama sidecar ("arquivo acompanhante"), e JSON é só o formato do texto.
O que tem dentro do JSON da imagem
Abra um no Bloco de Notas (Windows) ou no TextEdit (Mac). Um JSON típico, resumido:
{
"title": "IMG_3391.jpg",
"description": "Aniversário da vó",
"imageViews": "12",
"creationTime": {
"timestamp": "1690120442",
"formatted": "Jul 23, 2023, 1:54:02 PM UTC"
},
"photoTakenTime": {
"timestamp": "1689929130",
"formatted": "Jul 21, 2023, 8:45:30 AM UTC"
},
"geoData": {
"latitude": -22.9519,
"longitude": -43.2105,
"altitude": 35.0,
"latitudeSpan": 0.0,
"longitudeSpan": 0.0
},
"geoDataExif": {
"latitude": -22.9519,
"longitude": -43.2105,
"altitude": 35.0
},
"url": "https://photos.google.com/photo/..."
}
Os campos que importam:
| Campo | O que guarda |
|---|---|
photoTakenTime.timestamp | Data e hora em que a foto foi tirada, em segundos desde 1º de janeiro de 1970, em UTC. Inclui as correções feitas no Google Fotos. É este que vale. |
creationTime | Quando o arquivo foi enviado ao Google. Numa foto antiga digitalizada, pode ter décadas de diferença. |
geoData | A localização que o Google Fotos conhecia, inclusive lugares definidos na mão. |
geoDataExif | A localização que estava no EXIF do arquivo quando ele foi enviado. |
title | O nome original do arquivo. |
description | A legenda que você escreveu, se houver. |
Dois detalhes confundem muita gente. O horário está em UTC: no exemplo, 8:45 UTC são 5:45 no horário de Brasília. E uma foto sem localização tem 0.0, 0.0 no geoData, um ponto no meio do Atlântico. Zero quer dizer "desconhecido", não um lugar. Veja fotos do Takeout sem localização.
Cada pasta de álbum também tem um metadata.json, que descreve o álbum e não uma foto. É pequeno e inofensivo.
Por que os nomes são tão estranhos
Exportações antigas chamavam o arquivo de IMG_3391.jpg.json. Desde 2024 o Google usa IMG_3391.jpg.supplemental-metadata.json. O conteúdo é o mesmo.
O Google também corta o nome do JSON em 46 caracteres. A foto PXL_20230721_092530123.jpg, de um Pixel, fica com um JSON chamado PXL_20230721_092530123.jpg.supplemental-m.json. E quando duas fotos têm o mesmo nome, o contador vai para o final do JSON: IMG_3391(1).jpg faz par com IMG_3391.jpg.supplemental-metadata(1).json. Os detalhes estão em supplemental-metadata.json explicado.
Como abrir o JSON da imagem
No Windows: botão direito no arquivo, "Abrir com", Bloco de Notas. No Mac: botão direito, "Abrir com", TextEdit. Também dá para arrastar o arquivo para uma janela do Chrome ou do Edge, que mostra o texto organizado. Para ler a data sem conta, olhe o campo formatted embaixo do timestamp e tire 3 horas para o horário de Brasília.
Posso apagar os arquivos JSON?
Pode, mas só depois de usar. Se apagar antes, as datas e os locais que estão neles somem. As fotos sem EXIF vão mostrar para sempre a data do download, e o único jeito de recuperar é pedir um novo Takeout.
Se todas as suas fotos já têm EXIF certo, os JSON acrescentam pouco. Dá para conferir com o exiftool: exiftool -r -if 'not $DateTimeOriginal' -filename . lista cada foto sem data EXIF. Lista vazia, pode apagar.
Na maioria das bibliotecas a lista não sai vazia. A ordem segura é: gravar os dados do JSON dentro das fotos, conferir algumas e só então apagar os .json. Mais em posso apagar os arquivos JSON do Google Takeout?.
Como colocar os dados do JSON dentro das fotos
De graça, pela linha de comando
O exiftool lê o JSON e grava as tags EXIF. O comando e as armadilhas estão no guia do exiftool. O GooglePhotosTakeoutHelper (GPTH) e o immich-go também são gratuitos e leem os mesmos arquivos. Funcionam bem para quem se sente à vontade no terminal.
Com um programa para Windows e Mac
O Takeout JSON Metadata Fixer faz o mesmo trabalho como programa de computador para Windows e Mac, com a interface em português.
Você aponta a pasta descompactada ou os próprios zips do Takeout. Para cada foto e vídeo ele lê o JSON, grava a data do photoTakenTime no EXIF, acerta as datas de criação e modificação do arquivo e grava o GPS quando existe (zeros ele ignora). No Mac, grava também a legenda. Ele reconhece os nomes cortados e os contadores (1). Se quiser, renomeia as fotos por data e lugar, organiza em pastas por ano e mês e converte HEIC para JPG. Tudo roda no seu computador, nada é enviado. As primeiras 500 fotos são grátis, e o Premium custa US$ 19,99 uma vez só. Veja a página inicial.
Perguntas frequentes
O que é JSON da imagem?
É o arquivo de texto que acompanha a foto numa exportação do Google Fotos. Ele guarda a data da captura, a localização, a legenda e o nome original.
O JSON é vírus?
Não. É texto puro, que não executa nada. Você pode abrir no Bloco de Notas e ler tudo o que tem dentro.
Por que minhas fotos estão com a data de hoje depois de baixar?
Porque a data certa está no JSON e não dentro da foto, e o Windows mostra a data do arquivo, que é a do download. Veja fotos do Google Takeout com data errada.
O Google Fotos lê o JSON se eu enviar as fotos de novo?
Não. Ele ignora o JSON e usa o EXIF. Por isso quem muda de conta Google perde as datas se não gravar antes dentro das fotos.
Os JSON ocupam muito espaço?
Não. Poucos kilobytes cada: dez mil dão uns 10 MB. O motivo para apagar é a bagunça, não o espaço.