Repository files navigation

With MapLibre-GL support

🌍🌏🌎 The whole world fits inside your cloud!

• 🗺 Beautiful map: UsingOpenStreetMap andLeaflet, you can choose between standard map, satellite, topographical, dark mode or even watercolor! 🎨
• ⭐ Favorites: Save your favorite places, privately! Sync withGNOME Maps and mobile apps is planned.
• 🧭 Routing: Possible using eitherOSRM,GraphHopper orMapbox.
• 🖼 Photos on the map: No more boring slideshows, just show directly where you were!
• 🙋 Contacts on the map: See where your friends live and plan your next visit.
• 📱 Devices: Lost your phone? Check the map!
• 〰 Tracks: Load GPS tracks or past trips. Recording withPhoneTrack orOwnTracks is planned.

Future plans:

• 📆 Events on the map: Know where you need to go next!
• 🗺 Different projections: TheMercator projection is very biased, as you can see fromThe True Size of Africa. Another view like theGall-Peters projection would be a possibility.

Custom maps are stored by default in the "/Maps" folder. This folder can be found in thefiles app. Other folders turned into map by placing a ".index.maps" file into it.Content can therefore be added via:

• Webdav (Desktop and Mobile clients)
• Files app
• Maps app

Custom maps can then be shared from the maps or any other app.

Maps can be shared using the nextcloud sharing system.

Favorites on custom the custom maps are stored in the .favorites.json file.

Shared favorite categories can be linked to a custom map.Linked favorite categories are read-only.They can be edited on the owners default map.These links are stored in the ".favorite_shares.json".

Contacts on custom maps are stored as vCards (*.vfc) files.

Tracks on custom map are stored as "*.gpx files".

Photos are stored in the corresponding folder.They can be added from filesor from mapsExisting photo albums can be viewedon the map by placing a ".index.maps" file into it.

Scanning photos take time. Therefore photos are scanned in the background.After adding photos it might take a while,until the scan is done and the photos are shown on the map.

This requires that youinstall node and npm.

1. ☁ Clone this app into theapps folder of your Nextcloud:git clone https://github.com/nextcloud/maps.git
2. 👩‍💻 In the folder of the app, run the commandmake to install dependencies and build the Javascript.
3. ✅ Enable the app through the app management of your Nextcloud
4. 🎉 Partytime! Help fixsome issues andreview pull requests 👍

Media scans are performed with the regular system background job.

Scans can also be manually triggered via occ command:

./occ maps:scan-photos to rescan photos' GPS exif data

./occ maps:scan-tracks to rescan track files