https://github.com/jakubvalenta/geoshare
An Android app to open Google Maps in other map apps and to create geo: links
https://github.com/jakubvalenta/geoshare
android geo gmaps googlemaps link openstreetmap osm url
Last synced: 4 months ago
JSON representation
An Android app to open Google Maps in other map apps and to create geo: links
- Host: GitHub
- URL: https://github.com/jakubvalenta/geoshare
- Owner: jakubvalenta
- License: gpl-3.0
- Created: 2024-11-05T12:02:30.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-27T20:34:09.000Z (about 1 year ago)
- Last Synced: 2025-04-10T01:07:08.469Z (about 1 year ago)
- Topics: android, geo, gmaps, googlemaps, link, openstreetmap, osm, url
- Language: Kotlin
- Homepage: https://f-droid.org/packages/page.ooooo.geoshare/
- Size: 3.44 MB
- Stars: 83
- Watchers: 3
- Forks: 5
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: COPYING
Awesome Lists containing this project
README
#  Geo Share
An Android app to open map links in other map apps and copy coordinates.
[
](https://f-droid.org/packages/page.ooooo.geoshare/)
[
](https://apt.izzysoft.de/packages/page.ooooo.geoshare)
If you'd like to help getting the app published on **Google Play**, write me an
email to `jakub at jakubvalenta dot cz` and I'll invite you to the testing
program.
[](https://f-droid.org/packages/page.ooooo.geoshare/)
[](https://apt.izzysoft.de/packages/page.ooooo.geoshare)
[](https://github.com/jakubvalenta/geoshare/releases/latest/download/page.ooooo.geoshare.apk)
[](https://hosted.weblate.org/engage/geoshare/)
Share a map link with Geo Share and the app will open it in another installed
map app.
**Supported map links**
- Google Maps
- Apple Maps
- 2GIS
- Amap (AutoNavi)
- CoMaps
- HERE WeGo
- Magic Earth
- Maps.me
- Mapy.com
- OpenStreetMap
- Organic Maps
- OsmAnd
- Urbi
- Waze
- Yandex Maps
- coordinates
**Example use cases**
When someone sends you a Google Maps link, but you prefer using OpenStreetMap,
you can quickly **open the same location** in OsmAnd or Organic Maps.
When you like Google Maps for finding places, but you prefer a different app for
navigation, you can easily switch from Google Maps to your favorite
**navigation app**.
**Other features**
- Shows the **geographic coordinates** of a map link and allows copying them to
clipboard in various formats, for example as a geo: link.
- Shows all points of a **place list** link.
- Allows performing an action **automatically** when a map link is processed.
- Allows **launching navigation** in TomTom, Google Maps, Magic Earth...
- Allows saving a location as a **GPX file**.
- Retries on **patchy internet connection**.
- Allows **pasting map links** directly into the app, instead of sharing them
with it.
- Interface adapts to **tablets**.
## Intro
### How to show a map location in another map app
Share a location from your map app or web browser.
Choose _Geo Share_ and the app will let you open the same location in any
installed map app.
### Configure Android to open links to Google Maps in alternative maps (optional)
First, go to Settings > Apps > Maps > _Open by default_ and turn off the opening
of links in this app.
Then go to Settings > Apps > Geo Share > _Open by default_, turn on the opening
of links in this app, and tap _Add links_.
Select at least `maps.google.com` and `maps.app.goo.gl`. If some links are
grayed out, other Google apps are set to open them by default. You can find
these apps and turn off the opening of links for them, like we did for Google
Maps.
## How it works
Geo Share converts map links (e.g. https://maps.app.goo.gl/...) into geo: links
that can be opened by other map apps. To create a geo: link, geographic
coordinates are required. Geo Share extracts them from the map URL.
However, not all map URLs include coordinates. In such cases, Geo Share will
**prompt you for permission to connect to the map service (Google Maps, Apple
Maps etc.)** and retrieve the coordinates from:
- either HTTP headers, e.g.
`Location: https://google.com/maps/@40.78,-73.96,19z`
- or HTML document, e.g.
``
- or the whole web page with running JavaScript.
If you don’t allow connecting to the map service, then Geo Share creates a geo:
link with a search term instead of coordinates, or it stops, depending on the
particular link.
To permanently allow or deny connecting to the map service instead of always
asking (the default), go to the app’s preferences.
## Privacy considerations
When possible, Geo Share converts map links offline. If the map link requires
online conversion, the app will ask you before connecting to the map service (
Google Maps, Apple Maps, etc.). If you allow the connection, the map service
will receive the map link, it will be able to read your IP address, and in some
cases Geo Share will load the live web page of the map service and execute its
JavaScript. This happens in a restricted environment, which blocks tracking
scripts and doesn’t store cookies.
## Location permission
Geo Share asks for location permission when launching the TomTom navigation and
when sharing a GPX route, because in these cases the app needs to create a GPX
route that starts at your current location. The location information is
discarded immediately after the creation of the route.
## Reporting issues
Geo Share supports many types of map links. If you still find a link that
doesn’t work,
please [report an issue](https://github.com/jakubvalenta/geoshare/issues/new?template=1-bug-map-link.yml).
## Screenshots
[
](./fastlane/metadata/android/en-US/images/phoneScreenshots/1.png)
[
](./fastlane/metadata/android/en-US/images/phoneScreenshots/2.png)
[
](./fastlane/metadata/android/en-US/images/phoneScreenshots/3.png)
[
](./fastlane/metadata/android/en-US/images/phoneScreenshots/4.png)
[
](./fastlane/metadata/android/en-US/images/phoneScreenshots/5.png)
## Installation
### From an app store (recommended)
Get the app
on [F-Droid (recommended)](https://f-droid.org/packages/page.ooooo.geoshare/)
or [Izzy on Droid](https://apt.izzysoft.de/packages/page.ooooo.geoshare).
### From an APK file
1. Download the APK
from [GitHub](https://github.com/jakubvalenta/geoshare/releases/latest/download/page.ooooo.geoshare.apk).
2. Verify the APK signature:
```shell
apksigner verify --print-certs page.ooooo.geoshare.apk
```
Expected output:
```
Signer #1 certificate DN: CN=Jakub Valenta, OU=Unknown, O=Unknown, L=Unknown, ST=Unknown, C=DE
Signer #1 certificate SHA-256 digest: 1b27b17a9df05321a93a47df31ed0d6645ebe55d0e89908157d71c1032d17c10
Signer #1 certificate SHA-1 digest: f847c6935fa376a568a56ca458896b9236e22b6c
Signer #1 certificate MD5 digest: 6bcaa6bd5288a6443754b85bf6700374
```
3. Install the APK on your phone using adb:
```shell
adb -d install page.ooooo.geoshare.apk
```
## Development
Open this repo in Android Studio to build and run the app, and to run unit tests
and instrumented tests.
### Generating a signed release APK
```shell
export STORE_FILE=path/to/keystore.js
export STORE_PASSWORD=mypassword
export KEY_ALIAS=com.example.android
export KEY_PASSWORD=mypassword
make build
```
### Setting up Google Play publishing
Create file `fastlane/Appfile` with the following content:
```ruby
json_key_file("path/to/play-store-credentials.json")
package_name("page.ooooo.geoshare")
```
### Updating Google Play metadata
```shell
fastlane metadata
```
### Manual testing
To share a URI input with the app running in emulator, run:
```shell
adb -s emulator-5554 shell am start -W -a android.intent.action.VIEW -d 'https://maps.apple.com/?q=Central+Park\&sll=50.894967,4.341626\&z=10\&t=s' page.ooooo.geoshare.debug
```
Don’t forget to escape the `&` character.
To share a text input, run:
```shell
adb -s emulator-5554 shell am start -W -a android.intent.action.SEND -t text/plain -e android.intent.extra.TEXT 'N-68.648556,\ E-152.775879' page.ooooo.geoshare.debug
```
## Contributing
Your contributions are welcome! To show that you’d like to work on a bug, or
feature request, please comment on the relevant [GitHub
issue](https://github.com/jakubvalenta/geoshare/issues) or create a new one.
### Translating
Geo Share is [available under
Weblate](https://hosted.weblate.org/engage/geoshare/) thanks to their libre
tier! More instructions can be found under *Info* in it.
[](https://hosted.weblate.org/engage/geoshare/)
__Feel free to remix this project__ under the terms of the GNU General Public
License version 3 or later. See [COPYING](./COPYING) and [NOTICE](./NOTICE).