Passa al contenuto principale

API di integrazione di Guru Maps

Guru Maps supporta gli schemi guru:// e geo: per integrarsi con altre applicazioni. Permettono di avviare importazioni, ricerche e navigazione, controllare la registrazione delle tracce e salvare la posizione attuale.

Aprire Guru Maps​

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

Parametri:

  • back_url: se specificato, quando l'utente preme Esc l'app apre l'URL di ritorno.

Esempi:

  1. guru: — apre Guru Maps senza interrompere l'azione attuale.
  2. guru:?back_url=https://gurumaps.app — apre Guru Maps e, premendo Esc, apre https://gurumaps.app.

Importare un file​

API: guru://open?url=<URL del file>

Parametri:

  • url: collegamento al file da importare.

Guru Maps scarica il file e prova a importarlo. Formati supportati: GPX, KML, KMZ, WPT, PLT, TCX, MS, GeoJSON, MapCSS, SQLITEDB e MBTILES.

Esempi:

  1. guru://open?url=https://gurumaps.app/example/feature_collection.geojson — importa un file GeoJSON dal collegamento.
  2. guru://open?url=https://ms.gurumaps.app/ms/google/Google_Satellite_RU_HD.ms — importa una fonte di immagini satellitari.

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

Parametri:

  • q: testo da cercare;
  • coord: coordinate lat,lon del punto intorno a cui cercare. Se omesse, viene usata la posizione attuale della mappa;
  • back_url: se specificato, premendo Esc viene aperto l'URL indicato.

Esempi:

  1. guru://search?q=Wybrzeże%20Kościuszkowskie%2020%20Warszawa&coord=52.2297,21.0122 — cerca «Wybrzeże Kościuszkowskie 20 Warszawa» con la mappa centrata sulle coordinate.
  2. guru://search?q=Agrykola%201%20Warszawa — cerca «Agrykola 1 Warszawa» dalla posizione attuale della mappa.

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>]

Parametri:

  • finish: coordinate della destinazione;
  • via: coordinate di un punto intermedio; può essere ripetuto;
  • start: coordinate della partenza; se omesse, viene usata la posizione attuale;
  • mode: mezzo di trasporto (auto, bicycle, pedestrian, motor_scooter, motorcycle, truck o straight); il valore predefinito è auto;
  • start_navigation: con true, avvia la navigazione appena calcolato l'itinerario. Se omesso o false, mostra l'anteprima modificabile;
  • back_url: se specificato, premendo Esc viene aperto l'URL indicato.

Esempi:

  1. Itinerario dalla posizione attuale: guru://nav?finish=52.2297,21.0122
  2. Itinerario tra due punti: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222
  3. Un punto intermedio: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172
  4. Due punti intermedi: guru://nav?start=52.2297,21.0122&via=52.2347,21.0172&via=52.2765,21.234&finish=52.2397,21.0222
  5. Itinerario in bicicletta: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172&mode=bicycle
  6. Calcola e avvia la navigazione: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172&mode=bicycle&start_navigation=true
  7. Torna a un URL premendo Esc: guru://nav?finish=52.2297,21.0122&back_url=https://gurumaps.app
  8. Avvia la navigazione e torna a un URL premendo Esc: guru://nav?finish=52.2297,21.0122&start_navigation=true&back_url=https://gurumaps.app

Avviare, interrompere o alternare la registrazione​

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

Parametri:

  • action: azione di registrazione; può essere start, stop o toggle.

Esempi:

  1. guru://recordTrack?action=start — avvia una registrazione GPS.
  2. guru://recordTrack?action=stop — interrompe la registrazione attuale.
  3. guru://recordTrack?action=toggle — interrompe quella attiva o ne avvia una nuova.
note

Se action manca o non è valido, l'API usa toggle. Quindi guru://recordTrack equivale a guru://recordTrack?action=toggle.

Creare un marcatore​

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

Dopo la creazione, Guru Maps apre i dettagli del marcatore.

Parametri:

  • name: nome del marcatore; se omesso viene compilato automaticamente;
  • coord: coordinate del marcatore; se omesse viene usata la posizione attuale.

Esempi:

  1. Marcatore nella posizione attuale: guru://saveMarker
  2. Marcatore con nome: guru://saveMarker?name=MyMarker
  3. Marcatore a determinate coordinate: guru://saveMarker?coord=52.2297,21.0122
  4. Marcatore con nome e coordinate: guru://saveMarker?name=MyMarker&coord=52.2297,21.0122

Mostrare un luogo tramite le coordinate​

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

Parametri:

  • place: coordinate del luogo da mostrare;
  • zoom: facoltativo; livello di zoom. Se omesso, viene mantenuta la scala attuale;
  • back_url: facoltativo; URL aperto premendo Esc.

Esempi:

  1. guru://show?place=52.2297,21.0122 — apre Guru Maps e mostra il punto.
  2. guru://show?place=52.2297,21.0122,17 — mostra il punto con zoom 17.
  3. guru://show?place=52.2297,21.0122&back_url=https://gurumaps.app — mostra il punto e apre https://gurumaps.app premendo Esc.
note

Guru Maps supporta anche lo schema geo:. Ad esempio, geo:52.2297,21.0122 mostra una posizione sulla mappa. geo: non supporta però back_url; per questa funzione usa guru://.