Уважаемые коллеги и пользователи приложения Navi-Maps GPS Navigator Украина + Европа (OSM).
Представляем полезную информацию по возможностям вызова и передачи ведения по маршруту в программу Нави-Мапс GPS навигатор Украина через другие мобильные приложения (такие как: приложения служб такси, диспетчерские службы, службы логистики и доставки)
Информация по продукту Navi-Maps API
Описание:
Navi-Maps API представляет собой навигационную программу Navi—Maps GPS Navigator с дополнительными сервисами, предназначенными для межпрограммного обмена между навигационной программой и другими приложениями, установленными на устройстве.
Где используется
Navi-Maps API может использоваться для реализации рабочего места водителя такси, а в частности, для обмена данными между навигационной программой Navi—Maps и внешними приложениями для связи с диспетчерской службой.
Платформы:
Возможности Navi-Maps API предназначены для работы на платформе Android начиная с версии от 4.4 и выше.
Вызов программы:
Вызов навигационной программы из стороннего приложения производится следующим образом (исх. код на Java с использованием Android API):
try
{
Intent intent=new Intent();
intent.setAction(Intent.ACTION_SEND);
intent.setType(«vnd.android.cursor.item/vnd.net.probki.cityguide.cmd»
intent.setPackage(«ua.travelgps.navimaps»); // здесь указывается имя пакета программы
intent.putExtra(Intent.EXTRA_TEXT,»cgcmd …»); // здесь вместо … пишутся команды
startActivity(intent);
}
catch(Exception ex)
{
}
Имена пакетов для setPackage следующие:
— «ua.travelgps.navimaps» для программы Navi—Maps (как указано в примере выше)
Внимание! Параметр setType(«vnd.android.cursor.item/vnd.net.probki.cityguide.cmd») для семейства вызова остальных программ самейства Navi-Maps и СитиГИД — остается неизменным.
Вызов Intent приводит к тому что навигационная программа запускается (если не была до этого запущена) и выходит на передний план.
Команды задаются строкой как EXTRA_TEXT для Intent. Если строку не задавать, то навигационная программа просто выводится на передний план.
Командная строка должна начинаться с ключевого слова cgcmd. Если это не так, то вся строка полностью игнорируется.
Каждая команда состоит из ключевого слова, за которым могут следовать несколько параметров, разделенных пробелами.
Команды:
Поддерживаются следующие команды:
delroute
delroute — Удалить текущий маршрут. Дополнительных параметров нет.
setroute
setroute <N> <lat1> <lon1> <lat2> <lon2> …
Задать маршрут. Параметры:
<N> — количество точек маршрута. Последняя точка является финишем, остальные — промежуточными точками маршрута.
Далее следуют <N> пар «широта долгота», заданные в градусах.
Например: setroute 1 60.367 30.542 – если надо задать точку финиша с координатами 60.367 30.542
view
view <lat> <lon> <orient> <incline> <scale>
Команда view позволяет задать отображение карты.
Параметры:
<lat> <lon> — широта и долгота точки отображения в градусах. Можно указать 0 0, тогда точка не меняется.
<orient> — поворот карты. Целочисленное значение в градусах в пределах от -360 до +360. При других значениях — поворот карты не меняется.
<incline> — наклон перспективы. Целочисленное значение в градусах от 0 до 80. При отрицательном значении — наклон не меняется.
<scale> — масштаб отображения. Целочисленное значение знаменателя. При значении 0 — масштаб не меняется.
hide
hide
Убрать навигационную программу с экрана в фоновый режим. Дополнительных параметров нет. Команда имеет смысл если программа находится на переднем плане.
Примеры:
Несколько команд можно указывать друг за другом в одной строке.
Пример общей командной строки:
«cgcmd delroute setroute 1 60.367 30.5 view 60.367 30.542 361 -1 100000″
Это означает:
— Удалить имеющийся маршрут.
— Задать новый маршрут единственной точкой финиша в координатах <60.367N 30.542E>.
— Отобразить заданные координаты на экране в масштабе 1:100000, не меняя поворота карты и угла наклона.
Мы надеемся что у Вас получится использовать в своих приложениях «вызов» отображения качественных карт Украины от travelGPS и успешно применять навигацию Navi-Maps GPS для такси, служб доставки, вызовов скорой помощи, почтовых и других служб.