Элемент управления Интерактивная карта
Легко добавляйте интерактивную карту в свои приложения на основе холста. Нанесите маркеры из источника данных, содержащего адреса или пары широты и долготы. При уменьшении масштаба маркеры могут группироваться для уплотнения групп данных. На мобильных устройствах и в веб-интерфейсе карта может отображать текущее положение пользователя и рассчитывать маршрут к месту назначения пользователя. Карты можно переключать между видом с дороги и видом со спутника.
Функции интерактивной карты
- Использование источника данных для вставки булавок
- Отображение информации о булавках карты
- Отображение маршрутов между путевыми точками
- Рисование и вставка фигур
Предварительные условия
Вам нужно будет выполнить несколько предварительных условий, прежде чем вы сможете использовать карты в своих приложениях на основе холста. Обратитесь к таблице конфиденциальности и безопасности для получения более подробной информации о том, как различные функции карты используют данные.
Добавление карты на экран приложения
С вашим приложением, открытым для редактирования в Power Apps Studio:
- Выберите вкладку Вставить и разверните Мультимедиа.
- Выберите Карта, чтобы разместить карту на экране приложения, или перетащите элемент управления на экран, чтобы расположить его более точно.
Добавление булавок, маршрутов и фигур
Булавки, маршруты и формы — это свойства набора данных, которые должны идентифицировать как источник данных, который представляет собой таблицу из коллекции или соединителя, так и соответствующие столбцы. Источник данных устанавливается в свойстве Items (Items для булавок, RouteWaypoints_Items для маршрутов, Shape_Items для фигур), а соответствующие столбцы устанавливаются в связанных свойствах (например, ItemLatitudes, ItemLongitudes и т. д. для булавок). Раздел Свойства содержит дополнительную информацию об этих наборах данных и связанных с ними свойствах.
Например, если у вас есть коллекция таблиц с именем Местоположения со столбцами Имя, Долгота и Широта:
| Имя | Долгота | Широта |
|---|---|---|
| Fourth Coffee (пример) | -98,29277 | 26.2774 |
| Litware, Inc. (пример) | -96,85572 | 32,55253 |
| Adventure Works (образец) | -96,99952 | 32,72058 |
Чтобы отобразить их как помеченные булавки на карте:
Задайте свойству Items значение "Местоположения"
Для свойства ItemLabels задайте значение "Имя"
Для свойства ItemLongitude задайте "Долгота"
Для свойства ItemLatitude задайте "Широта"
Важно!
Соответствующие имена столбцов должны быть заключены в кавычки в связанных свойствах. Источник данных не должен заключаться в кавычки.
Вы можете увидеть, как отображать булавки из листа Excel или создать приложение , которое использует элемент управления Ввод адреса для заполнения булавок на элементе управления Карта в качестве дополнительных примеров.
Примечание
- Каждый элемент управления карты может отображать до 5000 отметок широты или долготы и 50 отметок адресов. Для адресов ограничение по отметкам меньше, так как карта должна геокодировать эти адреса по широте или долготе для их отображения. Мы рекомендуем не использовать адреса там, где это возможно. Можно сохранять геокодированные адреса обратно в источник данных.
- Для отметок, у которых указаны широта/долгота и адрес, элемент управления карты будет отдавать приоритет использованию широты/долготы, чтобы избежать геокодирования адреса.
- Максимальное количество фигур, которые можно нарисовать в элементе управления "Карта", ограничено (500).
Свойства
Измените поведение и внешний вид карты с помощью свойств. Некоторые свойства доступны только на вкладке Дополнительно.
У элемента управления Карта имеются шесть различных типов свойств:
- Свойства оформления
- Свойства поведения
- Свойства булавок
- Свойства маршрута
- Свойства фигуры
- Выходные свойства
Свойства оформления
| Свойство | Описание | Тип | Вкладка |
|---|---|---|---|
| Satellite view | Отображает карту в виде со спутника. Оставьте это свойство выключенным, чтобы отобразить карту в виде дороги. | Логический | Свойства; Дополнительно: SatelliteView |
| Map style | Задает стиль карты. Варианты: Road, Night, Road shaded relief, Satellite, Satellite road labels, High contrast light, High contrast dark, Grayscale light, Grayscale dark. | Перечисление | Свойства |
| Transparency | Определяет прозрачность карты, от 0 (непрозрачная) до 100 (прозрачная). | Целое | Свойства; Дополнительно: Transparency |
| Visible | Показывает или скрывает карту. | Логический | Свойства; Дополнительно: Visible |
| Position | Помещает левый верхний угол карты в координаты экрана, указанные в x и y. | Число с плавающей запятой | Свойства; Дополнительно: X, Y |
| Size | Определяет размер карты, используя значения пикселей, указанные в Width и Height. | Целое | Свойства; Дополнительно: Width, Height |
| Border radius | Определяет радиус углов границы карты. | Число с плавающей запятой | Свойства; Дополнительно: BorderRadius |
| Border | Определяет стиль, ширину и цвет границы карты. | Неприменимо | Свойства; Дополнительно: BorderStyle, BorderThickness, BorderColor |
| DisplayMode | Определяет, допускает ли элемент управления пользователю вводить данные (Edit), только отображает данные (View) или элемент вообще отключен (Disabled). | Перечисление | Расширенные |
Свойства поведения
| Свойство | Описание | Тип | Вкладка |
|---|---|---|---|
| Show info cards | Показывает информацию о местоположении на карте, когда пользователь выбирает его (По щелчку) или указывает на него (При наведении). Если выбрано Нет, информация не отображается. | Перечисление | Свойства; Дополнительно: InfoCards |
| Use default location | Инициализирует карту в местоположении по умолчанию. | Логический | Свойства; Дополнительно: DefaultLocation |
| Default latitude | Устанавливает координату широты, которую показывает карта, если Использовать местоположение по умолчанию включено. | Число с плавающей запятой | Свойства; Дополнительно: DefaultLatitude |
| Default longitude | Устанавливает координату долготы, которую показывает карта, если Использовать местоположение по умолчанию включено. | Число с плавающей запятой | Свойства; Дополнительно: DefaultLongitude |
| Default zoom level | Устанавливает уровень масштабирования, если включено Использовать местоположение по умолчанию, от 0 до 22. | Целое | Свойства; Дополнительно: DefaultZoomLevel |
| Show current location | Отображает текущее местоположение пользователя. | Логический | Свойства; Дополнительно: CurrentLocation |
| Current location latitude | Устанавливает координату широты текущей булавки местоположения, которую показывает карта, если свойство Show current location включено. Чтобы поместить булавку на текущее расположение, задайте для этого свойства значение Location.Latitude. | Число с плавающей запятой | Свойства; Дополнительно: CurrentLocationLatitude |
| Current location longitude | Устанавливает координату долготы текущей булавки местоположения, которую показывает карта, если свойство Show current location включено. Чтобы поместить булавку на текущее расположение, задайте для этого свойства значение Location.Longitude. | Число с плавающей запятой | Свойства; Дополнительно: CurrentLocationLongitude |
| Zoom control | Показывает элемент управления масштабированием. | Логический | Свойства; Дополнительно: Zoom |
| Compass control | Показывает элемент управления компасом. | Логический | Свойства; Дополнительно: Compass |
| Pitch control | Показывает элемент управления наклоном. | Логический | Свойства; Дополнительно: Pitch |
| TabIndex | Указывает порядок выбора карты, если пользователь перемещается по приложению с помощью клавиши Tab. | Целое | Свойства; Дополнительно: Tab index |
| Tooltip | Определяет текст, отображаемый при наведении курсора на визуальный элемент. | Строка | Расширенные |
| ContentLanguage | Определяет язык отображения карты, если он отличается от языка, используемого в приложении. | Строка | Дополнительно |
| OnLoad | Содержит код, который запускается при загрузке карты. | Событие | Дополнительно |
| OnMapClick | Содержит код, который запускается, когда пользователь выбирает карту. Широта и долгота выбранной точки находятся в выходном свойстве ClickedLocation. | Событие | Дополнительно |
| OnChange | Содержит код, который запускается при изменении любого аспекта карты. | Событие | Расширенные |
| OnSelect | Содержит код, который запускается, когда пользователь что-то на карте. | Событие | Дополнительно |
Свойства булавок
| Свойство | Описание | Тип | Вкладка |
|---|---|---|---|
| Locations(Items) | Определяет источник данных (Элементы) в виде таблицы, из которого можно получить местоположения для отображения на карте. В таблице перечислены наборы долготы и широты или физических адресов, которые будут отображаться в виде булавок. Рекомендуется использовать широту или долготу, так как адреса должны быть геокодированы и, следовательно, иметь более строгий лимит отметок. Таблица может быть коллекцией или получаться из источник данных, например Excel Online. Каждая строка должна иметь запись для метки, долготы и широты или физического адреса, а также, возможно, цвет и значок булавки. | Неприменимо | Свойства; Дополнительно: Items |
| ItemsLabels | Идентифицирует столбец в Items, который содержит метки для булавок. | ColumnName | Расширенные |
| ItemsLatitudes | Идентифицирует столбец в Элементы, который содержит расположение по широте для булавок. | ColumnName | Расширенные |
| ItemsLongitudes | Идентифицирует столбец в Элементы, который содержит расположение по долготе для булавок. | ColumnName | Расширенные |
| ItemsAddresses | Идентифицирует столбец в Items, который содержит адреса, которые представляют расположение булавок. Существует ограничение на количество булавок, которые могут отображаться из адресов. Мы рекомендуем геокодировать ваши адреса в пары широты и долготы и использовать их для отображения булавок, когда это возможно. | ColumnName | Дополнительно |
| ItemsColors | Идентифицирует столбец в Элементы, который содержит цвета булавок. | ColumnName | Расширенные |
| ItemsIcons | Идентифицирует столбец в Элементы, который значки булавок. | ColumnName | Дополнительно |
| Cluster pins | Группирует близлежащие булавки на карте вместо их отображения по отдельности. | Логический | Свойства; Дополнительно: Clustering |
| Pin color | Определяет цвет булавок, отображаемых на карте. Этот цвет переопределяется свойством ItemsColors, если оно установлено | Цветоподборщик | Свойства; Дополнительно: PinColor |
| OnItemsChange | Содержит код, который запускается при изменении булавок на карте. | Событие | Дополнительно |
Свойства маршрута
| Свойство | Описание | Тип | Вкладка |
|---|---|---|---|
| Enable routing | Определяет, может ли пользователь запрашивать направление к указанному местоположению. | Логический | Свойства; Дополнительно: UseRouting |
| Route waypoints(Items) | Показывает путевые точки маршрута, как указано в источнике данных (RouteWaypoints_Items) в виде таблицы. Таблица может быть коллекцией или получаться из источник данных, например Excel Online. Если None, точки маршрута не отображаются. | Перечисление | Свойства; Дополнительно: RouteWaypoints_Items |
| RouteWaypointsLabels | Идентифицирует столбец в RouteWaypoints_Items, который содержит метки для точек маршрута. | ColumnName | Расширенные |
| RouteWaypointsLatitudes | Идентифицирует столбец в RouteWaypoints_Items, который содержит расположение по широте путевых точек. | ColumnName | Расширенные |
| RouteWaypointsLongitudes | Идентифицирует столбец в RouteWaypoints_Items, который содержит расположение по долготе путевых точек. | ColumnName | Расширенные |
| RouteWaypointsAddresses | Идентифицирует столбец в RouteWaypoints_Items, который содержит адреса, которые представляют расположение точек маршрута. | ColumnName | Дополнительно |
| Сохранять порядок промежуточных точек | Определяет, поддерживает ли рассчитанный маршрут путевые точки в указанном порядке. | Логический | Свойства; Дополнительно: RouteMaintainOrder |
| Optimize route | Определяет, оптимизирован ли рассчитанный маршрут по расстоянию, времени или нет. | Перечисление | Свойства; Дополнительно: RouteOptimization |
| Route travel mode | Определяет, рассчитывается ли маршрут для автомобиля или грузовика, что может потребовать избегать мостов с определенными ограничениями по высоте или весу. | Перечисление | Свойства; Дополнительно: RouteTravelMode |
| OnRouteDirectionChange | Содержит код, который запускается, когда приложение обнаруживает, что пользователь изменил направление во время движения по вычисляемому маршруту. | Событие | Дополнительно |
Свойства фигуры
| Свойство | Описание | Тип | Вкладка |
|---|---|---|---|
| Show shapes | Показывает фигуры в Shapes_Items. | Логический | Свойства; Дополнительно: ShowShapes |
| Shapes_Items | Определяет источник данных (Shapes_Items) в виде таблицы, из которого можно получить фигуры для отображения на карте. Таблица может быть коллекцией или получаться из источник данных, например Excel Online. Каждая строка должна иметь запись для формы (объект GeoJSON) и (необязательно) метку и цвет. | TableName | Расширенные |
| ShapeGeoJSONObjects | Идентифицирует столбец в Shapes_Items со строками, представляющими объекты GeoJSON фигур, в коллекции фигур или в формате GeoJSON одной фигуры. | ColumnName | Расширенные |
| ShapeLabels | Идентифицирует столбец в Shapes_Items, который содержит метки для фигур. | ColumnName | Расширенные |
| ShapeColors | Идентифицирует столбец в Shapes_Items, который содержит цвета фигур. | ColumnName | Дополнительно |
| Show shape labels | Показывает метки фигур, если они есть. | Логический | Свойства; Дополнительно: ShowShapeLabels |
| Enable shape drawing | Показывает инструменты рисования на карте. | Логический | Свойства; Дополнительно: ShapeDrawing |
| Enable shape deleting and label editing | Определяет, может ли пользователь удалять фигуры и редактировать их метки. | Логический | Свойства; Дополнительно: ShapeEditingDeleting |
| OnShapeCreated | Содержит код, который запускается, когда пользователь добавляет фигуру на карту. | Событие | Дополнительно |
| OnShapeSelected | Содержит код, который запускается, когда пользователь выбирает фигуру на карте. | Событие | Дополнительно |
| OnShapeEdited | Содержит код, который запускается, когда пользователь изменяет фигуру на карте. | Событие | Расширенные |
| OnShapeDeleted | Содержит код, который запускается, когда пользователь удаляет фигуру на карте. | Событие | Дополнительно |
Выходные свойства
Другие свойства становятся доступными, когда пользователь взаимодействует с картой. Вы можете использовать эти выходные свойства в других элементах управления или для настройки взаимодействия приложения.
| Свойство | Описание | Тип |
|---|---|---|
| CenterLocation | Захватывает центральную точку карты. | Неприменимо |
| ClickedLocation | Захватывает последнее местоположение, выбранное пользователем, либо .Latitude, либо .Longitude. | Запись |
| Selected | Захватывает выбранную булавку. | Запись |
| SelectedItems | Захватывает выбранную булавку или булавки в выбранном кластере. | Таблица |
| GeocodedItems | Захватывает геокодированные местоположения булавок. | Таблица |
| RouteWaypoints_Selected | Соответствует записи выбранной фигуры в RouteWaypoints_Items. | Запись |
| RouteWaypoints_SelectedItems | Соответствует записям выбранных перекрывающихся фигур в RouteWaypoints_Items. | Таблица |
| Shapes_Selected | Соответствует записи выбранной фигуры в Shapes_Items. | Запись |
| Shapes_SelectedItems | Соответствует записям выбранных перекрывающихся фигур в Shapes_Items. | Таблица |
| SelectedShape | Захватывает .Perimeter и .Area выбранной формы. | Запись |
| DeletedShape | Захватывает .Perimeter и .Area последней удаленной фигуры. | Запись |
| GeoJSON | Захватывает список фигур в формате коллекции признаков GeoJSON. | Строка |
Другие элементы управления geospatial
Для просмотра предложений динамического адреса при вводе используйте элемент управления Ввод адреса.
Примечание
Каковы ваши предпочтения в отношении языка документации? Пройдите краткий опрос (обратите внимание, что этот опрос представлен на английском языке).
Опрос займет около семи минут. Личные данные не собираются (заявление о конфиденциальности).
Известные ограничения
- Необходимо подключение к интернету
См. также
Создание приложения с элементами управления Ввод адреса и Карта
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по