File JSON Google Foto: cosa sono e a cosa servono
I file JSON di Google Foto contengono data di scatto, GPS e descrizione di ogni foto esportata con Takeout. Cosa c'è dentro e quando eliminarli.
I file JSON di Google Foto sono piccoli file di testo che Google Takeout mette accanto a ogni foto e video esportato. Contengono la data e l'ora dello scatto, la posizione GPS, la descrizione e il nome originale, cioè le informazioni che Google non ha scritto dentro la foto: se li butti prima di usarli, molte foto perdono la loro data.
Hai scaricato il tuo archivio di Google Foto, hai estratto lo zip e metà dei file non sono foto. Accanto a IMG_3391.HEIC c'è IMG_3391.HEIC.supplemental-metadata.json, accanto a ogni video un altro .json. Sono migliaia, quasi nessun programma li apre e sembrano spazzatura. Non lo sono.
Perché Google Foto crea un file JSON per ogni foto
Google Foto conserva quello che sa di una foto nel proprio database: quando è stata scattata, dove, in quale album sta, se è tra i preferiti, e ogni data o luogo che hai corretto a mano nell'app. Il file immagine può avere o non avere queste informazioni nel suo blocco EXIF. Gli screenshot e le immagini arrivate da WhatsApp di solito non ce l'hanno. Le correzioni fatte in Google Foto non ci finiscono mai.
Quando esporti con Takeout, Google ti restituisce il file più o meno com'era stato caricato. Non riscrive il suo database dentro ogni file. Scrive invece la voce del database in un file di testo accanto all'immagine. Quel file di testo si chiama "sidecar", e JSON è solo il formato in cui è scritto.
Cosa c'è dentro un file JSON di Google Foto
Aprine uno con Blocco note su Windows o TextEdit su Mac. Un file tipico, un po' accorciato:
{
"title": "IMG_3391.HEIC",
"description": "Colosseo con la nonna",
"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": 41.8902,
"longitude": 12.4922,
"altitude": 35.0,
"latitudeSpan": 0.0,
"longitudeSpan": 0.0
},
"geoDataExif": {
"latitude": 41.8902,
"longitude": 12.4922,
"altitude": 35.0
},
"url": "https://photos.google.com/photo/..."
}
I campi che contano:
| Campo | Cosa contiene |
|---|---|
photoTakenTime.timestamp | Data e ora di scatto, in secondi dal 1° gennaio 1970, in UTC. Include le correzioni fatte in Google Foto. È il campo da usare. |
creationTime | Il momento del caricamento su Google. Per una scansione di una stampa del 1985 caricata nel 2021, sono decenni di differenza. |
geoData | La posizione come la conosceva Google Foto, compresi i luoghi impostati a mano. |
geoDataExif | La posizione che c'era nell'EXIF del file al momento del caricamento. |
title | Il nome originale del file, utile quando Takeout accorcia il nome reale. |
description | La didascalia che hai scritto, se c'è. |
Due dettagli fanno sbagliare molti script. Primo, il timestamp è in UTC: una foto scattata a Roma alle 10:45 d'estate compare come 8:45 UTC, e va convertita nell'ora locale. Secondo, una foto senza posizione ha 0.0, 0.0 in geoData, un punto nell'oceano Atlantico al largo dell'Africa. Gli zeri significano "sconosciuto", non un luogo. Ne parliamo in foto di Google Takeout senza posizione.
Ogni cartella di album ha anche un metadata.json che descrive l'album, non una foto: titolo, a volte una data e l'indicazione di album condiviso. È piccolo e innocuo.
Perché i nomi sono così strani
Le esportazioni più vecchie chiamavano il file IMG_3391.HEIC.json. Dal 2024 Google usa IMG_3391.HEIC.supplemental-metadata.json. Il contenuto è lo stesso.
Google però taglia il nome del file JSON a 46 caratteri. Una foto di un Pixel, PXL_20230721_092530123.jpg, si ritrova con PXL_20230721_092530123.jpg.supplemental-m.json. Quando due foto hanno lo stesso nome, il contatore finisce in fondo al JSON: IMG_3391(1).HEIC si abbina a IMG_3391.HEIC.supplemental-metadata(1).json. Uno script che cerca solo "nome foto + .json" salta tutti questi casi. I dettagli sono in supplemental-metadata.json spiegato.
Come leggere un file JSON di Google Foto
Su Windows: tasto destro sul file, "Apri con", Blocco note. Su Mac: tasto destro, "Apri con", TextEdit. Il browser funziona su entrambi: trascina il file in una finestra di Chrome, Edge o Safari e lo vedi formattato.
Per trasformare il timestamp in una data leggibile, guarda il campo formatted subito sotto: è la stessa data, già scritta, in UTC. Aggiungi un'ora d'inverno o due d'estate per l'ora italiana.
Si possono eliminare i file JSON?
Sì, ma solo dopo averli usati. Se li elimini prima, le date e le posizioni che contengono sono perse. Le foto senza EXIF mostreranno per sempre la data del download, e l'unico modo di recuperare l'informazione è rifare l'esportazione con Takeout.
Se tutte le foto hanno già un EXIF corretto, i JSON aggiungono poco. Puoi controllarlo con exiftool: exiftool -r -if 'not $DateTimeOriginal' -filename . elenca ogni foto senza data EXIF. Se l'elenco è vuoto, puoi eliminarli.
Per la maggior parte delle librerie l'elenco non è vuoto. L'ordine sicuro è: scrivi i dati dei JSON dentro le foto, controllane qualcuna, poi elimina i .json. Immich e PhotoPrism leggono i JSON di Takeout durante l'importazione, quindi se la destinazione è una di queste, tienili fino a importazione finita. Più dettagli in eliminare i file JSON di Google Takeout.
Rimettere i dati del JSON dentro le foto
Gratis, da riga di comando
exiftool legge il JSON e scrive i tag EXIF. Il comando e le sue trappole (nomi troncati, contatori (1), fuso orario) sono nella guida a exiftool. GooglePhotosTakeoutHelper (GPTH) e immich-go sono altri strumenti gratuiti da riga di comando che leggono gli stessi file. Funzionano bene se il terminale non ti spaventa.
Con un'app per Windows e Mac
Takeout JSON Metadata Fixer fa lo stesso lavoro come app desktop per Windows e Mac, con l'interfaccia in italiano.
Gli indichi la cartella estratta o direttamente gli zip di Takeout. Per ogni foto e video legge il JSON, scrive photoTakenTime nell'EXIF, imposta le date di creazione e modifica del file allo stesso valore e scrive le coordinate GPS quando ci sono (gli zeri li ignora). Su Mac scrive anche la descrizione. Conosce i due stili di nome, i nomi troncati e i contatori (1). Se vuoi, rinomina i file per data e luogo, li ordina in cartelle per anno e mese e converte HEIC in JPG. Tutto gira sul tuo computer, niente viene caricato online. Le prime 500 foto sono gratuite, Premium costa 19,99 $ una volta sola. Trovi l'app sulla pagina principale.
Domande frequenti
Cosa sono i file JSON di Google Foto?
Sono i file "sidecar" che Google Takeout aggiunge a ogni foto e video. Contengono data di scatto, posizione, descrizione e nome originale presi dal database di Google Foto.
C'è un file JSON per ogni foto?
Quasi sempre. Le foto presenti in più album hanno una copia del JSON in ogni cartella di album. Alcuni file non ne hanno, più spesso le clip delle Live Photo e caricamenti molto vecchi: quelli tengono la data scritta nel file.
Google Foto rilegge i file JSON se ricarico le foto?
No. Google Foto ignora i JSON e usa l'EXIF dei file. Per questo chi sposta le foto tra due account Google perde le date se prima non le scrive nelle foto.
Perché le foto hanno la data di oggi dopo l'esportazione?
Perché la data giusta è nel JSON e non nel file, e Windows o il Mac mostrano la data del file, cioè il giorno del download. Vedi foto di Google Takeout con la data sbagliata.
I file JSON occupano molto spazio?
No. Da qualche centinaio di byte a un paio di kilobyte l'uno: diecimila file sono circa 10 MB. Il motivo per eliminarli è il disordine, non lo spazio.