Перайсці да асноўнага змесціва

API для інтэграцыі з Guru Maps

Guru Maps падтрымлівае схемы guru:// і geo:// для інтэграцыі з іншымі праграмамі. Праз іх можна запускаць імпарт файлаў, пошук і навігацыю, кіраваць запісам трэка і захоўваць бягучае месцазнаходжанне.

Адкрыць Guru Maps​

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

Параметры:

  • back_url — адрас, які праграма адкрые пасля націску клавішы Escape.

Прыклады:

  1. guru: — адкрывае Guru Maps, не перарываючы бягучае дзеянне.
  2. guru:?back_url=https://gurumaps.app — адкрывае Guru Maps, а пасля націску Escape пераходзіць на https://gurumaps.app.

Імпарт файла​

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

Параметры:

  • url — URL файла для імпарту.

Guru Maps спампоўвае файл з пазначанага адраса і спрабуе яго імпартаваць. Падтрымліваюцца GPX, KML, KMZ, WPT, PLT, TCX, MS, GeoJSON, MapCSS, SQLITEDB і MBTILES.

Прыклады:

  1. guru://open?url=https://gurumaps.app/example/feature_collection.geojson — імпартуе GeoJSON па спасылцы.
  2. guru://open?url=https://ms.gurumaps.app/ms/google/Google_Satellite_RU_HD.ms — імпартуе крыніцу спадарожнікавай карты.

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

Параметры:

  • q — тэкст пошуку;
  • coord — каардынаты пункта, адносна якога пачынаецца пошук, у фармаце lat,lon. Калі параметр не зададзены, выкарыстоўваецца бягучы цэнтр карты;
  • back_url — адрас, які праграма адкрые пасля націску Escape.

Прыклады:

  1. guru://search?q=Wybrzeże%20Kościuszkowskie%2020%20Warszawa&coord=52.2297,21.0122 — шукае «Wybrzeże Kościuszkowskie 20 Warszawa» адносна зададзеных каардынат.
  2. guru://search?q=Agrykola%201%20Warszawa — шукае «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>]

Параметры:

  • finish — каардынаты канчатковага пункта маршруту;
  • via — каардынаты прамежкавага пункта; параметр можна паўтарыць для некалькіх пунктаў;
  • start — каардынаты пачатку маршруту. Калі параметр не зададзены, выкарыстоўваецца бягучае месцазнаходжанне карыстальніка;
  • mode — від транспарту: auto, bicycle, pedestrian, motor_scooter, motorcycle, truck або straight. Стандартнае значэнне — auto;
  • start_navigation — калі зададзена true, навігацыя пачнецца адразу пасля пабудовы маршруту. Пры false або без параметра адкрыецца экран папярэдняга прагляду і рэдагавання;
  • back_url — адрас, які праграма адкрые пасля націску Escape.

Прыклады:

  1. Пабудаваць маршрут ад бягучага месца да зададзенага пункта: guru://nav?finish=52.2297,21.0122
  2. Пабудаваць маршрут паміж двума зададзенымі пунктамі: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222
  3. Дадаць адзін прамежкавы пункт: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172
  4. Дадаць два прамежкавыя пункты: guru://nav?start=52.2297,21.0122&via=52.2347,21.0172&via=52.2765,21.234&finish=52.2397,21.0222
  5. Пабудаваць веласіпедны маршрут: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172&mode=bicycle
  6. Пабудаваць маршрут і адразу пачаць навігацыю: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172&mode=bicycle&start_navigation=true
  7. Пасля націску Escape вярнуцца на зададзены URL: guru://nav?finish=52.2297,21.0122&back_url=https://gurumaps.app
  8. Пачаць навігацыю і пасля Escape вярнуцца на зададзены URL: guru://nav?finish=52.2297,21.0122&start_navigation=true&back_url=https://gurumaps.app

Пачаць, спыніць або пераключыць запіс трэка​

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

Параметры:

  • action — дзеянне з запісам: start, stop або toggle.

Прыклады:

  1. guru://recordTrack?action=start — пачынае запіс трэка ў Guru Maps.
  2. guru://recordTrack?action=stop — спыняе бягучы запіс.
  3. guru://recordTrack?action=toggle — пераключае стан: спыняе актыўны запіс або пачынае новы.
заўвага

Калі action не зададзены або мае няправільнае значэнне, API выкарыстоўвае toggle. Таму guru://recordTrack працуе гэтак жа, як guru://recordTrack?action=toggle.

Стварыць метку​

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

Пасля стварэння меткі Guru Maps адкрывае экран са звесткамі пра яе.

Параметры:

  • name — назва меткі. Калі яна не зададзена, праграма падставіць назву аўтаматычна;
  • coord — каардынаты меткі. Калі яны не зададзены, выкарыстоўваецца бягучае месцазнаходжанне карыстальніка.

Прыклады:

  1. Стварыць метку ў бягучым месцы: guru://saveMarker
  2. Стварыць метку ў бягучым месцы з зададзенай назвай: guru://saveMarker?name=MyMarker
  3. Стварыць метку ў зададзеным месцы: guru://saveMarker?coord=52.2297,21.0122
  4. Стварыць метку з назвай у зададзеным месцы: guru://saveMarker?name=MyMarker&coord=52.2297,21.0122

Паказаць на карце месца з зададзенымі каардынатамі​

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

Параметры:

  • place — каардынаты месца, якое трэба паказаць;
  • zoom — неабавязковы маштаб. Калі не зададзены, выкарыстоўваецца бягучы маштаб карты;
  • back_url — неабавязковы адрас, які праграма адкрые пасля націску Escape.

Прыклады:

  1. guru://show?place=52.2297,21.0122 — адкрывае Guru Maps і паказвае зададзены пункт.
  2. guru://show?place=52.2297,21.0122,17 — паказвае зададзены пункт на ўзроўні маштабу 17.
  3. guru://show?place=52.2297,21.0122&back_url=https://gurumaps.app — паказвае пункт, а пасля націску Escape адкрывае https://gurumaps.app.
заўвага

Guru Maps таксама падтрымлівае схему geo:. Напрыклад, geo:52.2297,21.0122 паказвае зададзенае месца на карце. Але схема geo: не падтрымлівае back_url; калі патрэбна вяртанне па URL, выкарыстоўвайце guru://.