README.md

google_timeline_parse

Find how many days you are out of your own home country.

Requirements

• A copy of your Google Timeline in JSON
• location-history-json-converter
• Python
  • Pandas
  • reverse-geocoder
  • json
  • csv

Instructions

• Clone
• Convert Google Timeline JSON to less heavy file using location-history-json-converter
  • e.g. python location_history_json_converter.py location.json timeline_raw.csv -f csv
• If running for the firs time, ensure skip = False in main()
• python parse.py (this assumes taking in CSV)
• Look for newly generated files.

CLI Switches

❯ python parse.py --help
Usage: parse.py [OPTIONS]

Options:
  --skip-country-lookup          Whether to skip the reverse geocoding lookup
  --raw-csv TEXT                 CSV Google Timeline Raw Output (from
                                 location-history-json-converter

  --country-csv TEXT             Reverse Geocoded CSV with countries
  --home-country TEXT            Home Country Code
  --count-part-day               Whether to partial days as full day out of
                                 country

  --min-entries-per-day INTEGER  Minimum entries per day of that country to
                                 filter out false positives

  --help                         Show this message and exit.