Интерактивна контрола на картата
Добавете лесно интерактивна карта към вашите приложения за платно. Начертайте маркери от източник на данни, съдържащи адреси или двойки географска ширина и дължина. При намаляване на мащаба маркерите по желание ще се групират, за да се сгъстят групите от данни. На мобилни устройства и уеб изживявания картата може да показва текущата позиция на потребителя и да изчислява маршрут до дестинацията на потребителя. Картите могат да се превключват между пътни и сателитни изгледи.
Интерактивни функции на картата
- Използване на източник на данни за вмъкване на маркери
- Показване на информация за маркери на картата
- Покажете маршрути между точките
- Чертане и вмъкване на форми в карти
Предварителни изисквания
Ще трябва да задоволите няколко предпоставки преди да можете да използвате карти във вашите приложения за платно. Вижте таблица за поверителност и сигурност за повече подробности относно това как различните функции на картата използват данни.
Добавяне на карта към екран на приложение
С приложение, отворено за редактиране в Power Apps Studio:
- Изберете раздела Поставете и разгънете Мултимедия.
- Изберете Карта, за да поставите карта в екрана на приложението, или плъзнете елемента за управление към екрана, за да го позиционирате по-точно.
Добавяне на карфици, маршрути и форми
Pins, routes и shapes са свойства на набор от данни, които трябва както да идентифицират източник на данни, което е таблица от колекция или конектор, така и съответните колони. източник на данни се задава в свойството Items (Items за щифтове, RouteWaypoints_Items за маршрути, Shape_Items за форми) и съответните колони се задават в свързаните свойства (напр. ItemLatitudes, ItemLongitudes и т.н. за щифтове). Секцията Свойства съдържа допълнителна информация за тези набори от данни и свързаните с тях свойства.
Например, ако сте имали колекция от таблици с име Местоположения с Име, Географска дължина и Географска ширина колони:
| Име | Географска дължина | Географска ширина |
|---|---|---|
| Четвърто кафе (пример) | -98.29277 | 26.2774 |
| Litware, Inc. (пример) | -96.85572 | 32.55253 |
| Adventure Works (пример) | -96.99952 | 32.72058 |
За да ги покажете като обозначени кабърчета на картата:
Задайте свойството Елементи на Местоположения
Задайте свойството ItemLabels на „Име”
Задайте свойството ItemLongitude на "Географска дължина"
Задайте свойството ItemLatitude на "Географска ширина"
Важно
Съответните имена на колони трябва да са в кавички в свързаните свойства. източник на данни не трябва да има кавички.
Можете да видите как да направите показване на щифтове от лист на Excel или създайте приложение, което използва контролата за въвеждане на адрес, за да попълни щифтове на контролата на картата като допълнителни примери.
Бележка
- Всяка контрола на картата може да показва до 5000 пина от географска ширина или дължина и 50 пина от адреси. Ограничението на щифта е по-ниско за адресите, тъй като картата трябва да геокодира тези адреси в географска ширина или дължина, за да ги покаже. Препоръчваме да не използвате адреси, където е възможно. Можете да запазите геокодирани адреси обратно в източник на данни си.
- Когато е дадена географска ширина или дължина и адрес за един щифт, контролата на картата ще даде приоритет на използването на географската ширина или дължина, за да се избегне геокодирането на адреса.
- Максималният брой фигури, които могат да бъдат начертани в контрола на карта, е ограничен до 500.
Свойства
Променете поведението и външния вид на карта с помощта на свойства. Някои имоти са налични само на Разширено раздел.
Контролът на картата има шест различни типа свойства:
- Свойства за стилизиране
- Поведенчески свойства
- Свойства на щифтовете
- Свойства на маршрута
- Свойства на формата
- Изходни свойства
Свойства за стилизиране
| Свойство | Описание | Тип | Табулатор |
|---|---|---|---|
| Изглед от сателит | Показва картата в сателитен изглед. Оставете това свойство изключено, за да покажете картата в изглед на пътя. | Boolean | Свойства; Разширено: SatelliteView |
| Стил на картата | Задава стила на картата. Опции: Път, Нощ, Засенчен релеф на пътя, Сателит, Сателитни пътни етикети, Светлина с висок контраст, Тъмно с висок контраст, Светла скала на сивото, Тъмна скала на сивото. | Изброена стойност | Свойства |
| Прозрачност | Определя прозрачността на картата от 0 (непрозрачен) до 100 (прозрачен). | Integer | Свойства; Разширено: Прозрачност |
| Видим | Показва или скрива картата. | Boolean | Свойства; Разширено: Visible |
| Позиция | Поставя горния ляв ъгъл на картата в координатите на екрана, посочени в x и y. | Число с плаваща запетая | Свойства; Разширено: X, Y |
| Размер | Определя размера на картата, като използва стойностите на пикселите, предоставени в Ширина и Височина. | Integer | Свойства; Разширено: Width, Height |
| Радиус на граница | Определя радиуса на ъгъла на границата на картата. | Число с плаваща запетая | Свойства; Разширено: BorderRadius |
| Граница | Определя стила, ширината и цвета на границата на картата. | Неприложимо | Имоти; Разширено: BorderStyle, BorderThickness, BorderColor |
| DisplayMode | Определя дали контрола позволява въвеждане от потребителя (редактиране), показва само данни (изглед) или е деактивирана (забранено). | Изброена стойност | Напреднали |
Поведенчески свойства
| Свойство | Описание | Тип | Табулатор |
|---|---|---|---|
| Показване на инфокарти | Показва информация относно картографирано местоположение, когато потребителят го избере (При щракване) или сочи към него (При задържане). Ако е няма, не се показва информация. | Изброена стойност | Свойства; Разширено: Инфокарти |
| Използване на местоположение по подразбиране | Инициализира картата на местоположение по подразбиране. | Boolean | Свойства; Разширено: DefaultLocation |
| Географска ширина по подразбиране | Задава координатите на географската ширина, които картата показва, ако е активирана функцията Използване на местоположението по подразбиране. | Число с плаваща запетая | Свойства; Разширено: DefaultLatitude |
| Географска дължина по подразбиране | Задава координатите на географската дължина, които картата показва, ако е активирана функцията Използване на местоположението по подразбиране. | Число с плаваща запетая | Свойства; Разширено: DefaultLongitude |
| Ниво на мащабиране по подразбиране | Задава нивото на мащабиране, ако Използвайте местоположението по подразбиране е активирано, от 0 до 22. | Integer | Свойства; Разширено: DefaultZoomLevel |
| Показване на текущо местоположение | Показва текущото местоположение на потребителя. | Boolean | Свойства; Разширено: CurrentLocation |
| Географска ширина на текущо местоположение | Задава координатите на географската ширина на щифта на текущото местоположение, който картата показва, ако е активирана функцията Показване на текущото местоположение. За да поставите щифта в текущото местоположение на потребителя, задайте това свойство на Местоположение.Географска ширина. | Число с плаваща запетая | Свойства; Разширено: CurrentLocationLatitude |
| Географска дължина на текущо местоположение | Задава координатите на географската дължина на щифта на текущото местоположение, който картата показва, ако е активирана функцията Показване на текущото местоположение. За да поставите ПИН на текущото местоположение на потребителя, задайте това свойство на Местоположение.Дължина. | Число с плаваща запетая | Свойства; Разширено: CurrentLocationLongitude |
| Контрола за мащабиране | Показва контрола за мащабиране. | Boolean | Свойства; Разширено: Увеличаване |
| Контрола на компас | Показва управлението на компаса. | Boolean | Свойства; Разширено: Компас |
| Контрола на стъпка | Показва управлението на стъпката (наклона). | Boolean | Свойства; Разширено: Височина |
| TabIndex | Указва реда, в който се избира картата, ако потребителят навигира в приложението с помощта на клавиша Tab. | Integer | Свойства; Разширено: Tab index |
| Пояснение | Определя текста, който да се показва, когато потребителят задържи курсора на мишката върху визуално изображение. | String | Напреднали |
| ContentLanguage | Определя езика на показване на картата, ако е различен от езика, използван в приложението. | String | Напреднали |
| OnLoad | Съдържа код, който се изпълнява при зареждане на картата. | Събитие | Напреднали |
| OnMapClick | Съдържа код, който се изпълнява, когато потребителят избере картата. Географската ширина и дължина на щракнатата точка е в Щракнало местоположение изходно свойство. | Събитие | Напреднали |
| OnChange | Съдържа код, който се изпълнява, когато някой аспект на картата бъде променен. | Събитие | Напреднали |
| OnSelect | Съдържа код, който се изпълнява, когато потребителят избере нещо на картата. | Събитие | Напреднали |
Свойства на щифтовете
| Свойство | Описание | Тип | Табулатор |
|---|---|---|---|
| Местоположения (артикули) | Идентифицира източник на данни (Предмети) под формата на таблица, от която да получите местоположения за показване на картата. Таблицата изброява набори от дължини и ширини или физически адреси, които да се показват като кабърчета. Използването на географска ширина или дължина се препоръчва, тъй като адресите трябва да бъдат геокодирани и така да имат по-ограничителна граница на щифта. Таблицата може да бъде колекция или от източник на данни като Excel Online. Всеки ред трябва да има запис за етикет, дължина и ширина или физически адрес и по избор цвят и икона на карфица. | Неприложимо | Свойства; Разширено: Елементи |
| ItemsLabels | Идентифицира колоната в Предмети който съдържа етикетите за щифтовете. | ColumnName | Напреднали |
| ItemsLatitudes | Идентифицира колоната в Елементи, която съдържа позицията на географската ширина на щифтовете. | ColumnName | Напреднали |
| ItemsLongitudes | Идентифицира колоната в Елементи, която съдържа позицията на географската дължина на щифтовете. | ColumnName | Напреднали |
| ItemsAddresses | Идентифицира колоната в Елементи, която съдържа адреси, представляващи местоположението на щифтовете. Има ограничение за това колко пина могат да се показват от адреси. Препоръчваме да геокодирате вашите адреси по двойки географска ширина, дължина и да ги използвате за показване на кабърчета, когато е възможно. | ColumnName | Напреднали |
| ItemsColors | Идентифицира колоната в Елементи, която съдържа цветовете на маркерите. | ColumnName | Напреднали |
| ItemsIcons | Идентифицира колоната в Елементи, която съдържа иконите на маркерите. | ColumnName | Напреднали |
| Клъстерни маркери | Групира близките карфици на картата, вместо да ги показва поотделно. | Boolean | Свойства; Разширено: Клъстеризация |
| Цвят на маркер | Определя цвета по подразбиране на кабърчетата, показани на картата. Този цвят се заменя от ItemsColors свойство, ако е зададено | Избирач на цветове | Свойства; Разширено: PinColor |
| OnItemsChange | Съдържа код, който се изпълнява при промяна на щифтовете на картата. | Събитие | Напреднали |
Свойства на маршрута
| Свойство | Описание | Тип | Табулатор |
|---|---|---|---|
| Активиране на маршрутизиране | Определя дали потребителят може да поиска указания до определено място. | 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 | Съдържа код, който се изпълнява, когато приложението открие, че потребителят е променил посоката, докато е на изчислен маршрут. | Събитие | Напреднали |
Свойства на формата
| Свойство | Описание | Тип | Табулатор |
|---|---|---|---|
| Показване на форми | Показва формите в 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 | Улавя и последното местоположение, избрано от потребителя .Latitude или .Longitude. | Запис |
| Избрана | Улавя избрания щифт. | Запис |
| Избрани елементи | Заснема избрания щифт или щифтове в избрания клъстер. | Table |
| Геокодирани елементи | Заснема геокодираните местоположения на щифтовете. | Table |
| RouteWaypoints_Selected | Съответства на записа на избраната форма в RouteWaypoints_Items. | Запис |
| RouteWaypoints_SelectedItems | Отговаря на записите на избраните припокриващи се фигури в RouteWaypoints_Items. | Table |
| Shapes_Selected | Съответства на записа на избраната форма в Shapes_Items. | Запис |
| Shapes_SelectedItems | Отговаря на записите на избраните припокриващи се фигури в Shapes_Items. | Table |
| SelectedShape | Записва .Perimeter и .Area на избраната форма. | Запис |
| DeletedShape | Записва .Perimeter и .Area на последната изтрита форма. | Запис |
| GeoJSON | Улавя списъка с форми във формат Feature Collection GeoJSON. | String |
Други геопространствени контроли
За да видите предложения за динамичен адрес, докато пишете, използвайте контролата Въвеждане на адрес.
Бележка
Можете ли да ни споделите повече за езиковите си предпочитания за документацията? Попълнете кратко проучване. (имайте предвид, че това проучване е на английски език)
Проучването ще отнеме около седем минути. Не се събират лични данни (декларация за поверителност).
Известни ограничения
- Изисква интернет връзка
Вижте също
Създаване на приложение с контролите „Address input“ и „Map“
Обратна връзка
Очаквайте скоро: През цялата 2024 г. постепенно ще отстраняваме проблемите в GitHub като механизъм за обратна връзка за съдържание и ще го заменим с нова система за обратна връзка. За повече информация вижте: https://aka.ms/ContentUserFeedback.
Подаване и преглед на обратна връзка за