// the find
luka1199/geo-heatmap
:world_map: Generate an interactive geo heatmap from your Google location data
A Python script that turns Google Takeout location history into an interactive HTML heatmap using Folium and OpenStreetMap. Single-purpose, runs locally, handles JSON/KML/GPX/ZIP input. Aimed at anyone curious about visualizing years of their own location data.
Accepts multiple input formats including raw takeout ZIP, which saves the extraction step. The streaming mode (-s flag) is a practical fix for people with years of location history who'd otherwise hit MemoryError. Date range filtering lets you isolate a specific period without preprocessing the file. Produces a standalone HTML file — no server, no dependencies at view time.
Last commit was mid-2024 and Google has changed the Takeout format multiple times; there are open issues about the newer Records.json format from 2023+ that breaks parsing. It's a single 300-line script with no tests, so when the input format breaks again there's no safety net. The heatmap parameters (radius, blur, opacity) require trial and error with no preview — you re-run the full script each time. No way to filter by transport mode or activity type, so a year of driving data and a year of walking data produce the same undifferentiated blob.