Импорт Zenrin Japan Map API 3.0 (Itsumo NAVI API 3.0) в сценарий вождения

Zenrin Japan Map API 3.0 (Itsumo NAVI API 3.0)^[1] , разработанный ZENRIN DataCom CO., LTD., является веб-сервисом, который позволяет вам получить доступ к данным карты для областей в Японии. Используя приложение Driving Scenario Designer, можно импортировать данные карты из сервиса Zenrin Japan Map API 3.0 (Itsumo NAVI API 3.0) и использовать ее для генерации дорог для ваших сценариев вождения.

Этот пример посвящен импорту данных карты в приложении. Кроме того, чтобы импортировать данные Zenrin Japan Map API 3.0 (Itsumo NAVI API 3.0) в drivingScenario объект, использовать roadNetwork функция.

Для импорта данных карты из сервиса Zenrin Japan Map API 3.0 (Itsumo NAVI API 3.0) требуется пакет поддержки Automated Driving Toolbox™ Importer for Zenrin Japan Map API 3.0 (Itsumo NAVI 3.0) Service. Для получения информации об установке пакетов поддержки см. раздел «Получение и управление дополнениями».

Настройка учетных данных Japan Map API 3.0 (Itsumo NAVI API 3.0)

Для доступа к сервису Zenrin Japan Map API 3.0 (Itsumo NAVI API 3.0) необходимо ввести действительные учетные данные от ZENRIN DataCom CO., LTD. Настройте эти учетные данные при помощи zenrinCredentials функция. В MATLAB^® в командной строке введите:

zenrinCredentials setup

В диалоговом окне «Учетные данные» Zenrin Japan Map API 3.0 (Itsumo NAVI API 3.0) введите допустимые Client ID и Secret Key. Чтобы сохранить учетные данные для будущих сеансов работы с MATLAB на компьютере, в диалоговом окне выберите Save my credentials between MATLAB sessions и нажмите OK. Теперь учетные данные сохраняются для остальных сеансов работы с MATLAB на вашем компьютере.

Если вам нужно изменить свои учетные данные, можно удалить их и настроить новые таковые с помощью zenrinCredentials функция.

Определение географических координат

Чтобы выбрать дороги, которые вы хотите импортировать, необходимо задать необходимую область, из которого можно получить данные о дорогах. Чтобы определить эту необходимую область, задайте координаты широты и долготы, которые находятся рядом с этими данными о дороге. Можно задать координаты для одной точки или набора точек, такие как таковые, образующие ведущую трассу.

Задайте координаты от ведущего маршрута.

Загрузите последовательность координат широты и долготы, которые составляют ведущий маршрут. В командной строке MATLAB введите следующие команды:
```
data = load('tokyoSequence.mat');
lat = data.latitude;
lon = data.longitude;
```
Откройте приложение.
```
drivingScenarioDesigner
```
На панели инструментов приложения выберите Import и затем Zenrin Japan Map API 3.0 (Itsumo NAVI API 3.0). Если вы ранее вводили или сохраняли учетные данные Zenrin Japan Map API 3.0 (Itsumo NAVI API 3.0), то диалоговое окно откроется непосредственно на странице, где можно задать географические координаты.

Оставьте From Workspace выбранным, а затем выберите переменные для координат трассы.

Установите параметр Latitude равным lat.
Установите параметр Longitude равным lon.

В этой таблице описывается полный список опций для определения координат широты и долготы.

Задайте значение параметров географических координат	Описание	Значение параметров широты	Значение параметров долготы
From Workspace	Задайте набор координат широты и долготы, например, из маршрута вождения, полученного через GPS. Эти координаты должны храниться как переменные в рабочем пространстве MATLAB.	Переменная рабочей области, содержащая векторы десятичных значений в области значений [-90, 90]. Модули указаны в степенях. Latitude и Longitude должны быть одинакового размера. После выбора переменной Latitude, список Longitude включает только переменные того же размера, что и выбор Latitude.	Переменная рабочей области, содержащая векторы десятичных значений в области значений [-180, 180]. Модули указаны в степенях. Latitude и Longitude должны быть одинакового размера. После выбора переменной Longitude, если вы выбираете переменную Latitude другого размера, диалоговое окно очищает выбор Longitude.
Input Coordinates	Задайте координаты широты и долготы для одной географической точки.	Десятичный скаляр в области значений [-90, 90]. Модули указаны в степенях.	Десятичный скаляр в области значений [-180, 180]. Модули указаны в степенях.

Задайте значение параметров географических координат

Описание

Значение параметров широты

Значение параметров долготы

From Workspace

Задайте набор координат широты и долготы, например, из маршрута вождения, полученного через GPS. Эти координаты должны храниться как переменные в рабочем пространстве MATLAB.

Переменная рабочей области, содержащая векторы десятичных значений в области значений [-90, 90]. Модули указаны в степенях.

Latitude и Longitude должны быть одинакового размера. После выбора переменной Latitude, список Longitude включает только переменные того же размера, что и выбор Latitude.

Переменная рабочей области, содержащая векторы десятичных значений в области значений [-180, 180]. Модули указаны в степенях.

Latitude и Longitude должны быть одинакового размера. После выбора переменной Longitude, если вы выбираете переменную Latitude другого размера, диалоговое окно очищает выбор Longitude.

Input Coordinates

Задайте координаты широты и долготы для одной географической точки.

Десятичный скаляр в области значений [-90, 90]. Модули указаны в степенях.

Десятичный скаляр в области значений [-180, 180]. Модули указаны в степенях.

Выберите область, содержащий дороги

После задания координат широты и долготы в Select Region разделе диалогового окна эти координаты отображаются на карте оранжевым цветом. Отображается также географическая контрольная точка, которая является первой координатой в ведущем маршруте. Эта точка является источником импортированного сценария. Щелкните эту точку, чтобы показать или скрыть данные координат.

Координаты соединяются линией. Прямоугольная необходимая область отображается вокруг координат. На следующей странице диалогового окна вы выбираете дороги для импорта, исходя из того, какие дороги находятся хотя бы частично в этой области.

Street map with plotted coordinates in orange and a bounding box in black

Вы можете изменить размер этой области или переместить его вокруг, чтобы выбрать различные дороги. Для масштабирования и изменения масштаба области используйте кнопки в правом верхнем углу отображения карты.

Так как координаты все еще находятся внутри области, нажмите Next.

Выберите дороги для импорта

После выбора области в Select Roads разделе диалогового окна отображаются доступные для выбора дороги черного цвета.

The same street map with plotted coordinates in orange and selectable roads in black

Используя выбранную область, выберите дороги, ближайшие к маршруту, нажав Select Nearest Roads. Выбранные дороги накладываются на маршрут движения и появляются синим цветом.

The same street map with selected roads in blue

В этой таблице описываются дополнительные действия, которые можно выполнить для выбора дорог из области.

Цель	Действие
Выберите отдельные дороги из области.	Щелкните отдельные дороги, чтобы выбрать их.
Выберите все дороги из области.	Нажмите Select All.
Выберите из области все дороги, кроме нескольких.	Щелкните Select All, а затем щелкните отдельные дороги, чтобы отменить их выбор.
Выберите дороги из области, наиболее близкой к заданным координатам.	Нажмите Select Nearest Roads. Используйте эту опцию, когда у вас есть последовательность неразборных координат. Если ваши координаты разрежены, или базовые данные для этих координат разрежены, приложение может не выбрать ближайшие дороги.
Выберите подмножество дорог из области, например все дороги в верхней половине области.	В левом верхнем углу карты нажмите кнопку «Выбрать дороги». Затем нарисуйте прямоугольник вокруг дорог, которые нужно выбрать. Чтобы отменить выбор подмножества дорог из этого выбора, нажмите кнопку «Отменить выбор дорог». Затем нарисуйте прямоугольник вокруг дорог, чтобы отменить выбор. Чтобы отменить выбор всех дорог и начать сначала, нажмите кнопку Deselect All.

Примечание

Количество выбранных дорог напрямую влияет на эффективность приложения. Выберите наименьшее количество дорог, необходимое для создания сценария вождения.

Импорт дорог

Если ближайшие к маршруту дороги все еще выбраны, нажмите Import. Приложение импортирует данные Zenrin Japan Map API 3.0 (Itsumo NAVI API 3.0) и генерирует дорожную сеть.

A generated road network

Чтобы сохранить то же выравнивание с отображением географической карты, X ось Scenario Canvas находится снизу, а Y - слева. В сценариях вождения, которые не импортируются с карт, ось X -слева, а ось Y - снизу. Это выравнивание соответствует мировой системе координат Automated Driving Toolbox.

Источник сценария соответствует географической ссылочной точке и является первой точкой, заданной в маршруте движения. Даже если вы выбираете дороги из конца маршрута, источник все еще привязывается на этой первой точке. Если вы задаете одну географическую точку при помощи опции Input Coordinates, то источником является эта точка.

По умолчанию взаимодействие дорог отключено. Отключенные дорожные взаимодействия препятствуют случайному изменению сети и уменьшают визуальное загромождение, скрывая дорожные центры. Если требуется изменить дороги, в левом нижнем углу Scenario Canvas нажмите кнопку Configure the Scenario Canvas. Затем выберите Enable road interactions.

Примечание

В некоторых случаях приложение не может импортировать все выбранные дороги. Эта проблема может возникнуть, если кривизна дороги слишком острая для того, чтобы приложение правильно визуализировало ее. В этих случаях приложение останавливает импорт, а диалоговое окно подсвечивает невозвратные дороги красным цветом. Чтобы продолжить импорт всех других выбранных дорог, нажмите Continue.

Сравнение импортированных дорог с данными карты

Сгенерированная дорожная сеть в приложении имеет несколько различия от фактической дорожной сети Zenrin Japan Map API 3.0 (Itsumo NAVI API 3.0). Например, когда сервис Zenrin Japan Map API 3.0 (Itsumo NAVI API 3.0) предоставляет информацию с использованием области значений, например, путем определения дороги с двумя-тремя полосами или дороги с шириной 3-5,5 метра, сгенерированная дорожная сеть использует вместо этого скалярные значения.

Для получения дополнительной информации об ограничениях дорожных сетей, сгенерированных данными Zenrin Japan Map API 3.0 (Itsumo NAVI API 3.0), смотрите раздел «Ограничения» Driving Scenario Designer страницы с описанием приложения.

Сценарий сохранения

Сохраните файл сценария. После сохранения сценария в него нельзя импортировать дополнительные дороги Zenrin Japan Map API 3.0 (Itsumo NAVI API 3.0). Вместо этого нужно создать новый сценарий и импортировать новую дорожную сеть.

Теперь можно добавить актёров и датчики в сценарий, сгенерировать синтетические обнаружения маршрута и объектов для проверки алгоритмов вождения или импортировать сценарий в Simulink^®.

См. также

Внешние веб-сайты

ZENRIN DataCom CO., LTD.

^[1] Чтобы получить доступ к сервису Zenrin Japan Map API 3.0 (Itsumo NAVI API 3.0) и получить необходимые учетные данные (идентификатор клиента и секретный ключ), необходимо заключить отдельное соглашение с ZENRIN DataCom CO., LTD.

Документация