Перейти до основного вмісту

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://.