Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

google-findmy-map

Herramienta autoalojada para visualizar dispositivos de Google Find My en un mapa web, con historial de ubicación y línea de tiempo de lugares visitados. Complemento de GoogleFindMyTools usando Docker.

Ficha actualizada 22 sept 2026, 15:29 · upstream 21 sept 2026, 21:17 · release v0.1.8

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es google-findmy-map

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

Este proyecto permite visualizar la ubicación de dispositivos registrados en "Find My Device" (teléfonos, rastreadores ESP32) en un mapa real basado en Leaflet y OpenStreetMap. Incluye historial de trayectoria para rangos temporales específicos y una lista orientada a texto de lugares visitados, similar al cronograma de Google.

Utiliza FastAPI y Next.js para el backend y frontend respectivamente, almacenando datos en SQLite. Ofrece una interfaz web completa con modo oscuro, gestión de dispositivos (edición, grupos) y exportación de datos a GPX, GeoJSON o CSV. Incluye un asistente de configuración opcional para autenticación sin exponer credenciales directamente al código de la aplicación.

Es importante destacar que el proyecto no está afiliado a Google ni Apple. El despliegue es seguro si se configura correctamente con HTTPS y gestión adecuada de permisos de usuario (PUID/PGID) en los volúmenes de datos sensibles como secrets.json y la base de datos SQLite.

CASOS DE USO
  • Monitoreo de mascotas o activos personales
  • Visualización histórica de ubicación de dispositivos móviles
  • Gestión de múltiples rastreadores ESP32 en un mapa único
  • Exportación de rutas para análisis externo (GPX/CSV)
PUNTOS DESTACADOS
  • Soporte Docker con docker-compose.yml incluido
  • Asistente de configuración integrado para tokens de Google
  • Almacenamiento persistente en SQLite con migraciones automáticas
  • Interfaz web responsive con modo oscuro y temas personalizables
PRECAUCIONES
  • El historial de ubicación crece sin límite por defecto si no se configura retención
  • Los lugares semánticos (ej. "Casa") no muestran pin en el mapa al no tener coordenadas
  • Requiere regenerar secrets.json al cambiar la versión de clave del propietario
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU2 vCPUrecomendación inicial
MEMORIA2 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADmediumnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Listo para automatizar

Usa docker compose up -d. Variables clave: GFM_SECRETS_FILE, GFM_DATA_DIR, PUID/PGID. Requiere HTTPS si se habilita autenticación. No montar Auth/ completo, solo secrets.json. Verificar permisos de directorio antes de iniciar.

✓Dockerfile
✓Compose
✓One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Next.jsFastAPIPython
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
8080
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

Experiencia real de la comunidad

Ayuda a contrastar la estimación automática con instalaciones reales.

Todavía no hay datos comunitarios para este proyecto.