Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kpym/gotoextr
Google Takeout Location History extractor to various formats: gpx, kml, tcx, csv, nmea.
https://github.com/kpym/gotoextr
csv geotagging google-takeout gpx json-parsing kml nmea0183 tcx
Last synced: 20 days ago
JSON representation
Google Takeout Location History extractor to various formats: gpx, kml, tcx, csv, nmea.
- Host: GitHub
- URL: https://github.com/kpym/gotoextr
- Owner: kpym
- License: mit
- Created: 2023-06-05T17:21:58.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-30T16:50:37.000Z (about 1 month ago)
- Last Synced: 2024-11-30T17:38:43.398Z (about 1 month ago)
- Topics: csv, geotagging, google-takeout, gpx, json-parsing, kml, nmea0183, tcx
- Language: Go
- Homepage:
- Size: 37.1 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# gotoextr
Small and durty program to extract GPX data from [Google Takeout Location History](https://takeout.google.com/settings/takeout/custom/location_history).
Hence the name: **Go**ogle **T**ake**o**ut Location History **Extr**actor → `gotoextr`.
## Usage
1. Download your location history from [Google Takeout](https://takeout.google.com/settings/takeout/custom/location_history) as `zip` archive.
2. Run `gotoextr` with the downloaded archive as argument. For example to extract data for January 1, 2023 run:
```bash
gotoextr -s 2023-01-01 takeout-20230501T000000Z-001.zip
```
The output will be written to the file `history_2023-01-01.gpx`.
You can also manually extract `Records.json` and use it as parameter. Once extracted this file is quite big (several hundred MB).
### Help message
```
$ gotoextr.exe -h
gotoextr [version: x.y.z] extract history data from Google Location History.
Usage:
gotoextr [-h] -s [options]
Options:
-h --help Show this screen.
-s Start date in YYYY-MM-DD format
-e End date in YYYY-MM-DD format [default: ]
-a Keeps only locations with accuracy less than meters [default: 40]
-t New track if coordinates have less than digits in common [default: 1]
-g New segment if coordinates have less than digits in common [default: 2]
-f Output format (gpx|kml|tcx|csv|nmea) [default: gpx]
-o Output file name [default: history__.]
Input file name (zip or json)
Examples:
gotoextr -s 2012-01-01 -e 2012-01-31 -a 40 takeout.zip
```
## Installation
You can download the latest binary from the [releases](github.com/kpym/gotoextr/releases) page.
Or you can install it from source:
```bash
go install github.com/kpym/gotoextr@latest
```
## Why?
I use my travel history to geotag my photos. I often use a tracking application to record my positions, but occasionally (often?) I forget to launch it. In this case, Google Takout (Location history) helps me by extracting my tracks in GPX format.
## Inspiration
This software is strongly inspired by [location-history-json-converter](https://github.com/Scarygami/location-history-json-converter) 🙏. But since the pyton application is rather slow, I decided to make one in go that is about 10x faster. The original application is also more complete, I only implemented the features I needed.
## License
[MIT](LICENSE)