Перейти к основному содержимому

API для интеграции с Guru Maps

Guru Maps поддерживает схемы guru:// и geo:// для интеграции с другими приложениями. Это позволяет взаимодействовать с приложением и использовать его функционал для импорта файлов, поиска, навигации, записи треков и сохранения текущего местоположения.

Открытие Guru Maps​

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

Параметры:

  • back_url - если задан, и пользователь нажимает кнопку Escape, приложение откроет указанный URL возврата.

Примеры:

  1. guru: - Откроет Guru Maps, не прерывая никакие текущие действия внутри.
  2. guru:?back_url=https://gurumaps.app - Откроет Guru Maps, и при нажатии клавиши Escape откроется https://gurumaps.app.

Импорт файлов​

API: guru://open?url=<url к файлу>

Параметры:

  • url - URL-ссылка на файл для импорта.

Guru загрузит файл по указанному URL и попытается импортировать его. Поддерживаемые форматы файлов: 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=<поисковый запрос>[&coord=lat,lon][&back_url=<url>]

Параметры:

  • q - строка поиска.
  • coord - координаты точки, над которой будет запущен поиск, в формате lat,lon. Если не указано, поиск начнется по текущей позиции карты.
  • back_url - если задан, и пользователь нажимает кнопку Escape, приложение откроет указанный URL возврата.

Примеры:

  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, приложение откроет указанный URL возврата.

Примеры:

  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. Построение маршрута и возврат на указанный URL при нажатии клавиши Escape: guru://nav?finish=52.2297,21.0122&back_url=https://gurumaps.app
  8. Построение маршрута, запуск навигации и возврат на указанный URL при нажатии клавиши Escape: 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 - Останавливает любую текущую запись трека в Guru Maps.
  3. guru://recordTrack?action=toggle - Переключает статус записи трека. Если запись в данный момент идет, это действие остановит ее. Если записи нет, это действие начнет новую запись.
примечание

Если задано неверное действие или действие не указано, API по умолчанию переключит состояние записи (toggle). Это означает, что guru://recordTrack будет вести себя так же, как guru://recordTrack?action=toggle.

Создание метки​

API: guru://saveMarker[?name=<имя метки>][&coord=lat,lon]

После создания метки должны быть открыты ее детали.

Параметры:

  • 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, приложение откроет указанный URL возврата.

Примеры:

  1. guru://show?place=52.2297,21.0122 - Откроет Guru Maps и отобразит указанную точку на карте.
  2. guru://show?place=52.2297,21.0122,17 - Откроет Guru Maps и отобразит указанную точку на карте с 17-м масштабом.
  3. guru://show?place=52.2297,21.0122&back_url=https://gurumaps.app - Откроет Guru Maps, отобразит указанную точку и, если будет нажата клавиша Escape, откроется https://gurumaps.app.
примечание

Схема geo: также поддерживается Guru Maps. Например, вы можете использовать geo:52.2297,21.0122, чтобы отобразить определенное место на карте. Однако схема geo: не поддерживает параметр back_url. Для функционала, требующего параметра back_url, используйте схему guru://.