Обчислення маршрутів між мітками маршрутних точок на карті (попередня версія)

[Цей розділ є документацією для попередньої версії, і його буде змінено.]

Елемент керування картою в компонованій програмі може додавати мітки маршрутних точок, використовуючи дані, імпортовані з таблиці в книгу Excel. Елемент керування може обчислювати маршрути між маршрутними точкам, змінити маршрутні точки й перерахувати маршрут для оптимізації часу або відстані у подорожі.

Важливо

• Це функція попереднього перегляду.
• Підготовчі функції призначені для невиробничого використання і можуть бути обмежені. Ці функції доступні до офіційного випуску, щоб клієнти могли ознайомитися з ними заздалегідь і залишити відгуки.

Вам знадобиться джерело даних з іменованою таблицею з такими стовпцями. Кожен стовпець відповідає розширеній властивості елемента керування картою. Кожен рядок закріплений як маршрутна точка на карті.

Ім’я стовпця	Відповідає	Обов'язковий
Ім'я (або надпис)	RouteWaypointsLabels	Необов'язково
Довгота	RouteWaypointsLongitudes	Необов’язково (обов’язково, якщо адресу не вказано)
Широта	RouteWaypointsLatitudes	Необов’язково (обов’язково, якщо адресу не вказано)
Адреса	RouteWaypointsAddresses	Необов’язково (обов’язково, якщо не вказано довготу та широту)

Примітка

Усі властивості технічно необов’язкові. Однак для відображення розташування маршрутної точки потрібно вказати принаймні одну адресу або пару широти та довготи.

Імпорт міток маршрутних точок з таблиці Excel

У цьому прикладі буде імпортовано дані маршрутних точок з таблиці Excel із назвою TestData.

Створення джерела даних

1. Створіть таблицю в Excel із такими даними. Назвіть таблицю TestData.

   Ім'я	Довгота	Широта	Адреса
   Робота	-122.156481	47.663448	1 Microsoft Way, Redmond, WA 98052
   Зустрітися	-122.221037	47.57137
   Плавання	-122.144133	47.600373
   Теніс	-122.137265	47.616115

   Ваша таблиця має виглядати наведеним нижче чином.

   

2. Збережіть книгу у OneDrive для бізнесу та закрийте файл.

Прив’язування джерела даних до елементу керування картою.

1. Створіть компоновану програму. Переконайтеся у відповідності геопросторовим попереднім вимогам.

2. Вставте елемент керування картою.

3. На вкладці Властивості елемента керування виберіть поле Маршрутні точки(Елементи) і введіть excel.

   

4. Виберіть Імпорт із Excel.

5. Перейдіть до OneDrive для бізнесу і виберіть книгу Excel, збережену раніше.

6. Виберіть таблицю TestData і натисніть Підключити.

   

7. На вкладці Додатково знайдіть RouteWaypointsLabels, RouteWaypointsLatitudes, RouteWaypointsLongitudes і RouteWaypointsAddresses і введіть назви відповідних стовпців у таблиці. (У цьому прикладі введіть Ім'я у полі RouteWaypointsLabels, Широту в полі RouteWaypointsLatitudes тощо). Назву стовпця потрібно вказувати в лапках.

   Примітка

   Адреса взаємозамінна із Широтою та Довготою. Якщо вказано широту й довготу, то адресу не використовують. Якщо адресу вказано, широту та довготу вказувати не потрібно. Існує обмеження на кількість маршрутних точок, які можна відображати під час використання адреси, тому, якщо це можливо, використовуйте значення широти та довготи.

Мітки відображаються на карті в місцях, описаних координатами або адресами в таблиці. Якщо таблиця містить надписи, мітки позначаються. Мітки нумеруються в порядку відображення розташування маршрутних точок у таблиці.

Розрахування маршрутів між маршрутними точками

З вибраним елементом керування картами відкрийте вкладку Властивості і ввімкніть Маршрутизацію.

Елемент керування обчислює маршрути між закріпленими маршрутними точками.

Примітка

За замовчуванням елемент керування картами змінює розташування середніх маршрутних точок, щоб зменшити час подорожі або відстані подорожі. Перша та остання маршрутні точки вважаються початком і місцем призначенням, їх не можна змінити. Щоб підтримувати маршрутні точки в замовленні, заданому джерело даних, увімкніть властивість елементу керування Зберігати порядок точок.

Властивості

Змінити спосіб обчислення маршруту за допомогою властивостей.

Властивість	Опис	Ввести	Tab
Увімкнути прокладання маршруту	Розрахування маршрутів між маршрутними точками.	Boolean	Властивості; додатково: UseRouting (Використовувати маршрутизацію)
Зберігати порядок точок	Указує, чи має обчислюваний маршрут підтримувати маршрутні точки в наданому замовленні в джерелі даних.	Boolean	Властивості; додатково: RouteMaintainOrder (Зберігати порядок точок)
Оптимізувати маршрут	Указує, чи оптимізований обчислюваний маршрут для відстані, часу або його не оптимізовано.	Розкривний список	Властивості; додатково: RouteOptimization (Оптимізація маршруту)
Спосіб пересування	Визначає, чи розраховується маршрут для автомобіля або вантажівки, що може вимагати уникнення мостів із певними обмеженнями висоти чи ваги.	Розкривний список	Властивості; додатково: RouteTravelMode (Спосіб пересування)
Показувати маршрутні мітки	Визначає, чи будуть мітки відображатися на точках маршруту.	Boolean	Властивості; додатково ShowRoutePins (Показати мітки маршруту)

Властивості, що виводяться

Деякі властивості стають доступними лише в разі змінення обчислюваного маршруту. Ці властивості виводу розміщено в об'єкті RouteDirection. Подія OnRouteDirectionChange рекомендується для використання вихідних даних у інших елементах керування або настроювання взаємодії.

Властивість	Опис	Ввести	Tab
OnRouteDirectionChange	Містить код, який запускається під час зміни маршруту.	Захід	Досвідчений
RouteDirection	Описує результати маршрутизації. LengthInMeters — відстань у метрах цілого маршруту TravelTimeInSeconds — очікуваний час подорожі в секундах усього маршруту RouteGeoJSON — рядок, що описує маршрут у форматі GeoJSON RouteLegs — таблиця з описом властивостей кожної частини маршруту: Покажчик — номер, що відповідає послідовності частин у маршруті LengthInMeters — відстань у метрах частини маршруту TravelTimeInSeconds — очікуваний час подорожі в секундах для частини маршруту StartLabel — надпис початкової точки частини маршруту StartLatitude — широта початкової точки частини маршруту StartLongitude — довгота початкової точки частини маршруту StartAddress — адреса початкової точки частини маршруту EndLabel — надпис кінцевої точки частини маршруту EndLatitude — широта кінцевої точки частини маршруту EndLongitude — довгота кінцевої точки частини маршруту EndAddress — адреса кінцевої точки частини маршруту OrderedWaypoints — таблиця з описом кожної точки в маршруті після розташування маршрутних точок в певній послідовності. Покажчик — номер, що відповідає послідовності точок у маршруті Надпис: надпис точки маршруту Широта: широта маршрутної точки Довгота — довгота маршрутної точки Адреса: адреса маршрутної точки	Об'єкт	Не застосовується (властивість лише для виводу)

Див. також

Елемент керування інтерактивною картою