MapEdit Mobile – parametrisierter Aufruf per Deeplinks

In MapEdit Mobile Web, IOS und Android besteht die Möglichkeit, die App per Deeplink zu starten. Das vereinfacht den Aufruf gerade für Nicht-GIS-Nutzer deutlich. Neben dem reinen Starten von MapEdit Mobile, ohne dass eine URL bzw. der Server eingetragen werden muss, bis hin zum Öffnen eines Formulars, abhängig von vorher definierten Parametern, gibt es viele Varianten.
Diese und deren Einrichtung werden nachfolgend beschrieben.

Web

Eine Url für MapEdit Mobile (Web) hat folgenden Aufbau, wobei Parameter mit {PARAMETER} dargestellt werden:

http(s)://{IHRSERVER}/mapedit-web/?{PARAMETER}={WERT}

Hier können mehrere Parameter genutzt werden, die dann mit & verknüpft werden.

Ein Beispielaufruf unter localhost:8080, der lediglich ein Projekt öffnen soll, kann demnach folgendermaßen aussehen:

http://localhost:8080/mapedit-web?project=Testproject

Ein Beispiel unter localhost:8080 für das Highlighten eines Objekts:

http://localhost:8080/mapedit-web?project=Testproject&execute=highlight&connectionName=Datenbankname&tableName=Tabellenname&key=123

Mobile Apps (IOS/Android) 

Die nativen Apps gliedern DeepLinks in die beiden Bereiche Kommandos und Konfiguration. Der grundlegende Aufbau eines Aufrufs sieht wie folgt aus:

mapedit://{BEREICH}?{PARAMETER}={WERT}&{PARAMETER}={WERT}

Mehrere Parameter können nacheinander angegeben werden und werden jeweils mit & verknüpft.

Beispielaufrufe für den Bereich Kommandos mit den einzelnen Ausführungsoptionen:

mapedit://command?execute=openForm&project=Testproject&formName=Testform&filter=spalte=10

mapedit://command?execute=highlight&project=Testproject&connectionName=Test_Connection&tableName=Test_Tabelle&filer=spalte>10&zoomLevel=10

mapedit://command?execute=openFormAndHighlight&project=Testproject&formName=Testform&filter=spalte<10&zoomLevel=15

mapedit://command?execute=openProject&project=Testproject


Unterstützte Parameter und Kommandos in iOS und Android

Markieren von Punkten, Linien und Polygonen in der Karte

Über das folgende Link-Schema können Sie ein oder mehrere Objekte in der Karte markieren:

mapedit://command?execute=highlight
project (required, string)
connectionName (required, string)
tableName (required, string)
filter (required, string)
zoomLevel (optional, int)

Öffnen eines Formulars 

Mit diesem Link-Schema können Sie ein Formular eines Projekts direkt öffnen, wahlweise mit oder ohne Filter:

mapedit://command?execute=openForm
project (required, string)
formName (required, string)
filter (optional, string)

Öffnen eines Formulars und Markieren von Position(en) in der Karte

Bei diesem Schema gibt es eine Besonderheit: Ist auf dem Bildschirm des Geräts nicht genügend Platz, damit Formular und Karte nebeneinander angezeigt werden können, wird standardmäßig das Formular angezeigt, wie zum Beispiel auf dem Smartphone.

mapedit://command?execute=openFormAndHighlight
project (required, string)
formName (required, string)
filter (optional, string)
zoomLevel (optional, int)

DeepLinks verhalten sich unter iOS und Android gleich. Ist eine gültige Anmeldung vorhanden, wird die Karte oder das Formular sofort geöffnet, wenn die App gestartet ist. Ist die Anmeldung abgelaufen, muss sich der Anwender zuerst anmelden, danach wird die Karte oder das Formular geöffnet.

Nur ein einzelnes Projekt öffnen

Um nur ein bestimmtes Projekt zu öffnen, kann das folgende Schema verwendet werden:

mapedit://command?execute=openProject
project (required, string)

Hinzufügen von MapEdit-Core-Servern

Die Internetadresse des MapEdit-Core-Servers kann ebenfalls über einen DeepLink hinzugefügt werden. Dazu muss nur der folgende Link aufgerufen werden:

mapedit://config?serverUrl=<server_url> 

Viel Spaß beim Ausprobieren!


© 12/2025 Mensch und Maschine Deutschland GmbH. Alle Rechte vorbehalten.