Елемент керування інтерактивною картою
З легкістю додайте інтерактивну карту у компоновані програми. Позначки нанесення з джерела даних, що містять адреси або пари широти й довготи. При зменшенні масштабу позначки можуть за потреби об’єднуватись, щоб утворювати щільні групи даних. На мобільних пристроях і веб-інтерфейсі на карті можна переглянути поточне місце розташування користувача та обчислити маршрут до місця призначення користувача. Карти можна переключати між поданнями шляхів і переходів.
Інтерактивні функції карти
- Використання джерела даних для вставлення шпильок
- Відображайте відомості про прикріплення карти
- Відображення маршрутів між маршрутними точками
- Креслення і вставлення фігур
вимоги
Щоб використовувати карти в компонованих програмах, потрібно задовольнити кілька попередніх вимог. Див. таблицю приватності та безпеки, щоб отримати додаткову інформацію про те, як різні функції карти використовують дані.
Додавання карти на екран програми
З програмою, відкритою для редагування в Power Apps Studio, виконайте описані нижче дії.
- Відкрийте вкладку Вставлення та розгорніть елемент Медіа.
- Виберіть компонент Карта, щоб розташувати карту на екрані програми, або перетягніть елемент керування на екран, щоб розташувати в більш точному місці екрана.
Додавання позначень, маршрутів і фігур
Позначення, маршрути та фігури — це властивості набору даних, для яких необхідно визначити джерело даних (таблиця з колекції або з’єднувач) і відповідні стовпці. Джерело даних встановлюється у властивості елементів (елементи для позначень, RouteWaypoints_Items для маршрутів, Shape_Items для фігур), а відповідні стовпці встановлюються у відповідних властивостях (наприклад, ItemLatitudes, ItemLongitudes тощо для позначень). У розділі Властивості містяться додаткові відомості про ці набори даних і пов’язані властивості.
Наприклад, якщо у вас є колекція таблиць із іменем Розташування зі стовпцями Ім'я, Довгота і Широта:
| Ім'я | Довгота | Широта |
|---|---|---|
| Fourth Coffee (зразок) | -98.29277 | 26.2774 |
| Litware, Inc. (зразок) | -96.85572 | 32.55253 |
| Adventure Works (зразок) | -96.99952 | 32.72058 |
Щоб на карті відображались ці позначення з надписами, виконайте такі дії.
Установіть для властивості Елементи значення «Розташування»
Для властивості Надписи елемента установіть значення «Ім’я»
Установіть для властивості Довгота елементу значення «Довгота»
Установіть для властивості Широта елементу значення «Широта»
Важливо
Імена відповідних стовпців мають бути в лапках у пов’язаних властивостях. У джерелі даних лапок не має бути.
Ви можете переглянути, як застосовувати позначки відображення на аркуші Excel або створити програму, що використовує елемент керування введенням адреси для заповнення позначень на елементі керування картою як додатковий приклад.
Примітка
- Кожен елемент керування картою може відображати до 5000 контактів із широти або довготи та 50 пінів із адрес. Ліміт контактів є нижчим для адрес, оскільки для їх відображення на карті потрібно геокодувати ці адреси в широту або довготу. Радимо не використовувати адреси там, де це можливо. Ви можете зберігати геокодовані адреси назад у свій джерело даних.
- Якщо для одного контакту вказано одночасно широту або довготу та адресу, елемент керування картою матиме пріоритет використання широти або довготи, щоб уникнути геокодування адреси.
- Максимальна кількість фігур, які можна намалювати в елементі керування картою, обмежена 500.
Властивості
Змініть поведінку та зовнішній вигляд карти, використовуючи властивості. Деякі властивості доступні лише на вкладці Додатково.
Елемент керування картою має шість різних типів властивостей.
- Властивості стилю
- Властивості поведінки
- Властивості позначень
- Властивості маршруту
- Властивості форми
- Властивості, що виводяться
Властивості стилю
| Властивість | Опис | Ввести | Tab |
|---|---|---|---|
| Супутникове подання | Відображення карти в супутниковому поданні. Залиште цю властивість, щоб відобразити карту в поданні дороги. | Boolean | Властивості, додатково: SatelliteView (супутникове подання) |
| Стиль карти | Установлює стиль карти. Параметри: дорога, ніч, рельєф із затіненням доріг, супутник, підписи доріг для супутникового подання, світлий контрастний, темний контрастний, світлі відтінки сірого, темні відтінки сірого. | Перелік | Властивості |
| Прозорість | Визначає прозорість карти з 0 (непрозорості) до 100 (прозора). | Ціле число | Властивості; додатково: Прозорість |
| Видимий | Відображення або приховування карти. | Boolean | Властивості; Розширені: Visible (Видимі) |
| Положення | Розміщує верхній лівий кут карти на екрані з координатами, указаними в X і Y. | Число з рухомою комою | Властивості; додатково: X, Y |
| Розмір | Визначає розмір карти за допомогою значень у пікселях, передбачених у полях Ширина та Висота. | Ціле число | Властивості; додатково: Width (Ширина), Height (Висота) |
| Радіус межі | Визначає радіус кута межі карти. | Число з рухомою комою | Властивості; додатково: BorderRadius (Радіус межі) |
| Рамка | Визначає стиль, ширину та колір межі карти. | Незастосовно | Властивості; додатково: BorderStyle (Стиль межі), BorderThickness (Товщина межі), BorderColor (Колір межі) |
| DisplayMode | Визначає, чи елемент керування дозволяє користувачу вводити дані (Редагування), лише відображає дані (Перегляд) або є вимкнутим (Вимкнуто). | Перелік | Досвідчений |
Властивості поведінки
| Властивість | Опис | Ввести | Tab |
|---|---|---|---|
| Показати інформаційні картки | Показує інформацію про зіставлене розташування, коли користувач вибирає його (Після клацання) або вказує на нього (Під час наведення курсору миші). Якщо значення Немає, відомості не відображаються. | Перелік | Властивості; додатково InfoCards (інформаційні картки) |
| Використовувати стандартне розташування | Ініціалізує карту з розташуванням за замовчуванням. | Boolean | Властивості; додатково: DefaultLocation (розташування за замовчуванням) |
| Стандартна широта | Встановлює координати широти, яку має відображати карта, якщо увімкнуто Використовувати розташування за замовчуванням. | Число з рухомою комою | Властивості; додатково: DefaultLatitude (широта за замовчуванням) |
| Стандартна довгота | Встановлює координати довготи, яку має відображати карта, якщо увімкнуто Використовувати розташування за замовчуванням. | Число з рухомою комою | Властивості; додатково: DefaultLongitude (довгота за замовчуванням) |
| Стандартний рівень масштабування | Встановлює рівень масштабування, якщо ввімкнено Використання розташування за замовчуванням від 0 до 22. | Ціле число | Властивості; додатково: DefaultZoomLeve (рівень масштабування за замовчуванням) |
| Показати поточне розташування | Відображає поточне розташування користувача. | Boolean | Властивості; додатково: CurrentLocation (поточне розташування) |
| Широта поточного розташування | Установлює координати широти поточного позначення розташування, яке відображає карта, якщо увімкнено Показати поточне розташування. Щоб розмістити PIN-код у поточному розташуванні користувача, установіть для цієї властивості значення Location.Latitude. | Число з рухомою комою | Властивості; додатково: CurrentLocationLatitude (поточна широта місця розташування) |
| Довгота поточного розташування | Установлює координати довготи поточного позначення розташування, яке відображає карта, якщо увімкнено Показати поточне розташування. Щоб розмістити маркер у поточному розташуванні користувача, установіть для цієї властивості значення Location.Longitude. | Число з рухомою комою | Властивості; додатково: CurrentLocationLongitude (поточна довгота місця розташування) |
| Керування масштабом | Показує елемент керування масштабуванням. | Boolean | Властивості; додатково: Zoom (Масштабування) |
| Керування компасом | Показує елемент керування компасом. | Boolean | Властивості; додатково: Compass (компас) |
| Керування нахилом | Показує елемент керування нахилом. | Boolean | Властивості; додатково: Pitch (Нахил) |
| TabIndex | Указує порядок вибору карти, якщо користувач переміщує програму за допомогою клавіші tab. | Ціле число | Властивості; додаткові: Покажчик вкладки |
| Підказка | Визначає текст для відображення, коли користувач наводить курсор на візуальне зображення. | String | Досвідчений |
| Мова вмісту | Визначає мову відображення карти, якщо вона відрізняється від мови, яка використовується в програмі. | String | Досвідчений |
| При завантаженні | Містить код, який запускається під час завантаження карти. | Захід | Досвідчений |
| OnMapClick | Містить код, який запускається, коли користувач вибирає карту. Широта та довгота вибраної точки знаходяться у властивості виводу ClickedLocation. | Захід | Досвідчений |
| При зміненні | Містить код, який запускається в разі змінення будь-якого аспекту карти. | Захід | Досвідчений |
| OnSelect | Містить код, який запускається, коли користувач вибирає щось на карті. | Захід | Досвідчений |
Властивості позначень
| Властивість | Опис | Ввести | Tab |
|---|---|---|---|
| Розташування(елементи) | Визначає джерело даних (елементи) у формі таблиці, з якої можна отримати розташування для відображення на карті. У таблиці перелічені набори довгот і широт, або фізичні адреси для відображення як позначення. Рекомендується використовувати широту або довготу, оскільки адреси мають бути геокодовані, а отже, мають більш обмежувальний ліміт контактів. Таблиця може бути набором або з будь-якого джерела даних, як у Excel Online. У кожному рядку має бути запис для надпису, довготи та широти чи фізичної адреси, а також закріплення кольору та піктограми. | Незастосовно | Властивості; Розширені: Items (Елементи) |
| ItemsLabels | Визначається стовпець у Елементах, які містять надписи для позначень. | ColumnName | Досвідчений |
| ItemsLatitudes | Визначає стовпець у Елементах, які містять позицію широти для позначень. | ColumnName | Досвідчений |
| ItemsLongitudes | Визначає стовпець у Елементах, які містять позицію довготи для позначень. | ColumnName | Досвідчений |
| ItemsAddresses | Визначає стовпець у елементах, що містить адреси, які відповідають розташуванню позначок. Існує обмеження на кількість позначок, які можна відображати з адрес. Рекомендуємо геокодувати адреси парами широти та довготи, а також за можливості відображати позначки. | ColumnName | Досвідчений |
| ItemsColors | Визначає стовпець у Елементах, які містять колір для позначень. | ColumnName | Досвідчений |
| ItemsIcons | Визначає стовпець у Елементах, які містять піктограми для позначень. | ColumnName | Досвідчений |
| Позначки групування | Групуйте сусідні позначки карти замість окремого їх відображення. | Boolean | Властивості; додатково: Clustering (Групування) |
| Колір позначки | Визначає колір позначок за замовчуванням, який буде відображено на карті. Цей колір буде замінено властивістю ItemsColors, якщо встановлено | Палітра кольорів | Властивості; додатково: PinColor (Колір позначки) |
| OnItemsChange | Містить код, який запускається в разі змінення будь-якої позначки на карті. | Захід | Досвідчений |
Властивості маршруту
| Властивість | Опис | Ввести | Tab |
|---|---|---|---|
| Увімкнути прокладання маршруту | Указує, чи можна запитати маршрути до вказаного розташування. | Boolean | Властивості; додатково: UseRouting (Використовувати маршрутизацію) |
| Маршрутні точки (елементи) | Показує точки маршруту, як вказано у джерелі даних (RouteWaypoints_Items) у формі таблиці. Таблиця може бути набором або з будь-якого джерела даних, як у Excel Online. Якщо значення Немає, маршрутні точки не відображатимуться. | Перелік | Властивості; додатково: RouteWaypoints_Items |
| RouteWaypointsLabels | Визначається стовпець у RouteWaypoints_Items, який містить надписи для маршрутних точок. | ColumnName | Досвідчений |
| RouteWaypointsLatitudes | Визначає стовпець у RouteWaypoints_Items, який містить позицію широти для маршрутних точок. | ColumnName | Досвідчений |
| RouteWaypointsLongitudes | Визначає стовпець у RouteWaypoints_Items, який містить позицію довготи для маршрутних точок. | ColumnName | Досвідчений |
| RouteWaypointsAddresses | Визначає стовпець у RouteWaypoints_Items, що містить адреси, які відповідають розташуванню маршрутних точок. | ColumnName | Досвідчений |
| Зберігати порядок точок | Указує, чи має обчислюваний маршрут підтримувати маршрутні точки в наданому замовленні. | Boolean | Властивості; додатково: RouteMaintainOrder (Зберігати порядок точок) |
| Оптимізувати маршрут | Указує, чи оптимізований обчислюваний маршрут для відстані, часу або його не оптимізовано. | Перелік | Властивості; додатково: RouteOptimization (Оптимізація маршруту) |
| Спосіб пересування | Визначає, чи розраховується маршрут для автомобіля або вантажівки, що може вимагати уникнення мостів із певними обмеженнями висоти чи ваги. | Перелік | Властивості; додатково: RouteTravelMode (Спосіб пересування) |
| OnRouteDirectionChange | Містить код, який запускається, коли програма виявляє, що користувач змінив напрямок на обчисленому маршруті. | Захід | Досвідчений |
Властивості форми
| Властивість | Опис | Ввести | Tab |
|---|---|---|---|
| Відображати фігури | Відображаються фігури в Shapes_Items. | Boolean | Властивості; додатково: ShowShapes (Відображати форми) |
| Shapes_Items | Визначає джерело даних (Shapes_Items) у формі таблиці, з якої можна отримати форми для відображення на карті. Таблиця може бути набором або з будь-якого джерела даних, як у Excel Online. У кожного рядка має бути запис форми (об'єкт GeoJSON) і (необов’язково) надпис і колір. | TableName | Досвідчений |
| ShapeGeoJSONObjects | Визначає стовпець у Shapes_Items із рядками, які представляють об’єкти GeoJSON фігур, колекції фігур або формат однієї фігури GeoJSON. | ColumnName | Досвідчений |
| ShapeLabels | Визначається стовпець у Shapes_Items, які містять надписи для форм. | ColumnName | Досвідчений |
| ShapeColors | Визначається стовпець у Shapes_Items, які містять кольори для форм. | ColumnName | Досвідчений |
| Відображати підписи фігур | Якщо вони вказані, надписи фігур відображаються. | Boolean | Властивості; додатково: ShowShapeLabels (Відображати надписи форми) |
| Дозволити креслити фігури | Показує засоби графічного відображення на карті. | Boolean | Властивості; додатково: ShapeDrawing (Креслення форм) |
| Увімкніть видалення фігур і редагування надписів | Указує, чи можна видалити фігури та редагувати їхні надписи. | Boolean | Властивості; додатково: ShapeEditingDeleting (Видалення й редагування форм) |
| OnShapeCreated | Містить код, який запускається, коли користувач додає форму на карті. | Захід | Досвідчений |
| OnShapeSelected | Містить код, який запускається, коли користувач вибирає форму на карті. | Захід | Досвідчений |
| OnShapeEdited | Містить код, який запускається, коли користувач змінює форму на карті. | Захід | Досвідчений |
| OnShapeDeleted | Містить код, який запускається, коли користувач видаляє форму на карті. | Захід | Досвідчений |
Властивості, що виводяться
Інші властивості стають доступними, коли користувач взаємодіє з картою. Ці властивості виводу можна використовувати в інших елементах керування або для налаштування взаємодії з програмою.
| Властивість | Опис | Ввести |
|---|---|---|
| CenterLocation | Записує центр карти. | Незастосовно |
| ClickedLocation | Записує останнє розташування вибраного користувача. Широта або Довгота. | Записати |
| Вибрані | Записує вибрану позначку. | Записати |
| SelectedItems | Записує вибрану позначку або позначки у вибраній групі об’єктів. | Table |
| GeocodedItems | Записує геокодовані розташування позначок. | Table |
| RouteWaypoints_Selected | Відповідає запису вибраної форми у RouteWaypoints_Items. | Записати |
| RouteWaypoints_SelectedItems | Відповідає запису вибраних форм накладання у RouteWaypoints_Items. | Table |
| Shapes_Selected | Відповідає запису вибраної форми у Shapes_Items. | Записати |
| Shapes_SelectedItems | Відповідає запису вибраних форм накладання у Shapes_Items. | Table |
| SelectedShape | Записує Периметр і Область вибраної фігури. | Записати |
| DeletedShape | Записує Периметр і Область останньої видаленої фігури. | Записати |
| GeoJSON | Записує список фігур на карті в форматі GeoJSON колекції функцій. | String |
Інші геопросторові елементи керування
Щоб бачити динамічні підказки для адрес під час введення тексту, використовуйте елемент керування Введення адреси.
Примітка
Розкажіть нам про свої уподобання щодо мови документації? Візьміть участь в короткому опитуванні. (зверніть увагу, що це опитування англійською мовою)
Проходження опитування займе близько семи хвилин. Персональні дані не збиратимуться (декларація про конфіденційність).
Відомі обмеження
- Необхідне підключення до Інтернету
Див. також
Створення програми з елементами керування Address Input і Map