Skip to content

jakubvalenta/geoshare

Repository files navigation

Application icon GeoShare: Jump Between Maps

An Android app to open map links in other map apps and copy coordinates.

Get it on F-Droid Get it on Izzy on Droid

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.

F-Droid Izzy on Droid GitHub Translation status

Share a map link with GeoShare and the app will open it in another installed map app.

Supported map links

  • Google Maps
  • Apple Maps
  • 2GIS
  • Amap (AutoNavi)
  • Baidu Map (beta)
  • 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 all apps that support it, including TomTom.
  • Allows opening a location in web maps, pre-installed ones or your own.
  • 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.

Screenshot of Google Maps’ share screen

Choose GeoShare and the app will let you open the same location in any installed map app.

Screenshot of GeoShare’s share screen

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.

Screenshot of Google Maps’ Open by default settings

Then go to Settings > Apps > GeoShare > Open by default, turn on the opening of links in this app, and tap Add links.

Screenshot of GeoShare’s Open by default settings

Select maps.app.goog.gl, maps.google.com, and www.google.com. These are the common Google Maps links. You can choose other maps or the more rare links too, but it’s not essential.

If some links are grayed out, other map 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

GeoShare 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. GeoShare extracts them from the map URL.

However, not all map URLs include coordinates. In such cases, GeoShare 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. <meta property="place:location:latitude" content="40.78">
  • or the whole web page with running JavaScript.

If you don’t allow connecting to the map service, then GeoShare 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, GeoShare 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 GeoShare 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

GeoShare 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

GeoShare supports many types of map links. If you still find a link that doesn’t work, please report an issue.

Screenshots

Screenshot of GeoShare’s main screen Screenshot of GeoShare’s result screen Screenshot of GeoShare’s automation configuration screen Screenshot of GeoShare asking for permission to connect to Google Screenshot of GeoShare’s intro screen

Installation

From an app store (recommended)

Get the app on F-Droid (recommended) or Izzy on Droid.

From an APK file

  1. Download the APK from GitHub.

  2. Verify the APK signature:

    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:

    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

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:

json_key_file("path/to/play-store-credentials.json")
package_name("page.ooooo.geoshare.pro")

Updating Google Play metadata

fastlane metadata

Manual testing

To share a URI input with the app running in emulator, run:

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:

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 or create a new one.

Translating

GeoShare is available under Weblate thanks to their libre tier! More instructions can be found under Info in it.

Translation status

Feel free to remix this project under the terms of the GNU General Public License version 3 or later. See COPYING and NOTICE.

Some components of this project are derived from third-party code under other compatible licenses; see individual subdirectories.

Contributors

Languages