Карта

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

Общие переменные (свойства)

[?]

Общие переменные: Имя, Видимый, Свойства расширения, Ширина сетки, Высота сетки, Выход за пределы контента, Стиль контейнера, Пользовательские классы, Стиль

Масштаб

Определяет масштаб карты по умолчанию

Имя переменной:

zoom

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

zoom

Integer

Масштаб

Слои

Данное свойство позволяет определить слои карты и управлять их видимостью.

Имя переменной:

layers

Записи:

0..не ограничено

Формат записи:

Имя поля

Тип поля

Примечания

id

String

ID. Уникальный ID слоя.

name

String

Name. Имя слоя.

description

String

Description. Описание слоя.

show

Boolean

Show. Определяет видимость слоя.

Маркеры

Данное свойство позволяет определить отображение маркеров на выбранном слое карты и управлять их визуальным представлением.

Имя переменной:

markers

Записи:

0..не ограничено

Формат записи:

Имя поля

Тип поля

Примечания

id

String

ID.  Уникальный ID маркера.

layer

String

Layer. ID слоя карты для отображения маркера.

latitude

Double

Latitude. Широта маркера.

longitude

Double

Longitude. Долгота маркера.

riseOnHover

Boolean

Rise On Hover.

riseOffset

Integer

Z-index Rise Offset.

draggable

Boolean

Draggable.

popupOptions

Data Table

Popup Options.

tooltipOptions

Data Table

Tooltip Options.

style

String

Style. Стиль CSS, который будет применен к маркеру.

Пути

Данное свойство позволяет определить отображение путей на выбранном слое карты и управлять их визуальным представлением.

Имя переменной:

tracks

Записи:

0..не ограничено

Формат записи:

Имя поля

Тип поля

Примечания

id

String

ID. Уникальный ID пути.

polyline

Data Table

Polyline. Определяет точки, формирующие ломаную линию. Вложенная таблица данных с несколькими полями:

  • Latitude - широта точки
  • Longitude - долгота точки
  • Description - описание точки

description

String

Description. Описание пути.

layerId

String

Layer. ID слоя карты для отображения пути.

polylineStyleId

String

Polyline Style. Стиль CSS, который будет применен к ломаной линии.

circleMarkerStyleId

String

Point Style. Стиль CSS, который будет применен к круговому маркеру.

Области

Данное свойство позволяет определить отображение областей на выбранном слое карты и управлять их визуальным представлением.

Имя переменной:

areas

Записи:

0..не ограничено

Формат записи:

Имя поля

Тип поля

Примечания

id

String

ID. Уникальный ID области.

polyline

Data Table

Polyline. Определяет точки, формирующие область. Вложенная таблица данных с несколькими полями:

  • Latitude - широта точки
  • Longitude - долгота точки
  • Description - описание точки

description

String

Description. Описание области.

layerId

String

Layer. ID слоя карты для отображения области.

areaStyleId

String

Style. Стиль CSS, который будет применен к области.

Круглые области

Данное свойство позволяет определить отображение круглых областей на выбранном слое карты и управлять их визуальным представлением.

Имя переменной:

circleAreas

Записи:

0..не ограничено

Формат записи:

Имя поля

Тип поля

Примечания

id

String

ID. Уникальный ID круглой области.

description

String

Description. Описание круглой области.

latitude

Double

Latitude. Широта круглой области.

longitude

Double

Longitude. Долгота круглой области.

radius

Integer

Radius. Радиус круглой области, в пикселях.

layerId

String

Layer. ID слоя карты для отображения круглой области.

circleAreaStyleId

String

Style. Стиль CSS, который будет применен к круглой области.

Управление приближением

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

Имя переменной:

zoomControl

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

zoomControl

Boolean

Управление приближением

Показать строку поиска

Если включено, отображает строку поиска.

Имя переменной:

enableSearch

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

enableSearch

Boolean

Показать строку поиска

Ключ доступа для тайлов

Пользовательский ключ доступа, который будет добавляться к каждому запросу тайла.

Имя переменной:

accessToken

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

accessToken

String

Ключ доступа для тайлов

Широта

Определяет широту фиксированного центра карты.

Имя переменной:

latitude

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

latitude

Double

Широта

Долгота

Определяет долготу фиксированного центра карты.

Имя переменной:

longitude

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

longitude

Double

Долгота

Выбранный маркер

Указывает маркер, выбираемый по умолчанию. Значение данного поля должно соответствовать полю ID свойства Markers.

Имя переменной:

selectedMarker

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

selectedMarker

String

Выбранный маркер

Ссылка на карту

URL источника тайлов карты.

Имя переменной:

mapLink

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

mapLink

String

Ссылка на карту

Провайдер поиска по карте

Определяет провайдера поиска по карте для строки поиска. Данной свойство имеет два возможных значения:

  • Nominatim
  • Latitude Longitude

Имя переменной:

mapProvider

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

mapProvider

String

Провайдер поиска по карте

Кнопка центрирования на маркере

Если включено, на маркере, указанном в свойстве Selected Marker, отображается карта с указанием центра кнопки.

Имя переменной:

centerMap

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

centerMap

Boolean

Кнопка центрирования на маркере

Показывать пользовательскую кнопку

Если включено, отображает пользовательскую кнопку в настраиваемым поведением.

Имя переменной:

customButton

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

customButton

Boolean

Показывать пользовательскую кнопку

Прокси

Если включено, все ответы на запросы тайлов будут идти через SberMobile как прокси-сервер.

Имя переменной:

proxy

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

proxy

Boolean

Прокси

Стили маркеров

Определяет стили и опции визуализации маркеров.

Имя переменной:

markersStyles

Записи:

0..не ограничено

Формат записи:

Имя поля

Тип поля

Примечания

id

String

ID. Уникальный ID маркера. Значение данного поля должно соответствовать полю ID свойства Markers.

name

String

Name. Имя предустановленного стиля.

description

String

Description. Описание предустановленного стиля.

selectedMarkerImage

Data Block

Selected Marker Image. Изображение маркера в выбранном состоянии.

defaultMarkerImage

Data Block

Default Marker Image. Изображение маркера в состоянии по умолчанию.

Стили путей

Определяет стили и опции визуализации путей.

Имя переменной:

polylinesStyles

Записи:

0..не ограничено

Формат записи:

Имя поля

Тип поля

Примечания

id

String

ID. Уникальный ID пути. Значение данного поля должно соответствовать полю ID свойства Tracks.

name

String

Name. Имя предустановленного стиля.

description

String

Description. Описание предустановленного стиля.

color

Color

Color. Цвет ломаной линии.

width

Integer

Width. Ширина ломаной линии.

opacity

Double

Opacity. Прозрачность ломаной линии.

stroke

String

Stroke. Штрих ломаной линии.

dashArray

String

Dash Length Array. Рисунок тире и пробелов для рисования пути.

dashOffest

String

Dash Offset. Смещение массива штрихов.

additionalStyles

String

Additional Styles. Дополнительный стиль CSS, который будет применен к ломаной линии.

Стили кругового маркера

Определяет стили и опции визуализации круговых маркеров.

Имя переменной:

circleMarkersStyles

Записи:

0..не ограничено

Формат записи:

Имя поля

Тип поля

Примечания

id

String

ID.  Уникальный ID кругового маркера. Значение данного поля должно соответствовать полю ID свойства Circle Markers.

name

String

Name. Имя предустановленного стиля.

description

String

Description. Описание предустановленного стиля.

color

String

Color. Цвет маркера.

width

Integer

Width. Ширина маркера.

opacity

Double

Opacity. Прозрачность ломаной линии.

fill

Boolean

Fill. Если включено, круговой маркер будет заполнен цветом, указанным в полях Fill Color и Fill Opacity.

fillColor

String

Fill Color. Цвет заливки кругового маркера.

fillOpacity

Double

Fill Opacity. Прозрачность цвета заливки кругового маркера.

stroke

String

Stroke. Штрих маркера.

dashArray

String

Dash Length Array. Рисунок тире и пробелов для рисования контура кругового маркера.

dashOffest

String

Dash Offset. Смещение массива штрихов.

radius

Integer

Radius. Радиус кругового маркера.

additionalStyles

String

Additional Styles. Дополнительный стиль CSS, который будет применен к круговому маркеру.

Стили областей

Определяет стили и опции визуализации областей.

Имя переменной:

areasStyles

Записи:

0..не ограничено

Формат записи:

Имя поля

Тип поля

Примечания

id

String

ID. Уникальный ID области. Значение данного поля должно соответствовать полю id свойства areas.

name

String

Name. Имя предустановленного стиля.

description

String

Description. Описание предустановленного стиля.

color

String

Color. Цвет области.

width

Integer

Width. Ширина ломаной линии.

opacity

Double

Opacity. Прозрачность ломаной линии.

fill

Boolean

Fill. Если включено, область будет заполнена цветом, указанным в полях Fill Color и Fill Opacity.

fillColor

String

Fill Color. Цвет заливки области.

fillOpacity

Double

Fill Opacity. Прозрачность цвета заливки области.

stroke

String

Stroke. Штрих границы области.

dashArray

String

Dash Length Array.  Рисунок тире и пробелов для рисования контура области.

dashOffest

String

Dash Offset. Смещение массива штрихов.

additionalStyles

String

Additional Styles. Дополнительный стиль CSS, который будет применен к области.

Стили круглых областей

Определяет стили и опции визуализации круглый областей.

Имя переменной:

circleAreasStyles

Записи:

0..не ограничено

Формат записи:

Имя поля

Тип поля

Примечания

id

String

ID. Уникальный ID круглой области. Значение данного поля должно соответствовать полю Id свойства Markers.

name

String

Name. Имя предустановленного стиля.

description

String

Description. Описание предустановленного стиля.

color

String

Color.  Цвет круглой области.

weight

Integer

Width. Ширина круглой области.

opacity

Double

Opacity. Прозрачность круглой области.

fill

Boolean

Fill. Если включено, круглая область будет заполнена цветом, указанным в полях Fill Color и Fill Opacity.

fillColor

String

Fill Color.  Цвет заливки круглой области.

fillOpacity

Double

Fill Opacity. Прозрачность цвета заливки круглой области.

stroke

String

Stroke.  Штрих границы круглой области.

dashArray

String

Dash Length Array. Рисунок тире и пробелов для рисования контура круглой области.

dashOffest

String

Dash Offset. Смещение массива штрихов.

additionalStyles

String

Additional Styles. Дополнительный стиль CSS, который будет применен к круглой области.

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

[?]

Нажатие на маркер

Событие возникает, когда пользователь нажимает на маркер.

Имя события:

markerClick

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

id

String

ID события.

value

Data Table

Содержит вложенную таблицу с информацией о нажатом маркере. В таблице несколько полей:

  • Latitude
  • Longitude
  • Name

Поиск по карте

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

Имя события:

mapSearch

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

id

String

ID события.

value

Data Table

Содержит вложенную таблицу с информацией о результате поиска. В таблице несколько полей:

  • Latitude
  • Longitude
  • Address

level

Integer

Уровень события по умолчанию.

Нажатие на пользовательскую кнопку

Событие возникает, когда пользователь нажимает на пользовательскую кнопку на компоненте карты.

Имя события:

customButtonClick

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

id

String

ID события.

value

Data Table

Содержит вложенную таблицу с информацией о результате нажатия на кнопку. В таблице одно поле:

  • Custom Button - содержит имя события, например, customButtonClicked.

level

Integer

Уровень события по умолчанию.