Sync with other maps apps (Favorites, Tracks, etc.)

[jancborchardt]

We should work on having these apps sync with us:

• GNOME Maps might become compatible this summer, ref Provide APIs to sync with gnome-maps Provide APIs to sync with gnome-maps #30, cc @Sumaid @mlundblad
• Marble would require a few changes to be compatible
• OsmAnd would be nice! Nothing like that yet. Discussion about sync at Enable synchronisation of favourites osmandapp/OsmAnd#2750 (comment)
• Maps.me would be best since they are widely used, but they have a company behind them and already offer their own proprietary favorites backup.
• Organic Maps is a fork of Maps.me without the proprietary features. Discussion about sync at Bookmark synchronization/online backup organicmaps/organicmaps#622, and unfortunately they also seem focused on providing their own integrated backup only.
• CoMaps is a community fork of Organic Maps. Discussion about sync at https://codeberg.org/comaps/comaps/issues/262

(Carried over from @eneiluj’s notes in #56 )

[thomas-mc-work]

There is a very actively developed clone of Maps.me called Maps (on F-Droid). Maybe this would be a good candidate for integration? They have already implemented track recording which would play nicely with the sync feature.

Features over upstream repo:

• Track Recording (record your tracks)
• Custom Bookmarks path (helps backup your bookmarks with apps like: Syncthing)
• Removed ads and binaries (peace and freedom)
• Screenlock option (prevent app stay turned on while in pocket with lockscreen enabled)

[jancborchardt]

@thomas-mc-work good call, yes! Do you have any contacts there or do you want to open an issue in their tracker linking both projects up? :)

[thomas-mc-work]

I've raised an issue here, mostly copied from the OsmAnd issue and hopefully phrased as expected.

Where can I find the API documentation? Preferably in the OpenAPI format.

[julien-nc]

@thomas-mc-work Actually there is no Maps Favorites API documentation. It's pretty straightforward though. It's a REST API with 4 routes (listed in appinfo/routes.php):

• GET https://mync.org/index.php/apps/maps/api/1.0/favorites => get a JSON list of the favorites
• POST https://mync.org/index.php/apps/maps/api/1.0/favorites => add a favorite, parameters are name (string), lat (float), lng (float), category (string), comment (string), extensions (string)
• PUT https://mync.org/index.php/apps/maps/api/1.0/favorites/ID => with a value instead of "ID", edit a favorite. Params are the same as POST ones.
• DELETE https://mync.org/index.php/apps/maps/api/1.0/favorites/ID => with a value instead of "ID", deletes a favorite

For accessing those routes, you need to be authenticated with a session or with basic http auth.

I'm completely open to make changes to this API since it's not used yet 😉.

[rinigus]

I wonder whether favorites fields are fixed now. There are some extra fields that I would like to have for Pure Maps or are those expected to be stored under "extensions"?

As I don't have any experience with Nextcloud sync - what would be the best way to authenticate for access? I would prefer not to store any passwords - some kind of session id? Maybe pointers towards docs on it?

[szaimen]

Maybe this?
https://github.com/nextcloud/Android-SingleSignOn

[rinigus]

@szaimen : thanks, but I am looking for something running on Linux (desktop and mobile), not Android.

[gdepountis]

I am sorry if I am not in correct conversaion but
does maps are compatible with the marinetraffic API
https://www.marinetraffic.com/en/ais-api-services/detail/ps02/vessel-positions-of-a-static-fleet#

[jancborchardt]

@gdepountis could you open a separate issue for that? :) Thanks