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.
Примеры:
- guru://open?url=https://gurumaps.app/example/feature_collection.geojson - импорт geojson по ссылке
- 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. Если не заданы, поиск начнется над текущим положением карты.
Примеры:
- guru://search?q=Wybrzeże%20Kościuszkowskie%2020%20Warszawa&coord=52.2297,21.0122 - Запустит поиск с запросом "Wybrzeże Kościuszkowskie 20 Warszawa" и центром карты установленным на заданные координаты.
- 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). Если не задан, используется autostart_navigation
- если установлено вtrue
, навигация запустится сразу после построения маршрута. Если параметр не установлен или установлен вfalse
- будет показан экран просмотра и редактирования маршрута.
Примеры:
- Построение маршрута из текущего положения до заданной точки: guru://nav?finish=52.2297,21.0122
- Построение маршрута от заданной точки до другой заданной точки: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222
- Построение маршрута с промежуточной точкой: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172
- Построение маршрута с двумя промежуточными точками: guru://nav?start=52.2297,21.0122&via=52.2347,21.0172&via=52.2765,21.234&finish=52.2397,21.0222
- Построение маршрута на велосипеде: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172&mode=bicycle
- Построение маршрута и немедленный запуск навигации: 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
- координаты метки. Если не заданы, будет использовано текущее положение пользователя.
Примеры:
- Создание метки на текущем положении пользователя: guru://saveMarker
- Создание метки на текущем положении пользователя с заданным именем: guru://saveMarker?name=MyMarker
- Создание метки на заданном положении: guru://saveMarker?coord=52.2297,21.0122
- Создание метки на заданном положении с заданным именем: guru://saveMarker?name=MyMarker&coord=52.2297,21.0122
Отображение места по заданным координатам на карте
API: geo://lat,lon[,zoom]
Параметры:
lat,lon
- координаты точки, которую нужно отобразить на картеzoom
- масштаб, на котором нужно отобразить выбранную точку. Если не задан, будет использован текущий масштаб карты.
Примеры:
- geo://52.2297,21.0122 - Откроет карту и покажет детали выбранной точки.
- geo://52.2297,21.0122,17 - Откроет карту и покажет детали выбранной точки на 17-ом масштабе.