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

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

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

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

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

Параметры:

  • 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=<search query>[&coord=lat,lon]

Параметры:

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

Примеры:

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

Параметры:

  • finish - координаты конечной точки маршрута
  • via - координаты промежуточных точек маршрута. Можно использовать несколько промежуточных точек
  • start - координаты начальной точки маршрута. Если не задана, используется текущее положение пользователя
  • mode - режим передвижения (auto, bicycle, pedestrian, motor_scooter, motorcycle, truck, straight). Если не задан, используется auto
  • start_navigation - если установлено в true, навигация запустится сразу после построения маршрута. Если параметр не установлен или установлен в false - будет показан экран просмотра и редактирования маршрута.

Примеры:

  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

Старт/стоп записи трека​

API: guru://toggleTrackRecord

guru://toggleTrackRecord Начинает или останавливает запись трека.

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

API: guru://saveMarker[?name=<marker 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: geo://lat,lon[,zoom]

Параметры:

  • lat,lon - координаты точки, которую нужно отобразить на карте
  • zoom - масштаб, на котором нужно отобразить выбранную точку. Если не задан, будет использован текущий масштаб карты.

Примеры:

  1. geo://52.2297,21.0122 - Откроет карту и покажет детали выбранной точки.
  2. geo://52.2297,21.0122,17 - Откроет карту и покажет детали выбранной точки на 17-ом масштабе.