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

[jancborchardt]

We should work on having these apps sync with us:

• [ ] [GNOME Maps](https://wiki.gnome.org/Apps/Maps) might become compatible this summer, ref Provide APIs to sync with gnome-maps #30, cc @Sumaid @mlundblad
• [ ] [Marble](https://marble.kde.org/) would require a few changes to be compatible
• [ ] [OsmAnd](https://osmand.net/) would be nice! Nothing like that yet. Discussion started there.
• [ ] [Maps.me](https://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.

(Carried over from @eneiluj’s notes in https://github.com/nextcloud/maps/issues/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.

[eneiluj]

@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 :wink:.

[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

[bugzy]

What changes would marble require to become compatible? The API looks similar to what was designed for Marble's sync in 2013 or so.

[tacruc]

@bugzy I had a brief look at the marble code, unfortunately I have only very basic c and c++ skills and none in QT. For me it looks like the was hardcoded in some way (.../apps/MARBLEAPP/...), so for sure the URL's needs to be adapted. But I guess than a lot of code could be reused.

[Spartachetto]

Just for information: the current release of OsmAnd introduced the option to export and import all data. For reference have a look here: https://osmand.net/blog/osmand-3-9-released .
It states that _We added the option to export and import all data including settings, resources, my places. It's a big step to the backup feature, which we will plan to add in the next release_ .