{"id":20207723,"url":"https://github.com/k3b/locationmapviewer","last_synced_at":"2025-06-28T04:35:24.975Z","repository":{"id":26015896,"uuid":"29458564","full_name":"k3b/LocationMapViewer","owner":"k3b","description":"Android App to view Locations in a map with support for gpx, kml and kmz data","archived":false,"fork":false,"pushed_at":"2023-10-23T13:44:39.000Z","size":1602,"stargazers_count":37,"open_issues_count":12,"forks_count":15,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-24T11:37:45.417Z","etag":null,"topics":["android","android-app","geo-uri","geodata","gpx","intent-interface","kml","kmz","map-viewer","openstreetmap","osm"],"latest_commit_sha":null,"homepage":"","language":"Java","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/k3b.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-01-19T07:16:05.000Z","updated_at":"2024-12-26T10:58:09.000Z","dependencies_parsed_at":"2024-11-14T05:31:48.370Z","dependency_job_id":"e2a05c92-c32b-45db-9ac1-670f1e5f625e","html_url":"https://github.com/k3b/LocationMapViewer","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/k3b%2FLocationMapViewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/k3b%2FLocationMapViewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/k3b%2FLocationMapViewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/k3b%2FLocationMapViewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/k3b","download_url":"https://codeload.github.com/k3b/LocationMapViewer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248217159,"owners_count":21066634,"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":["android","android-app","geo-uri","geodata","gpx","intent-interface","kml","kmz","map-viewer","openstreetmap","osm"],"created_at":"2024-11-14T05:31:37.319Z","updated_at":"2025-04-10T12:42:27.207Z","avatar_url":"https://github.com/k3b.png","language":"Java","readme":"# LocationMapViewer ![](https://github.com/k3b/LocationMapViewer/blob/master/LocationMapViewer/src/main/res/drawable/ic_launcher.png)\n\nAn Android app to display geographic information from url or local gpx/kml/kmz/zip file in a [map](map). \n\nIt has support for **gpx**, **kml** and **kmz** files and **geo-uri-s**\nand can work offline (without internet/wifi)\nonce geodata is downloaded and cached.\n\n![](https://github.com/k3b/LocationMapViewer/blob/master/fastlane/metadata/android/en-US/images/phoneScreenshots/1-LocationMapViewer.png)\n\nOther Android apps can use LocationMapViewer through an Intent interface\n(see [GeoIntentDemo.java](https://github.com/k3b/LocationMapViewer/blob/master/geoIntentDemo/src/main/java/de/k3b/android/locationMapViewer/demo/GeoIntentDemoActivity.java) )\nor through html links like \u0026lt;a href=\u0026quot;geo:0,0?q=53.0,8.0(Hello)\u0026quot;\u0026gt;geo:0,0?q=53.0,8.0(Hello)\u0026lt;/a\u0026gt;\u003cbr/\u003e\n\n## Minimal requirements: \n\n* version v0.3.5.170911(6) \n  * Android-2.3.7 - Android-7 (API 10ff)   \n* version v0.3.7.210429 \n  * Android-4.1 and later (API 16ff) \n  * compatible with android-10\n* internet/wifi-connection to download geodata and a SD-Card to cache geodata\u003cbr/\u003e\n\nLicence: [GPLv3](http://www.gnu.org/licenses/gpl-3.0)\u003cbr/\u003e\n\n## Required permissions:\n\n* INTERNET: to download map data from Open Streetmap Server\n* ACCESS_NETWORK_STATE and ACCESS_WIFI_STATE: to find out if wifi/internet is online to start downloaded geodata \n* WRITE_EXTERNAL_STORAGE\n    * to cache downloaded map data in local file system\n    * to load gpx/kml-Files to be displayed in the map\n* ACCESS_FINE_LOCATION and ACCESS_COARSE_LOCATION: to display my own location in the map, too\n\nThe code uses [osmdroid library](https://github.com/osmdroid/osmdroid)\nwith [osmbonuspack library](http://code.google.com/p/osmbonuspack/)\nto display maps from [Open Street Map](http://www.openstreetmap.org).\n\n## Intent Interface\n\nOther Android apps can use LocationMapViewer as plug-in/device-driver through an Intent interface\nor through html-a-href-links.\n\nExamples:\n\n* uri=geo:...  displays (and zomms to) a [geo uri](http://tools.ietf.org/html/draft-mayrhofer-geo-uri-00)\n    * geo:0,0?q=53.0,8.0(Hello)\n        * displays \"hello\" at the location lat=53.0 north and lon= 8.0 east.\n        * in html you can use \u0026lt;a href=\u0026quot;geo:0,0?q=53.0,8.0(Hello)\u0026quot;\u0026gt;geo:0,0?q=53.0,8.0(Hello)\u0026lt;/a\u0026gt;\n        * this format is compatible with google-maps for android\n    * geo:53.0,8.0?q=(Hello)\n        * displays \"hello\" at the location lat=53.0 north and lon= 8.0 east\n        * this format is **not** compatible with google-maps for android\n    * geo:53.0,8.0?z=6\n        * displays a pin at the location using zoomlevel \"6\"\n* uri=file:/path/to/waypoints.gpx\n    * displays a xml+gpx waypointfile\n* uri=content:/path/to/waypoints.kml\n    * displays a vnd.google-earth.kml+xml waypointfile\n\nLocationMapViewer can handle local files that end with \n\n* .kml, .kml.zip, .kmz (kml in zip) \n* .gpx, .gpx.zip, .gpz (gpx in zip)\n* .poi, .poi.zip, .poz (poi in zip)\n\nLocationMapViewer can handle http(s): and content: urls with mime \n\n* application/vnd.google-earth.kml+xml\n* application/vnd.google-earth.kmz\n* application/xml+kml\n* application/xml+gpx\n* application/xml+poi\n* application/zip+xml+kml\n* application/zip+xml+gpx\n* application/zip+xml+poi\n\nLocationMapViewer is designed to be used by other apps. This means in Terms of [GPLv3](http://www.gnu.org/licenses/gpl-3.0) that your app\nthat uses the Intent-Iterface [is not considered a Derived Work.](https://en.wikipedia.org/wiki/GPL_v3#Point_of_view:_linking_is_irrelevant)\n\nIn other words: you can used LocationMapViewer as a [driver for your non gpl/non opensource app.](http://www.rosenlaw.com/lj19.htm).\n\nFor more informations see https://github.com/k3b/LocationMapViewer/wiki\n\n-----\n\n## Donations: \n\nIf you like this app please consider to donating to https://wiki.openstreetmap.org/wiki/Donations .\n\nSince android-developping is a hobby (and an education tool) i do not want any \nmoney for my apps so donation should go to projects I benefit from.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fk3b%2Flocationmapviewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fk3b%2Flocationmapviewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fk3b%2Flocationmapviewer/lists"}