# timeline-export: decoding Google Maps Timeline sync and place IDs

> timeline-export reconstructs Google Maps Timeline retrieval and decoding to export on-device location history as JSON. It calls Geller BatchSync, decrypts AES-256-GCM payloads, decodes SemanticSegment records and converts stored FeatureId values to Maps place IDs.

- Type: Case study
- Targets: App · Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-08
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/arkenoi/timeline-export>
- Primary source: <https://github.com/arkenoi/timeline-export/blob/3c1faa0c1d375ec7d7faf31d4789c8a69637a6ec/README.md>
- Catalog page: <https://awesomerea.org/resources/timeline-export-case/>
- Record JSON: <https://awesomerea.org/resources/timeline-export-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/timeline-export-case/index.md)

## Requirements & limits

- **Prerequisites:** Requires access to the user's Google account, its Timeline decryption key and the documented Python dependencies.
- **Limits:** Some semanticType labels are best-effort; placeTypeCode is emitted without a complete category mapping.
- **License:** MIT License.

## Primary sources

1. <https://github.com/arkenoi/timeline-export/blob/3c1faa0c1d375ec7d7faf31d4789c8a69637a6ec/README.md>

## More in Apps

- [waze-stuff: mapping Waze tile formats](https://awesomerea.org/resources/waze-stuff-case/index.md) · Case study
- [Notepad Tabs: mapping saved tab files](https://awesomerea.org/resources/notepad-tabs-format-case/index.md) · Case study
- [MovieOkeAI: investigating and rebuilding MovieBot](https://awesomerea.org/resources/movieokeai-case/index.md) · Case study
- [xLamp: LampSmartPro lamp-control protocol and Android client](https://awesomerea.org/resources/xlamp-case/index.md) · Case study
- [Slovak Telekom App API: mapping the mobile service requests](https://awesomerea.org/resources/slovak-telekom-app-api-case/index.md) · Case study
- [dyson-lamp-ble: reconstructing local control of a Dyson lamp](https://awesomerea.org/resources/dyson-lamp-ble-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.