¿Qué es el JSON de una imagen? Archivos JSON de Google Fotos
El JSON de una imagen es un archivo de texto que Google Fotos pone junto a cada foto al exportar: guarda la fecha, el GPS y la descripción. Cómo abrirlo y qué hacer.
El JSON de una imagen es un archivo de texto con el mismo nombre que la foto y la terminación .json, por ejemplo IMG_3391.HEIC.supplemental-metadata.json. No es una imagen ni la abre un visor de fotos: es la ficha de datos de esa foto.
Los archivos JSON de Google Fotos son pequeños archivos de texto que Google Takeout coloca junto a cada foto y vídeo al exportar. Guardan la fecha y hora en que se tomó la foto, la ubicación GPS, la descripción y el nombre original: todo lo que Google no escribió dentro de la imagen. Si los borras antes de usarlos, muchas fotos se quedan con la fecha de descarga.
Descargaste tu biblioteca con Google Takeout, descomprimiste el zip y la mitad de los archivos no son fotos. Junto a IMG_3391.HEIC aparece IMG_3391.HEIC.supplemental-metadata.json, y junto a cada vídeo, otro .json. Hay miles, casi ningún programa los abre y parecen basura. No lo son.
Por qué Google Fotos crea un JSON por cada foto
Google Fotos guarda lo que sabe de cada foto en su propia base de datos: cuándo se tomó, dónde, en qué álbum está, si es favorita y cualquier fecha o lugar que corrigieras a mano en la app. El archivo de imagen puede llevar o no esa información en su bloque EXIF. Las capturas de pantalla y las imágenes de WhatsApp casi nunca la llevan. Los cambios que hiciste dentro de Google Fotos, nunca.
Al exportar, Google te entrega el archivo tal como se subió, más o menos. No vuelca su base de datos dentro de cada imagen. En su lugar escribe la ficha de esa foto en un archivo de texto aparte, junto a la imagen. Ese archivo se llama "sidecar" (archivo complementario), y JSON es solo el formato en que está escrito.
Qué hay dentro de un archivo JSON de Google Fotos
Ábrelo con el Bloc de notas en Windows o con TextEdit en Mac. Un JSON típico, algo recortado:
{
"title": "IMG_3391.HEIC",
"description": "Cumpleaños de la abuela",
"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": 40.4168,
"longitude": -3.7038,
"altitude": 650.0,
"latitudeSpan": 0.0,
"longitudeSpan": 0.0
},
"geoDataExif": {
"latitude": 40.4168,
"longitude": -3.7038,
"altitude": 650.0
},
"url": "https://photos.google.com/photo/..."
}
Los campos que importan:
| Campo | Qué guarda |
|---|---|
photoTakenTime.timestamp | La fecha y hora de la foto, en segundos desde el 1 de enero de 1970, en UTC. Incluye las correcciones hechas en Google Fotos. Es el que hay que usar. |
creationTime | Cuándo se subió el archivo a Google. En el escaneo de una foto de 1985 subido en 2021 hay décadas de diferencia. |
geoData | La ubicación que conocía Google Fotos, incluidos los lugares puestos a mano. |
geoDataExif | La ubicación que tenía el EXIF del archivo al subirlo. |
title | El nombre original del archivo, útil cuando Takeout acorta el nombre real. |
description | El texto o pie de foto que escribiste, si lo hay. |
Dos detalles confunden a muchos scripts. El timestamp está en UTC: una foto hecha en Madrid a las 10:45 en verano aparece como 8:45 UTC y hay que pasarla a hora local. Y una foto sin ubicación lleva 0.0, 0.0 en geoData, un punto en el Atlántico frente a África. Esos ceros significan "desconocido", no un lugar. Lo explicamos en fotos de Google Takeout sin ubicación.
Cada carpeta de álbum tiene además un metadata.json que describe el álbum, no una foto: el título y a veces una fecha. Es pequeño e inofensivo.
Por qué tienen nombres tan raros
Las exportaciones antiguas llamaban al archivo IMG_3391.HEIC.json. Desde 2024 Google usa IMG_3391.HEIC.supplemental-metadata.json. El contenido es el mismo.
Además, Google corta el nombre del JSON a 46 caracteres. Una foto de un Pixel, PXL_20230721_092530123.jpg, acaba con un compañero llamado PXL_20230721_092530123.jpg.supplemental-m.json. Y cuando dos fotos se llaman igual, el contador va al final del JSON: IMG_3391(1).HEIC se empareja con IMG_3391.HEIC.supplemental-metadata(1).json. Un script que solo busca "nombre de la foto + .json" se salta todos estos casos. Los detalles, en supplemental-metadata.json explicado.
Cómo abrir un archivo JSON de Google Fotos
En Windows: clic derecho sobre el archivo, "Abrir con", Bloc de notas. En Mac: clic derecho, "Abrir con", TextEdit. También puedes arrastrarlo a una ventana de Chrome, Edge o Safari, que lo muestra ordenado.
Para leer la fecha sin hacer cuentas, mira el campo formatted que hay debajo del timestamp: es la misma fecha ya escrita, en UTC. En España suma una hora en invierno y dos en verano. En el centro de México resta seis horas; en Colombia, cinco.
¿Puedo borrar los archivos JSON?
Sí, pero solo después de haberlos usado. Si los borras antes, las fechas y ubicaciones que contienen desaparecen. Las fotos sin EXIF mostrarán para siempre la fecha de descarga, y la única forma de recuperar esos datos es pedir otro Takeout.
Si todas tus fotos ya tienen un EXIF correcto, los JSON aportan poco. Compruébalo con exiftool: exiftool -r -if 'not $DateTimeOriginal' -filename . lista cada foto sin fecha EXIF. Si la lista sale vacía, puedes borrarlos.
En casi todas las bibliotecas la lista no sale vacía. El orden seguro es: escribir los datos del JSON en las fotos, comprobar unas cuantas y luego borrar los .json. Immich y PhotoPrism leen los JSON de Takeout al importar, así que si vas a usar uno de ellos, guárdalos hasta terminar. Más en borrar los archivos JSON de Google Takeout.
Cómo pasar los datos del JSON a las fotos
Gratis, con línea de comandos
exiftool lee el JSON y escribe las etiquetas EXIF. El comando y sus trampas (nombres cortados, contadores (1), zona horaria) están en la guía de exiftool. GooglePhotosTakeoutHelper (GPTH) e immich-go son otras herramientas gratuitas de línea de comandos que leen los mismos archivos. Funcionan bien si no te asusta la terminal.
Con una aplicación para Windows y Mac
Takeout JSON Metadata Fixer hace el mismo trabajo como aplicación de escritorio para Windows y Mac, con la interfaz en español.
Le indicas la carpeta descomprimida o directamente los zip de Takeout. Para cada foto y vídeo lee el JSON, escribe photoTakenTime en el EXIF, pone la misma fecha como fecha de creación y de modificación del archivo, y escribe el GPS cuando existe (los ceros los ignora). En Mac también escribe la descripción. Reconoce los dos estilos de nombre, los nombres cortados y los contadores (1). Si quieres, renombra los archivos por fecha y lugar, los ordena en carpetas por año y mes y convierte HEIC a JPG. Todo se ejecuta en tu ordenador, sin subir nada. Las primeras 500 fotos son gratis y Premium cuesta 19,99 $ en un único pago. Más información en la página principal.
Preguntas frecuentes
¿Qué es el JSON de una imagen?
Es un archivo de texto que acompaña a una foto y guarda sus datos: fecha, lugar, descripción y nombre original. Los de Google Fotos los crea Google Takeout, uno por foto. Se abre con el Bloc de notas o con TextEdit.
¿Qué son los archivos JSON de Google Fotos?
Son los archivos complementarios que Google Takeout añade a cada foto y vídeo. Guardan la fecha de captura, la ubicación, la descripción y el nombre original tal como los tenía Google Fotos.
¿Hay un archivo JSON por cada foto?
Casi siempre. Las fotos que están en varios álbumes tienen una copia del JSON en cada carpeta de álbum. Algunos archivos no tienen JSON, sobre todo los clips de Live Photo y subidas muy antiguas; esos conservan la fecha que lleve el propio archivo.
¿Google Fotos vuelve a leer los JSON si subo las fotos otra vez?
No. Google Fotos ignora los JSON y usa el EXIF de cada archivo. Por eso quien mueve fotos entre dos cuentas de Google pierde las fechas si no las escribe antes dentro de las fotos.
¿Por qué mis fotos tienen la fecha de hoy después de exportarlas?
Porque la fecha correcta está en el JSON y no en el archivo, y el Explorador de Windows o el Finder muestran la fecha del archivo, que es la del día de la descarga. Lo explica fotos de Google Takeout con fecha incorrecta.
¿Ocupan mucho espacio?
No. Entre unos cientos de bytes y un par de kilobytes cada uno: diez mil suman unos 10 MB. El motivo para borrarlos es el desorden, no el espacio.