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