Google Maps Import

Import your Google Maps saved places from Takeout export to your Obsidian vault.

Features

• Import all your Google Takeout files at once (GeoJSON and CSV supported)
• Visualize your places on a map with Obsidian Bases Map view (requires obsidian-maps)
• Tags are merged automatically when a place appears in multiple lists
• Non-destructive: your notes and custom content are always preserved

Installation

1. Download obsidian-google-maps.zip from the latest release
2. Extract and place the obsidian-google-maps folder into your vault's .obsidian/plugins/ directory
3. Enable the plugin in Settings → Community plugins

Usage

1. Export your saved places from Google Takeout

1. Go to Google Takeout

2. Deselect all, then select only Google Maps (your places)

3. Download and extract the archive

4. Locate export files:

   • GeoJSON: Saved Places.json (includes coordinates)
   • CSV: Files in the lists folder, e.g., Favourites.csv (includes list names as tags)

   Import both together to get coordinates with list tags.

2. Run the import command

1. Open Command Palette (Cmd/Ctrl + P)
2. Run Google Maps Import: Import from Takeout
3. Select the extracted folder (e.g., ~/Downloads/Takeout)
4. Notes will be created in your configured output folder

Settings

Setting	Description	Default
Output Folder	Where place notes are created	Google Maps/Places

Note Format

Each place note contains frontmatter only, leaving the body empty for your own content:

---
source: google-maps-takeout
gmap_id: "cid-12345678"
gmap_url: "https://maps.google.com/?cid=12345678"
coordinates: [35.6586, 139.7454]
address: "Shibakoen 4-2-8, Minato-ku"
tags: ["gmap/Favourites", "cafe"]
last_imported_at: "2024-01-15T12:00:00.000Z"
---

The tags field includes gmap/ prefixed list names (e.g., Favourites.csv → gmap/Favourites) and any tags from the CSV column. Re-importing merges tags without duplication.

Development

For contributors and developers who want to build from source:

1. Clone this repository into your vault's plugins folder:

   cd /path/to/your/vault/.obsidian/plugins
   git clone https://github.com/MH4GF/obsidian-google-maps.git
   cd obsidian-google-maps
   

2. Install dependencies and build:

   bun install
   bun run build
   

3. Enable the plugin in Settings → Community plugins

See AGENTS.md for detailed development instructions.

License

0BSD