Карта

Данный компонент содержит слои (отображает и динамически обновляет геозоны, устройства, выражения таблицы узлов), отображает географическую карту, дорожную карту, карту местности или спутниковое изображение. В качестве источника геоинформационных данных и изображений используются карты Google, Bing Maps, OpenStreetMap, Yandex Maps и 2GIS.

Компонент Карт" выглядит следующим образом:

Масштабирование и прокрутка

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

Масштабирование (приближение/отдаление) осуществляется при помощи прокрутки колеса мыши. Другой способ приблизить карту - использовать счетчик масштабитрования и кнопки масштабирования, расположеные в верхнем левом углу компонента Карта.

Система координат

Данный компонент использует WGS84 систему координат. Любое устройство, предоставляющее данные о местоположении AggreGate, должно быть настроено на использование WGS84 координат для корректного отображения на карте.

Общие свойства

Ширина, Высота, Привязки, Видимый, Рамка, Всплывающее меню

Пользовательские свойства

Автоопределение уровня масштабирования

Дает команду отрисовщику карты настроить уровень масштабирования автоматически, чтобы центр карты, все метки и пути отображались в окне компонента без прокрутки.

Имя свойства: detectZoom

Тип свойства: Логическое

Уровень масштабирования

Масштаб определяет разрешение текущего вида. Возможны уровни масштабирования от 0 (самый низкий уровень, при котором на карте отображен весь мир) до 21+ (вплоть до отдельных зданий).

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

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

Если для данного местоположения нет доступных данных и уровня масштабирования, на карте появится пустое изображение.

Имя свойства: zoom

Тип свойства: Целое

Типы карт

Выбирает поставщик географических данных для карт. Поддерживаются следующие источники карт:

  • Offline Map. Использует офлайн карты, локально хранящиеся на компьютере, запускающем виджет с компонентом карты. Подробности смотрите в разделе Папка хранения офлайн карт.
  • Open Street Map - Mapnic. Классическая, поддерживаемая обществом версия Open Street Map.
  • Open Street Map - MapQuest. Другая версия Open Street Map.
  • Open Street Map - IP / Hostname. Имя хоста/ IP адрес локального сервера OpenStreetMap.
  • Bing Maps - Roadmap. Стандартное изображение карты дорог, использующее Bing Maps в качестве поставщика. Требует установки Bing API Key.
  • Bing Maps - Aerial. Аэроснимки, использующие Bing Maps в качестве поставщика. Требует установки Bing API Key.
  • Bing Maps - Hybrid. Комбинированное (карта дорог + аэроснимки) изображение, использующие Bing Maps в качестве поставщика. Требует установки Bing API Key.
  • Google Maps - Roadmap. Стандартное изображение карты дорог, использующее Google Maps в качестве поставщика. Требует установки Google Client ID и Google API Key.
  • Google Maps - Satellite. Спутниковое изображение, использующее Google Maps в качестве поставщика. Требует установки Google Client ID и Google API Key.
  • Google Maps - Terrain. Изображение рельефа, использующее Google Maps в качестве поставщика. Требует установки Google Client ID и Google API Key.
  • Google Maps - Hybrid. Комбинированное изображение (карта дорог + спутник), использующее Google Maps в качестве поставщика. Требует установки Google Client ID и Google API Key.
  • Yandex Maps - Roadmap. Стандартное изображение карты дорог, использующее Yandex Maps в качестве поставщика.
  • Yandex Maps - Satellite. Спутниковое изображение, использующее Yandex Maps в качестве поставщика.
  • Yandex Maps - Hybrid. Комбинированное изображение (карта дорог + спутник), использующее Yandex Maps в качестве поставщика.
  • 2GIS. Очень подробное изображение определенных городов (в данный момент доступно на территории Российской Федерации).

Имя свойства: mapType

Тип свойства: Строка

Папка хранения офлайн карт

Определяет папку, хранящую данные офлайн карт. Доступна, когда Источник карты настроен на Офлайн карты. Этот путь папки может быть абсолютным или относительным в системе файлов компьютера, запускающего виджет, который содержит компонент Карта.

Значение по умолчанию - tiles, то есть данные офлайн карт хранятся в подпапке /tiles папки, в которой установлен AggreGate Client или Проигрыватель виджетов.

См. Использование офлайн карт, чтобы узнать, как подготовить данные офлайн карт.

Имя свойства: offlineMapStorage

Тип свойства: Строка

IP / Адрес локального сервера

Определяет имя хоста/ IP адрес локального сервера Open Street Map. Доступно при настройке Источник карты на Open Street Map - IP / Hostname.

Имя свойства: ipHostname

Тип свойства: Строка

Изображение при ошибке

Изображение, появляющееся при ошибке извлечения фрагмента карты.

Имя свойства: errorImage

Тип свойства: Блок данных

Идентификатор клиента google

Используемый идентификатор Клиента, если Источник Карты настроен на Google.

Имя свойства: googleClientId

Тип свойства: Строка

Ключ API google

Используемый ключ API для Google Maps.

Имя свойства: googleApiKey

Тип свойства: Строка

Ключ API bing

Используемый ключ API для Bing Maps.

Имя свойства: bingApiKey

Тип свойства: Строка

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

Свойства положения

Тип

Данная настройка определяет центрирование карты:

  • Автоматически. Карта центрируется для отображения всех устройств и путевых точек. Данную опцию можно сочетать с автоматически определяемым уровнем масштабирования, чтобы убедиться, что карта отображает все доступные данные.
  • Геолокация. Позволяет центрировать карту при помощи геокодирования, т.е. названия города, адреса улицы или почтового индекса.
  • Широта/Долгота. Ручной ввод координат центра карты (широта и долгота).

Имя свойства: locationType

Тип свойства: Целое

Геолокация

Данная опция включена, если типом местонахождения является Геолокация. Она определяет геокод центрирования карты, например Berkeley,CA.

Имя свойства: geoLocation

Тип свойства: Строка

Если вы хотит использовать сервис геолокации без ограничений, пожалуйста, введите Ключ API Google c Идентификатором клиента Google.

Широта

Данная опция включена, если типом местонахождения является Широта/Долгота. Она определяет широту  фиксированного центра карты.

Имя свойства: latitude

Тип свойства: Плавающее

Долгота

Данная опция включена, если типом местонахождения является Широта/Долгота. Она определяет долготу  фиксированного центра карты.

Имя свойства: longitude

Тип свойства: Плавающее

Общие события

Скрытие, Показ, Перемещение, Изменение размеров, Клик мыши, Нажатие кнопки мыши, Отпускание кнопки мыши, Вход мыши, Выход мыши, Перемещение мыши, Вращение колесика мыши, Печать клавиши, Нажатие клавиши, Отпускание клавиши, Получение фокуса, Потеря фокуса

Пользовательские события

Клик мыши и Двойной клик мыши

Имеют дополнительные поля:

Поле

Имя

Тип

Описание

широта

latitude

c плавающеей запятой

Широта координат клика мыши.

долгота

longitude

c плавающеей запятой

Долгота координат клика мыши.