# luka1199/geo-heatmap

:world_map: Generate an interactive geo heatmap from your Google location data

Repository: https://github.com/luka1199/geo-heatmap
Canonical: https://ross.abutalabs.com/products/geo-heatmap
Language: Python
License: MIT
License Family: permissive
Topics: heatmap, heatmaps, google-location-history, openstreetmap, folium, google, python, geo-heatmap
Last push: 2024-08-17T16:08:23+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 2612, "days_push": 746, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2055, forks 227 (observed 2026-08-28T04:06:09.882254+00:00)

## What it is
A Python CLI script that generates an interactive geographic heatmap from Google Takeout location history data (JSON, KML, ZIP) or GPX files, using Folium and OpenStreetMap. It supports streaming for large files and date-range filtering.

## Use cases
- visualize my google location history as a heatmap
- generate a map of everywhere i've been from google takeout
- create an interactive heatmap from gpx tracks
- plot location data from records. on a map
- filter my location history by date range and map it
- make a travel heatmap from gps tracker data

## When to choose
- you have Google Takeout location data or GPX files and want a quick interactive map
- you want a simple one-command Python script with no server or account needed
- you need to handle large location files via streaming or filter by dates

## When to avoid
- you need real-time location tracking or live dashboards
- you want a GUI application rather than a command-line script
- your location data is not in JSON, KML, ZIP, or GPX format

## Facets
- artifact type: cli-tool
- maturity: stable
- function: data-visualization, cli, geospatial, parser
- domain: data-visualization, privacy
- platform: python, cli, cross-platform
- tags: heatmap, google-takeout, location-history, folium, openstreetmap, gpx, maps, command-line

## Member repositories
- luka1199/geo-heatmap (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:09.882254+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:57:16.335105+00:00, confidence not recorded.
  - readme: https://github.com/luka1199/geo-heatmap (fetched 2026-08-28T04:06:09.882254+00:00, sha 4f3a7d1c903c)
- Data as of 2026-08-30T08:39:29.467469+00:00.