Zum Hauptinhalt springen

API zur Integration mit Guru Maps

Guru Maps unterstützt die URL-Schemas guru:// und geo:// zur Integration mit anderen Apps. Damit können Anwendungen Dateien importieren, Suchen ausführen, die Navigation starten, die Trackaufzeichnung steuern und den aktuellen Standort speichern.

Guru Maps öffnen​

API: guru:[?back_url=<url>]

Parameter:

  • back_url – URL, die geöffnet wird, wenn der Benutzer Escape drückt.

Beispiele:

  1. guru: – Öffnet Guru Maps, ohne eine laufende Aktion zu unterbrechen.
  2. guru:?back_url=https://gurumaps.app – Öffnet Guru Maps und beim Drücken von Escape anschließend https://gurumaps.app.

Datei importieren​

API: guru://open?url=<url to the file>

Parameter:

  • url – URL der zu importierenden Datei.

Guru Maps lädt die Datei von der angegebenen URL und versucht, sie zu importieren. Unterstützte Formate: GPX, KML, KMZ, WPT, PLT, TCX, MS, GeoJSON, MapCSS, SQLITEDB und MBTILES.

Beispiele:

  1. guru://open?url=https://gurumaps.app/example/feature_collection.geojson – Importiert eine GeoJSON-Datei.
  2. guru://open?url=https://ms.gurumaps.app/ms/google/Google_Satellite_RU_HD.ms – Importiert eine Satellitenkartenquelle.

Suche​

API: guru://search?q=<search query>[&coord=lat,lon][&back_url=<url>][&back_url=<url>]

Parameter:

  • q – Suchbegriff.
  • coord – Koordinaten des Punkts, in dessen Umgebung gesucht wird, im Format lat,lon. Ohne diesen Parameter beginnt die Suche an der aktuellen Kartenposition.
  • back_url – URL, die geöffnet wird, wenn der Benutzer Escape drückt.

Beispiele:

  1. guru://search?q=Wybrzeże%20Kościuszkowskie%2020%20Warszawa&coord=52.2297,21.0122 – Sucht nach „Wybrzeże Kościuszkowskie 20 Warszawa“ und zentriert die Karte auf die angegebenen Koordinaten.
  2. guru://search?q=Agrykola%201%20Warszawa – Sucht von der aktuellen Kartenposition aus nach „Agrykola 1 Warszawa“.

API: guru://nav?finish=lat,lon[&via=lat,lon][&start=lat,lon][&mode=<auto, bicycle, pedestrian, motor_scooter, motorcycle, truck, straight>][&start_navigation=<true,false>][&back_url=<url>]

Parameter:

  • finish – Koordinaten des Routenziels.
  • via – Koordinaten eines Zwischenstopps; der Parameter kann mehrfach verwendet werden.
  • start – Koordinaten des Routenstarts. Ohne diesen Parameter wird der aktuelle Standort verwendet.
  • mode – Fortbewegungsart: auto, bicycle, pedestrian, motor_scooter, motorcycle, truck oder straight. Standardmäßig wird auto verwendet.
  • start_navigation – Bei true beginnt die Navigation unmittelbar nach der Routenberechnung. Bei false oder ohne den Parameter wird die Vorschau zum Bearbeiten der Route angezeigt.
  • back_url – URL, die geöffnet wird, wenn der Benutzer Escape drückt.

Beispiele:

  1. Route vom aktuellen Standort zu einem Punkt: guru://nav?finish=52.2297,21.0122
  2. Route zwischen zwei angegebenen Punkten: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222
  3. Route mit einem Zwischenstopp: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172
  4. Route mit zwei Zwischenstopps: guru://nav?start=52.2297,21.0122&via=52.2347,21.0172&via=52.2765,21.234&finish=52.2397,21.0222
  5. Fahrradroute: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172&mode=bicycle
  6. Route berechnen und Navigation sofort starten: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172&mode=bicycle&start_navigation=true
  7. Route berechnen und mit Escape zu einer URL zurückkehren: guru://nav?finish=52.2297,21.0122&back_url=https://gurumaps.app
  8. Navigation starten und mit Escape zu einer URL zurückkehren: guru://nav?finish=52.2297,21.0122&start_navigation=true&back_url=https://gurumaps.app

Trackaufzeichnung starten, stoppen oder umschalten​

API: guru://recordTrack?action=<start,stop,toggle>

Parameter:

  • action – Aktion für die Trackaufzeichnung: start, stop oder toggle.

Beispiele:

  1. guru://recordTrack?action=start – Startet die Trackaufzeichnung in Guru Maps.
  2. guru://recordTrack?action=stop – Stoppt eine laufende Trackaufzeichnung.
  3. guru://recordTrack?action=toggle – Schaltet den Zustand um: Eine laufende Aufzeichnung wird gestoppt, andernfalls beginnt eine neue.
hinweis

Bei einer ungültigen oder fehlenden Aktion verwendet die API toggle. Daher verhält sich guru://recordTrack genauso wie guru://recordTrack?action=toggle.

Kartenmarkierung erstellen​

API: guru://saveMarker[?name=<marker name>][&coord=lat,lon]

Nach dem Erstellen öffnet Guru Maps die Details der Kartenmarkierung.

Parameter:

  • name – Name der Kartenmarkierung; ohne Angabe wird er automatisch eingetragen.
  • coord – Koordinaten der Kartenmarkierung; ohne Angabe wird der aktuelle Standort verwendet.

Beispiele:

  1. Kartenmarkierung am aktuellen Standort: guru://saveMarker
  2. Kartenmarkierung am aktuellen Standort mit Namen: guru://saveMarker?name=MyMarker
  3. Kartenmarkierung an einem angegebenen Ort: guru://saveMarker?coord=52.2297,21.0122
  4. Kartenmarkierung an einem angegebenen Ort mit Namen: guru://saveMarker?name=MyMarker&coord=52.2297,21.0122

Ort mit angegebenen Koordinaten auf der Karte anzeigen​

API: guru://show?place=lat,lon[,zoom][&back_url=<url>]

Parameter:

  • place – Koordinaten des anzuzeigenden Orts.
  • zoom – optionale Zoomstufe. Ohne Angabe wird die aktuelle Zoomstufe verwendet.
  • back_url – optionale URL, die beim Drücken von Escape geöffnet wird.

Beispiele:

  1. guru://show?place=52.2297,21.0122 – Öffnet Guru Maps und zeigt den Punkt an.
  2. guru://show?place=52.2297,21.0122,17 – Zeigt den Punkt mit Zoomstufe 17 an.
  3. guru://show?place=52.2297,21.0122&back_url=https://gurumaps.app – Zeigt den Punkt und öffnet bei Escape die URL https://gurumaps.app.
hinweis

Guru Maps unterstützt außerdem das Schema geo:, beispielsweise geo:52.2297,21.0122. Es kennt jedoch den Parameter back_url nicht. Verwende dafür das Schema guru://.