{"id":13586289,"url":"https://github.com/dmsza/json2kml","last_synced_at":"2025-04-07T15:31:30.531Z","repository":{"id":54127340,"uuid":"81449320","full_name":"dmsza/json2kml","owner":"dmsza","description":"Python scripts to export Google Maps saved/starred places to KML, CSV, Sygic","archived":false,"fork":false,"pushed_at":"2022-11-07T03:33:11.000Z","size":67,"stargazers_count":47,"open_issues_count":4,"forks_count":7,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-04-12T00:47:29.899Z","etag":null,"topics":["csv","google","google-maps","gps","kml","maps-me","navigation","poi","pois","sygic","takeout-data"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dmsza.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-02-09T12:44:14.000Z","updated_at":"2024-03-15T09:33:53.000Z","dependencies_parsed_at":"2023-01-22T10:01:01.795Z","dependency_job_id":null,"html_url":"https://github.com/dmsza/json2kml","commit_stats":null,"previous_names":["dmsza/json2kml"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmsza%2Fjson2kml","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmsza%2Fjson2kml/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmsza%2Fjson2kml/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmsza%2Fjson2kml/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dmsza","download_url":"https://codeload.github.com/dmsza/json2kml/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247679447,"owners_count":20978054,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["csv","google","google-maps","gps","kml","maps-me","navigation","poi","pois","sygic","takeout-data"],"created_at":"2024-08-01T15:05:27.254Z","updated_at":"2025-04-07T15:31:30.270Z","avatar_url":"https://github.com/dmsza.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Export Google Maps saved/starred locations to KML/CSV/Sygic\n\nThis repository contain three [Python 3](https://www.python.org/downloads/) scripts that can be used to **export starred locations from Google Maps to other formats** which then can be imported by GPS navigation apps or other POI convertion tools. The three scrips are:\n\n* **json2kml**: this script converts the list of starred/saved places (a.k.a. POIs) from Google Maps into a **KML file** that can be imported into various GPS navigation applications (suchs as MAPS.ME).\n\n* **json2csv**: this script converts the list of starred/saved places (a.k.a. POIs) from Google Maps into a **CSV** (*Comma Separated Values*) file that can be imported into some POI convertion tools or edited directly in Excel.\n\n* **json2sygic**: this script converts the list of starred/saved places (a.k.a. POIs) from Google Maps into the internal format used by Sygic Android to save its favorites (**\"items.dat\"**) file.\n\n## How to export Google Maps saved/starred locations to a JSON file\n\n1.\tGo to Google Takeout (https://takeout.google.com/settings/takeout). \n2.\tClick “Select None” and then select “Maps (your places)”. Make sure this is the only option selected.\n3.\tGoogle will export a ZIP file. Save this file to your local disk, open it and extract the file “\\Takeout\\Maps (your places)\\Saved Places.json” to a directory in your PC (do not change the file name).\n4.\tDownload one of the scripts below and save to the same directory where you saved \"Saved Places.json\".\n\n## json2kml\n\nThis script depends on [“SIMPLEKML” library] (https://simplekml.readthedocs.io/) and it can be installed via pip with the following command line (on Windows you may need to run this command in Command Prompt _Admin_):\n```\npip install simplekml\n```\nAfter this, the following steps must be executed to generate the KML file from the Google Maps starred/saved locations:\n\n1. First go to Google Takeout and save the _\"Saved Places.json\"_ file to a folder on your local disk. More details in the above section [\"How to export Google Maps saved/starred locations\"] (#how-to-export-google-maps-savedstarred-locations-to-a-json-file).\n2. Download and save the Python script [json2kml.py] (https://raw.githubusercontent.com/dmrsouza/json2kml/master/json2kml.py) to the same folder where the file _\"Saved Places.json\"_ is located.\n3. Open a command prompt, change the current directory to where the above files were saved, and run the script with the command line `python json2kml.py`\n4.\tThe script will run and will create the file _“Saved Places.kml”_.\n\n## json2csv\n\n1. First go to Google Takeout and save the _\"Saved Places.json\"_ file to a folder on your local disk. More details in the above section [\"How to export Google Maps saved/starred locations\"] (#how-to-export-google-maps-savedstarred-locations-to-a-json-file).\n2. Download and save the Python script [json2csv.py] (https://raw.githubusercontent.com/dmrsouza/json2kml/master/json2csv.py) to the same folder where the file _\"Saved Places.json\"_ is located.\n3. Open a command prompt, change the current directory to where the above files were saved, and run the script with the command line: `python json2csv.py`\n4. The script will run and will create the file _“Saved Places.csv”_.\n5. Use this file with other convertion tools or open it in Excel.\n\n## json2sygic\n\n1. First go to Google Takeout and save the _\"Saved Places.json\"_ file to a folder on your local disk. More details in the above section [\"How to export Google Maps saved/starred locations\"] (#how-to-export-google-maps-savedstarred-locations-to-a-json-file).\n2. Download and save the Python script [json2sygic.py] (https://raw.githubusercontent.com/dmrsouza/json2kml/master/json2sygic.py) to the same folder where the file _\"Saved Places.json\"_ is located.\n3. Open a command prompt, change the current directory to where the above files were saved, and run the script with the command line `python json2sygic.py`\n4. The script will run and will create the file _“items.dat”_.\n5. Copy the file _“items.dat”_ to your Android device. See notes below for more details about the folder to where this file must be copied. **IMPORTANT**: when overwriting \"items.dat\" files, **all current Sygic favorites _will be lost_**. Keep this in mind.\n\n**Notes:**\n\n* In Android devices, Sygic saves the favorites to file \"items.dat\" (it's a SQLite3 database). This file is located in folder _\"/Sygic/Res/db/items.dat\"_ if Sygic is configured to use internal storage or in folder _\"/Android/data/com.sygic.aura/files/Res/db/items.dat\"_ if Sygic is configured to use external SD card.\n* This script creates a new \"items.dat\" file with all saved places from Google. This file needs to be copied to one of the above foldres.\n* **IMPORTANT**: when overwriting \"items.dat\" files, **all current Sygic favorites _will be lost_**. Keep this in mind.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmsza%2Fjson2kml","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdmsza%2Fjson2kml","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmsza%2Fjson2kml/lists"}