Hypermaps

¶About

On 🔗maps, the CHT/Totalism.org has been collaboratively mapping for 10 years. Before Hypermaps, the (online, collaborative & public) Google MyMaps was used, along with a custom converter to support importing the markers to OsmAnd (Android application). This meant having fully offline mobile maps, now with collaborative markers.

Hypermaps improves this with:
    * own web interface (==no need to use Google)
    * export markers to OsmAnd, keeping their types & styles
    * importing markers from OsmAnd
    * fast to edit, text-based format (in pads)
    * local tiles caching (if running the SimpleProxy)
    * [...]

Now comrades can:
    Collectively & offline map cities on the go, using OsmAnd,
    Import to Hypermaps,
    Quick-edit the maps in pads (you can't organize dozens of markers on mobile!),
    Define marker types and styles,
    (Re)download markers to mobile,
    Also sharing with others.

¶Basic use (keyboard shortcuts!)

Full shortcuts available with F1!

———Navigation———
+|- : zoom in, out
.|, : cursor to previous, next marker
enter : focus on marker
tab|shift+tab : cycle tiles ("map background")

———Editing———
Editing will only work on pad-based maps (==link includes 'pad', not 'map').

right click (on map) : add new marker
    Before ":" is the marker type. See 🔗hypermaps-markertypes for definitions.
    Examples:
        "n:some park",
        "p:friend house ... tortilla chips",
        "c:national gallery",
        "EV:airport"
(cursor/hover &) e : edit current marker
(cursor/hover &) del : delete marker
alt+F : search by address. point will be created.
F2 : edit as pad

¶Example maps

https://maps.totalism.org/
Current default map.

https://maps.totalism.org/?map=all
All maps (as available 🔗maps).

https://maps.totalism.org/?map=berlin
Map of Berlin.

https://maps.totalism.org/?pad=music-africa&auto
"Music in Africa"

https://maps.totalism.org/?pad=slo
Editable map of Slovenia.

https://maps.totalism.org/?map=belg
All Belgium maps.

https://maps.totalism.org/?map=bru&dll
Download the map of Brussels.
Open this on your phone with OsmAnd, and choose "Import as Favorites".
More info ### [!!] ← about Configure Map, reduce POI, etc.
_________________
All maps can be downloaded to OsmAnd fully-offline mobile app, maintaining marker styles, just add "&dll" to URL. More info below.

https://maps.totalism.org/?pad=100
Pad-based map. (in "simple format").
In this case, via 🔗hypermaps-100.

¶What is the current release status & use-license?

Hypermaps are an INVITE ONLY DEMO.

You can:
    * show it to people, mentioning it's from the Totalist software cooperative.
    * explain that it allows for offline+online collaborative mapping
    * request to invite them (to admin, or in the Telegram group)

All users should join the Telegram hypermaps group.

¶Importing: OsmAnd→Hypermaps
→→SYNC →→IMPORT

——————————————————— TRY 1
(1)
    @OsmAnd:
        ↓
        (hamburger menu)
        My Places (Favorites, not Tracks)
        "triple dot" on your collection

(2)
    (If you don't have Telegram that you can also read on laptop, skip to $$$$$$$$$$$$$$$$$$$$$)

(3)
    Share → Telegram → Saved Messages / some "personal group"
        (!) gives two versions:
            1) "simple text" (some less data, like 'type', 'time', etc!)
            2) a .GPX file (full data)

(4)
    copy-paste the GPX to a pad:
        * (open Telegram and download the file)
        $ cd /DOWNLOADS; cat $(latest 1 gpx) | __copy
        * (paste to @@hypermaps-whatever-gpx)

(5)
    open @@hypermaps-whatever-gpx
        ↓
        access at https://maps.totalism.org/?pad=whatever-gpx
        ctrl+S
        will save to @@hypermaps-whatever

(6)
    you're done:
        access at https://maps.totalism.org/?pad=whatever
        edit at https://pad.totalism.org/p/hypermaps-whatever



——————————————————— TRY 2 (20251102)

* use @@android-sync

* go
"""
cd ../osmand
cd $(latestdir)/favorites
cat favorites-###.gpx | __copy
"""

* paste to @@hypermaps-$name-$date

* open in hypermaps ... example:
    https://localhost/hypermaps/?pad=$name-$date&T&gpx&topad=$name-new

* (verify map is okay)
    https://maps.totalism.org/?pad=$name-new

* ctrl+S

* open converted as pad:
    https://pad.totalism.org/p/hypermaps-$name-new

↓
* overview (with broadcast):
    * on map: "ctrl+F8" x2
    * open mm2p
    ↓
    * sifting 0 (!!)
    * ... move stuff out (personal, random, etc) to a random pad
    * assign proper tags

↓
* paste to main!
    https://localhost/hypermaps/?pad=$name&T

* fin!

¶Exporting: Hypermaps→OsmAnd
→→SYNC →→EXPORT

To download the .gpx file:
    * Add "&dll" to any map link, for example:
        https://maps.totalism.org/?map=berlin&dll
    * Or, press "alt+D" (on computer), and transfer that to the phone

Then,
either open & import directly to OsmAnd,
or via the menu:
    → ☰
    → My Places
    → ⨁ icon
    → Select the "hypermaps" file (should be visible in Recent downloads)

When updating, just overwrite the existing map.

¶Configuration: Define marker styles

→ 🔗hypermaps-markertypes
The style of different types appearing as markers, for both Web & OsmAnd interfaces.