Вызов программы Navi-Maps в режиме навигации из диспетчерских программ для такси и других

Уважаемые коллеги и пользователи приложения Navi-Maps GPS Navigator Украина + Европа (OSM).

Представляем полезную информацию по возможностям вызова и передачи ведения по маршруту в программу Нави-Мапс GPS навигатор Украина через другие мобильные приложения (такие как:  приложения служб такси, диспетчерские службы, службы логистики и доставки)

Информация по продукту Navi-Maps API

Описание:

Navi-Maps API представляет собой навигационную программу NaviMaps GPS Navigator с дополнительными сервисами, предназначенными для межпрограммного обмена между навигационной программой и другими приложениями, установленными на устройстве.

Где используется
Navi-Maps API может использоваться для реализации рабочего места водителя такси, а в частности, для обмена данными между навигационной программой NaviMaps и внешними приложениями для связи с диспетчерской службой.

Платформы:
Возможности 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»    для программы NaviMaps (как указано в примере выше)

Внимание! Параметр 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 для такси, служб доставки, вызовов скорой помощи, почтовых и других служб.