https://github.com/panmari/locationhistory

A library and toolkit for visualizing location history data exported from Google.
https://github.com/panmari/locationhistory

locationhistory visualization-tools

Last synced: 9 months ago
JSON representation

A library and toolkit for visualizing location history data exported from Google.

• Host: GitHub
• URL: https://github.com/panmari/locationhistory
• Owner: panmari
• Created: 2024-04-24T19:32:12.000Z (almost 2 years ago)
• Default Branch: master
• Last Pushed: 2025-01-17T09:35:16.000Z (about 1 year ago)
• Last Synced: 2025-01-17T10:32:02.856Z (about 1 year ago)
• Topics: locationhistory, visualization-tools
• Language: Go
• Homepage:
• Size: 82 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Visualize Location History

Libraries and some tools for creating engaging visualization from location history data. 

Most easily extracted from Google Takeout.

## Examples

The implemented visualizations help showing how your year went in relation to a *anchor* location, think home/work. This lets you easily identify days where you stayed home, worked or were on a trip!

In this example, we see a week long trip in the middle of the year and a 3 month trip towards the end of the year.

![Barchart example](example_images/barchart_example.PNG)

![Heatmap example](example_images/heatmap_example.png)

## Instructions

1. Visit https://takeout.google.com/ and request downloading location history data.

2. Wait for data to be ready.

3. Download data, then run script directly on the archive downloaded, for example 

    go run .\cmd/takeout_to_chart/main.go --input=.\takeout.zip --anchors=2014-01-01,10.0,10.0:2016-02-01,20.0,20.0

### Use as library

The parser is a non-trivial piece of code. Consider using it as library in your own project:

```go

import "github.com/panmari/locationhistory/internal/reader"

// ...

r, err := reader.OpenFile(*input)

if err != nil {

    log.Fatalf("Error when reading %s: %v", *input, err)

}

decoded, err := reader.DecodeJson(r)

if err != nil {

    log.Fatalf("Error when decoding %s: %v", *input, err)

}

// do something interesting with `decoded`

```