class
ActivityTracker
Extends: ru.dgis.sdk.NativeObject
ActivityTracker(
platformContext: Context,
model: Model,
speedBound: Double = 4.2,
timeThreshold: Duration = Duration.ofMilliseconds(20000)
)
Расширение навигатора, которое отслеживает активность пользователя и выдает сигнал,
когда пользователь перестал пользоваться навигатором и его можно выключить.
Parameters
platformContext
Контекст.
model
Модель навигатора, состояние которого отслеживается.
speedBound
Верхняя граница скорости в м/с, при превышении которой в состоянии Finished навигатора считается,
что навигатор активен, т.е. движение продолжается.
timeThreshold
Время, в течение которого в состоянии Finished навигатора отслеживается скорость
движения ниже пороговой для определения состояния неактивности навигатора.
Если в течение этого времени скорость движения меньше установленного порога или
нет данных о локации и скорости, навигатор считается неактивным.
Properties
val stopChannel
Флаг, активное состояние которого указывает на то, что навигатор необходимо остановить.
Если в состоянии Finished навигация прекращается,
т.е. движение останавливается или его скорость становится ниже порогового значения,
и если такое состояние сохраняется некоторое время, то устанавливается флаг устанавливается в true,
в противном случае он имеет значение false.
val stop
Флаг, активное состояние которого указывает на то, что навигатор необходимо остановить.
Если в состоянии Finished навигация прекращается,
т.е. движение останавливается или его скорость становится ниже порогового значения,
и если такое состояние сохраняется некоторое время, то устанавливается флаг устанавливается в true,
в противном случае он имеет значение false.
AddEventResult
Результат добавления события (объект события или ошибка).
Methods
fun match(event: Function1, error: Function1): T
Parameters
fun toString(): String
Returns
fun hashCode(): Int
Returns
Properties
Address
Адрес в виде набора отдельных компонент.
Address(
drillDown: List<AddressAdmDiv>,
components: List<AddressComponent>,
buildingName: String?,
postCode: String?,
buildingCode: String?,
addressComment: String?
)
Адрес в виде набора отдельных компонент.
Parameters
drillDown
components
buildingName
postCode
buildingCode
addressComment
Properties
val drillDown
Набор объектов административного деления, в которых находится описываемый объект.
val components
Пол ный адрес объекта может содержать несколько отдельных адресных компонент.
val buildingName
Название здания.
val postCode
Почтовый индекс.
val buildingCode
Уникальный почтовый код здания.
val addressComment
Комментарий к адресу.
Пример: "301 офис; 9 этаж"
AddressAdmDiv
Объект административного деления.
Properties
val type
Тип административной единицы. Один из следующих:<ul><li>country — страна</li><li>region — регион (область/край/республика и т.п.)</li><li>district_area — район области</li><li>city — город</li><li>settlement — населённый пункт</li><li>division — округ</li><li>district — район</li><li>living_area — жилмассив, микрорайон</li><li>place — место</li></ul>
val name
AddressComponent
Компонент адреса: улица, номер дома или словесное о писание местоположения.
Methods
fun match(
streetAddress: Function1,
number: Function1,
location: Function1
): T
Parameters
fun toString(): String
Returns
fun hashCode(): Int
Returns
Properties
val isStreetAddress
val asStreetAddress
val isNumber
val asNumber
val isLocation
val asLocation
val value
AddressLocation
Применяется для компонентов, которые тяжело описать конкретным адресом.
AddressLocation(comment: String)
Применяется для компонентов, которые тяжело описать конкретным адресом.
Parameters
comment
Properties
val comment
Словесное описание местоположения строения.
AddressNumber
В некоторых населённых пунктах обозначается только номер дома, без улицы (например, Краснообск).
AddressNumber(number: String)
В некоторых населённых пунктах обозначается только номер дома, без улицы (например, Краснообск).
Parameters
number
Properties
val number
Номер дома, включая дроби и буквенные обозначения. Возможно, имя собственное, если так принято.
AddressStreet
Обычный адрес, есть улица и номер дома.
AddRoadEventButton
Кнопка добавления дорожного события.
AddRoadEventButton(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Кнопка добавления дорожного события.
Parameters
Methods
fun attachToModel(model: AddRoadEventCardModel): Unit
Parameters
AddRoadEventCard
Карточка добавления дорожного события.
AddRoadEventCard(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Карточка добавления дорожного события.
Parameters
Methods
fun attachToModel(model: AddRoadEventCardModel): Unit
Parameters
Properties
const MAX_DESCRIPTION_LENGTH
AddRoadEventCardModel
Модель карточки добавления дорожного события.
Implements: java.lang.AutoCloseable
AddRoadEventCardModel(roadEventManager: RoadEventManager, map: Map)
Модель карточки добавления дорожного события.
Parameters
Methods
fun onEventTypeClicked(type: RoadEventType): Unit
Действие при нажатии контрола выбора типа события.
Parameters
fun onLaneClicked(lane: Lane): Unit
Действие при нажатии контрола выбора полосы.
Parameters
fun onDescriptionEntered(description: String): Unit
Действие при вводе описания.
Parameters
fun close(): Unit
Returns
Properties
val eventTypeChannel
Выбранный тип события.
val lanesChannel
Выбранные полосы.
val canSelectLanesChannel
Есть ли возможность задать полосы.
val descriptionChannel
Введенное описание.
val markerPositionChannel
Позиция маркера на экране.
val canSendChannel
Есть ли возможность отправить событие.
val resultChannel
Результат отправки события.
AddRoadEventControl
Базовый класс для контролов добавления дорожных событий.
Extends: android.widget.FrameLayout
AddRoadEventControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Базовый класс для контролов добавления дорожных событий.
Parameters
Methods
fun attachToModel(model: AddRoadEventCardModel): Unit
Parameters
@CallSuper
fun detachFromModel(): Unit
Returns
fun onAttachedToWindow(): Unit
Returns
fun onDetachedFromWindow(): Unit
Returns
Properties
AddRoadEventControls
Набор контролов для добавления дорожных событий.
Состоит из карточки с параметрами события, кнопки "Отправить" и маркера, указывающего место
добавления события на карте.
Extends: ru.dgis.sdk.map.MapControl
AddRoadEventControls(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Набор контролов для добавления дорожных событий.
Состоит из карточки с параметрами события, кнопки "Отправить" и маркера, указывающего место
добавления события на карте.
Parameters
Methods
fun show(): Unit
Returns
fun hide(): Unit
Returns
Properties
val cardHeightChannel
Высота в пикселях, на которую раскрыта карточка.
AddRoadEventMarker
Маркер добавления д орожного события.
AddRoadEventMarker(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Маркер добавления дорожного события.
Parameters
Methods
fun attachToModel(model: AddRoadEventCardModel): Unit
Parameters
fun detachFromModel(): Unit
Returns
AlternativeRoutesProviderSettings
Extends: ru.dgis.sdk.NativeObject
Properties
var alternativeRoutesEnabled
Флаг включения/выключения предложения альтернативных маршрутов. По умолчанию
предложение альтернативных маршрутов включено.
var betterRouteEnabled
Флаг включения/выключения предложения маршрута лучше. По умолчанию предложение
маршрута лучше включено.
var routeSearchDelay
Задержка перед поиском альтернативных маршрутов при старте поездки по маршруту или после
перехода на какой-либо другой маршрут. Должна быть не меньше 5 секунд. По умолчанию 20 секунд.
var betterRouteTimeCostThreshold
Минимальная разница во времени движения между исходным маршрутом и альтернативным
маршрутом, при которой альтернативный маршрут считается маршрутом лучше.
var betterRouteLengthThreshold
Минимальная суммарная длина рёбер маршрута, которые отличаются между исходным маршрутом
и альтернативным маршрутом, при которой альтернативный маршрут считается маршруто м лучше.
Anchor
Точка привязки изображения
(0, 0) - левый верхний угол, (1, 1) - правый нижний
ApartmentRange
Диапазон квартир.
Properties
val start
Начало диапазона/Хранимое значение.
На текущий момент возможны только числовые значения, а квартиры с суффиксами в данных пока отсутствуют.
val end
Окончание диапазона. Если отсутствует, то диапазон состоит из одного значения start. Иначе это арифметическая
прогрессия от start до end с шагом 1.
Attribute
Дополнительный атрибут.
Пример:
{
tag: "hotel_room_internet",
name: "Бесплатный интернет в номерах"
}
Attributes
Интерфейс для управления свойствами объекта карты.<p>Свойства есть только у объектов карты, но можно задавать свойства по умолчанию для всей карты,
для стиля и для источника (подробнее см. ISource).</p>
Extends: ru.dgis.sdk.NativeObject
Methods
fun setAttributeValue(name: String, value: AttributeValue): Unit
Установка свойства.
Parameters
fun setAttributeValues(values: Map, attributesToRemove: List<String> = listOf()): Unit
Установка набора свойств.
Parameters
values
набор пар "имя":"значение" для добавляемых свойства
attributesToRemove
список имён свойств, которые нужно удалить
Returns
fun removeAttribute(name: String): Unit
Удаление свойства.
Parameters
fun getAttributeValue(name: String): AttributeValue
Получение свойства.
Parameters
Properties
val attributeNames
Получение списка свойств.
val changed
Получение канала, уведомляющего об изменении свойств.
AttributeValue
Свойства объектов карты.
AttributeValue()
Methods
fun match(
empty: Function0<T>,
boolean: Function1,
number: Function1,
integer: Function1,
string: Function1,
data: Function1,
array: Function1,
item: Function1
): T
Parameters
empty
boolean
number
integer
string
data
array
item
Returns
T
fun toString(): String
Returns
fun hashCode(): Int
Returns
Properties
val isEmpty
val isBoolean
val asBoolean
val isNumber
val asNumber
val isInteger
val asInteger
val isString
val asString
val isData
val asData
val isArray
val asArray
val isObject
val asObject
val value
AuthorInfo
Информация об авторе события или фотографии.
AuthorInfo(type: AuthorType, name: String)
Информация об авторе события или фотографии.
Parameters
Properties
val type
Категория автора контента.
val name
Строка, содержащая имя пользователя, добавившего событие или фотографию.<ul><li>Имя пользователя в случае, если автор является авторизированным пользователем
и согласился на отображение своего имени.</li><li>Пустая строка для анонимного пользователя или пользователя, отказавшегося от отображения своего имени.</li></ul>
BaseCamera
Камера.<p>Задаёт параметры проецирования карты на экран.</p>
Extends: ru.dgis.sdk.NativeObject
Methods
Properties
val projection
Проекция.<p>Используется для получения точки экрана по точке карты и точки карты по точке экрана.
Параметры камеры фиксируются в момент вызова.</p>
val positionChannel
Получение текущей позиции камеры.
var position
Получение текущей позиции камеры.
val zoomRestrictionsChannel
Получение актуальных ограничений zoom-уровня.
var zoomRestrictions
Получение актуальных ограничений zoom-уровня.
val deviceDensityChannel
Получение отношения DPI к базовому DPI устройства.
val deviceDensity
Получение отношения DPI к базовому DPI устройства.
val sizeChannel
Получение размера области просмотра.
var size
Получение размера области просмотра.
val paddingChannel
Получение текущих отступов от краёв экрана.
var padding
Получение текущих отступов от краёв экрана.
val positionPointChannel
Точка экрана, к которой привязана позиция камеры, задаётся с учётом отступов (padding).
var positionPoint
Точка экрана, к которой привязана позиция камеры, задаётся с учётом отступов (padding).
val visibleArea
Область пересечения пирамиды видимости камеры и поверхности карты.
val visibleRectChannel
Объемлющий прямоугольник видимой области карты.
val visibleRect
Объемлющий прямоугольник видимой области карты.
val styleZoomToTiltRelationChannel
Получение текущей функции зависимости угла наклона камеры от стилевого zoom-уровня.
var styleZoomToTiltRelation
Получение текущей функции зависимости угла наклона камеры от стилевого zoom-уровня.
val maxTiltRestrictionChannel
Получение текущей функции зависимости максимального угла наклона камеры от стилевого zoom-уровня.
var maxTiltRestriction
Получение текущей функции зависимости максимального угла наклона камеры от стилевого zoom-уровня.
Bearing
Угол между направлением на один объект и на другой объект, либо между направлением на объект и север.
Угол отсчитывается по часовой стрелке. Диапазон значений <a href="#">0°,360°</a>.
Bearing(value: Double = 0.0)
Угол между направлением на один объект и на другой объект, либо между направлением на объект и север.
Угол отсчитывается по часовой стрелке. Диапазон значений <a href="#">0°,360°</a>.
Parameters
value
Properties
val value
BetterRouteInfo
Информация о доступном альтернативном маршруте
BetterRouteInfo(trafficRoute: TrafficRoute, startPoint: RoutePoint)
Информация о доступном альтернативном маршруте
Parameters
Properties
val trafficRoute
Альтернативный маршрут
val startPoint
Точка на альтернативном маршруте, с которой начнётся движение в случае
перехода на этот маршрут
BetterRoutePromptControl
Диалог, предлагающий перейти на ведение по маршруту с меньшим ожидаемым временем прибытия.
BetterRoutePromptControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Диалог, предлагающий перейти на ведение по маршруту с меньшим ожидаемым временем прибытия.
Parameters
Properties
val visibilityChannel
BicycleBriefRouteInfo
Базовая информация о велосипедном маршруте.
BicycleBriefRouteInfo(length: RouteDistance, landmark: String)
Базовая информация о велосипедном маршруте.
Parameters
Properties
BicycleInstructionCrossroad
Описание манёвров при проходе через перекрёсток или по пешеходному переходу.
BicycleInstructionCrossroad(landmark: BicycleInstructionCrossroadLandmark = BicycleInstructionCrossroadLandmark.NONE, maneuvers: List<BicycleInstructionCrossroadManeuver>)
Описание манёвров при проходе через перекрёсток или по пешеходному переходу.
Parameters
Properties
val landmark
Ориентир.
val maneuvers
Цепочка идущих подряд манёвров.
BicycleInstructionCrossroadManeuver
BicycleInstructionCrossroadManeuver(direction: BicycleInstructionCrossroadManeuverDirection = BicycleInstructionCrossroadManeuverDirection.STRAIGHT, turnAngle: Int = 0)
Parameters
Properties
val direction
Направление движения.
val turnAngle
Угол поворота в градусах <a href="#">-180,180</a>.
BicycleInstructionFinish
Конец велосипедной части маршрута.
BicycleInstructionFinish()
Конец велосипедной части маршрута.
BicycleInstructionStart
Начало велосипедной части маршрута.
BicycleInstructionStart()
Начало велосипедной части маршрута.
BicycleRouteSearchOptions
Параметры поиска маршрута на велосипеде.
BicycleRouteSearchOptions(
avoidCarRoads: Boolean = false,
avoidStairways: Boolean = false,
avoidUnderpassesAndOverpasses: Boolean = false,
excludedAreas: List<ExcludedArea> = listOf()
)
Параметры поиска маршрута на велосипеде.
Parameters
avoidCarRoads
avoidStairways
avoidUnderpassesAndOverpasses
excludedAreas
Properties
val avoidCarRoads
Избегать автомобильных дорог.
val avoidStairways
Избегать лестниц.
val avoidUnderpassesAndOverpasses
Избегать подземных и надземных переходов.
val excludedAreas
Исключаемые области (не больше 25).
BoolRouteLongAttribute
Контейнер, который хранит протяженный атрибут маршрута.
Каждый элемент хранится в виде пары, состоящей из точки и значения элемента атрибута.
Действие атрибута начинается с данной точки и заканчивается в следущей точке,
начиная с которой начинается действие атрибута следующего элемента.
Extends: ru.dgis.sdk.NativeObject
Methods
fun entry(point: RoutePoint): BoolRouteLongEntry?
Элемент, в который попадает заданная точка.
Parameters
fun entries(begin: RoutePoint, end: RoutePoint): List<BoolRouteLongEntry>
Элементы, чистично или полностью покрываемые отрезком <a href="#">begin,end</a>.
Parameters
Properties
val size
Количество элементов.
val isEmpty
Элементы отсутсвуют.
val first
Первый элемент.
val last
Последний элемент.
val entries
Все элементы.
BoolRouteLongEntry
Протяженный элемент маршрута - отрезок и значение на нем.
BoolRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: Boolean
)
Протяженный элемент маршрута - отрезок и значение на нем.
Parameters
Properties
BriefExtraRouteInfo
Дополнительная информация о маршруте для конкретного типа транспорта.
BriefExtraRouteInfo(pedestrian: PedestrianBriefRouteInfo)
Parameters
pedestrian
BriefExtraRouteInfo(publicTransport: PublicBriefRouteInfo)
Parameters
publicTransport
Methods
fun match(
bicycle: Function1,
car: Function1,
pedestrian: Function1,
publicTransport: Function1,
scooter: Function1
): T
Parameters
bicycle
car
pedestrian
publicTransport
scooter
Returns
T
fun toString(): String
Returns
fun hashCode(): Int
Returns
Properties
val isBicycle
val asBicycle
val isCar
val asCar
val isPedestrian
val asPedestrian
val isPublicTransport
val asPublicTransport
val isScooter
val asScooter
val value
BriefPublicTransportCard
Краткая карточка, отображающая информацию о маршруте на общественном транспорте.
В отличии от PublicTransportCard не содержит информацию о пересадках.
Extends: android.widget.FrameLayout
BriefPublicTransportCard(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Краткая карточка, отображающая информацию о маршруте на общественном транспорте.
В отличии от PublicTransportCard не содержит информацию о пересадках.
Parameters
Methods
fun onAttachedToWindow(): Unit
Returns
Properties
var model
BriefPublicTransportCardModel
Модель для BriefPublicTransportCard.
BriefPublicTransportCardModel(route: TrafficRoute, context: Context)
Модель для BriefPublicTransportCard.
Parameters
Properties
val title
Заголовок.
Предполагаемое время проезда, например, "1 ч 42 мин."
val transports
И нформация о транспорте.
val description
Описание.
Количество пересадок и время пешком, например, <a href="#">1пересадка,Пешком15мин</a>.
BriefRoadEvent
BriefRoadEvent(
id: Long = 0,
eventType: RoadEventType = RoadEventType.OTHER,
lanes: EnumSet<Lane>
)
Parameters
Properties
BriefRouteInfo
Базовая информация о маршруте.
BriefRouteInfo(duration: Duration, extraInfo: BriefExtraRouteInfo)
Ба зовая информация о маршруте.
Parameters
Properties
val duration
Время движения по маршруту.
val extraInfo
Дополнительная информация о маршруте для конкретного типа транспорта.
BriefRouteInfoSearchPoints
Точки для запроса поиска базовой информации о маршруте.
BriefRouteInfoSearchPoints(startPoint: RouteSearchPoint, finishPoint: RouteSearchPoint)
Точки для запроса поиска базовой информации о маршруте.
Parameters
Properties
val startPoint
Начальная точка маршрута.
val finishPoint
Конечная точка маршрута.
BuildingId
Идентификатор здания.
Properties
val value
BuildingLevels
Информация об этажных планах здания.
BuildingLevels(defaultLevelId: LevelId, levels: List<LevelInfo>)
Информация об этажных планах здания.
Parameters
Properties
val defaultLevelId
Идентификатор этажного плана по умолчанию.
val levels
Все этажные планы здания.
CalloutMapPosition
Положение баблика маршрута.
CalloutMapPosition(
mapId: MapId,
calloutPosition: GeoPoint?,
routePoint: RoutePoint?
)
Положение баблика маршрута.
Parameters
Properties
val mapId
Идентификатор карты, для которой приведена позиция.
val calloutPosition
Позиция на карте.
val routePoint
Позиция бабла полосности на маршруте.
Camera
Камера для запуска перемещения карты и настройки слежения.
Extends: ru.dgis.sdk.map.BaseCamera
Methods
fun move(moveController: CameraMoveController): Future<CameraAnimatedMoveResult>
Запуск перемещения карты.<p>Сбрасывает текущий режим слежения карты и прерывает обработку жестов.</p>
Parameters
moveController
контроллер анимированного перемещения камеры.
Returns
fun move(
position: CameraPosition,
time: Duration = Duration.ofMilliseconds(300),
animationType: CameraAnimationType = CameraAnimationType.DEFAULT
): Future<CameraAnimatedMoveResult>
Запуск анимированного перемещения карты с использованием встроенного контроллера перемещений карты.<p>Сбрасывает текущий режим слежения карты и прерывает обработку же стов.</p>
Parameters
position
конечная позиция камеры
time
время, выделенное на пермещение карты
animationType
тип анимации при перемещении камеры
Returns
fun processMovementAndStop(): Unit
Установка позиции камеры в соответствие с текущим временем и прекращение анимированного перемещения.<p>Вызов прерывает перелёт и обработку жестов, а также сбрасывает режим слежения.</p>
Returns
fun addFollowController(followController: FollowController): Unit
Добавление контроллера слежения.<p>Их может быть несколько разных, например контроллер слежения за масштабом, за углом наклона карты,
за геолокацией и т.д.</p>
Parameters
fun removeFollowController(followController: FollowController): Unit
Удаление контроллера слежения.
Parameters
fun setCustomFollowController(followController: CustomFollowController): Unit
Добавление контроллера слежения реализованного на платформе.<p>Можно установить только один такой контроллер. Если установить несколько контроллеров, то будет использоваться
только последний установленный.</p>
Parameters
fun removeCustomFollowController(): Unit
Удаление контроллера слежения реализованного на платформе.
Returns
Properties
val stateChannel
Получение актуального состояния камеры.
val state
Получение актуального состояния камеры.
val behaviourChannel
Режим слежения камеры.
val behaviour
Режим слежения камеры.
CameraBehaviour
Режим слежения камеры.<p>Режимы камеры деградируются по следующим правилам:</p><ul><li>смещение карты сбрасывает в None
события: DirectMapShiftEvent, MapShiftBeginEvent, DirectMapRotationEvent с указанием центра события,
DirectMapScalingEvent с указанием центра события, ScaleMapEvent с указанием центра события</li><li>поворот карты относительно точки позиции отбрасывает Bearing
события: MapRotationBeginEvent, RotateMapToNorthEvent, DirectMapRotationEvent без центра события</li><li>изменение масштаба относительно точки позиции отбрасывает StyleZoom
события: MapScalingBeginEvent, DirectMapScalingEvent без центра события, ScaleMapEvent без центра события</li><li>наклон отбрасывает Tilt
события: DirectMapTiltEvent</li></ul>
CameraBehaviour(position: FollowPosition?, transitionType: TransitionType = TransitionType.SMOOTH)
Режим слежения камеры.<p>Режимы камеры деградируются по следующим правилам:</p><ul><li>смещение карты сбрасывает в None
события: DirectMapShiftEvent, MapShiftBeginEvent, DirectMapRotationEvent с указанием центра события,
DirectMapScalingEvent с указанием центра события, ScaleMapEvent с указанием центра события</li><li>поворот карты относительно точки позиции отбрасывает Bearing
события: MapRotationBeginEvent, RotateMapToNorthEvent, DirectMapRotationEvent без центра события</li><li>изменение масштаба относительно точки позиции отбрасывает StyleZoom
события: MapScalingBeginEvent, DirectMapScalingEvent без центра события, ScaleMapEvent без центра события</li><li>наклон отбрасывает Tilt
события: DirectMapTiltEvent</li></ul>
Parameters
Properties
CameraBehaviourChange
Изменение режима слежения.
CameraBehaviourChange(newBehaviour: CameraBehaviour, changeReason: CameraBehaviourChangeReason)
Изменение режима слежения.
Parameters
Properties
val newBehaviour
Новый режим слежения.
val changeReason
Причина изменения режима слежения.
CameraNotifier
Предупреждает о попадании в зону действия дорожной камеры.
Extends: ru.dgis.sdk.NativeObject
CameraNotifier(model: Model)
Расширение навигатора, которое предупреждает о попадании в зону действия дорожной камеры.
Parameters
model
Модель навигатора, состояние которого отслеживается.
Properties
val cameraProgressChannel
Прогресс прохождения зоны действия дорожной камеры.
val cameraProgress
Прогресс прохождения зоны действия дорожной камеры.
CameraPosition
Позиция камеры.
Properties
val point
Точка местности, которая находится в точке позиции камеры (см. ICamera::position_point()).
val zoom
Zoom-уровень.
0 - это весь мир, вписанный в квадрат 256x256 логических пикселей (см. LogicalPixel)
val tilt
Угол наклона направления взгляда по вертикали.<p>0 - надир (смотрим вертикально вниз), максимальное значение - 60 градусов.</p>
val bearing
Угол поворота направления взгляда по горизонтали относительно направления на север.
Отсчитывается по часовой стрелке, в градусах.
CameraPositionPoint
Относительная экранная позиция точки, к которой привязана камера.<p>Область экрана задаётся padding'ами.
x - отступ от левого края области экрана, y - отступ от верхнего края
Допустимый и нтервал значений отступов (0.0f, 1.0f)
0,0 - левый верхний угол области экрана, 1,1 - правый нижний</p>
CameraPositionPoint(x: Float = 0.5f, y: Float = 0.5f)
Относительная экранная позиция точки, к которой привязана камера.<p>Область экрана задаётся padding'ами.
x - отступ от левого края области экрана, y - отступ от верхнего края
Допустимый интервал значений отступов (0.0f, 1.0f)
0,0 - левый верхний угол области экрана, 1,1 - правый нижний</p>
Parameters
CameraProgressInfo
Информация о прогрессе прохождения зоны камеры.
CameraProgressInfo(
camera: RouteCamera,
position: RoutePoint,
progress: Float = 0.0f
)
Информация о прогрессе прохождения зоны камеры.
Parameters
Properties
val camera
Камера, для зоны действия которой отслеживается прогресс.
val position
Позиция камеры на маршруте.
val progress
Прогресс прохождения зоны действия камеры, <a href="#">0,1</a>.
CameraRouteAttribute
Контейнер, который описывает точечный атрибут маршрута.
Каждый элемент хранится в виде точки на маршруте, в которой этот элемент расположен и значения самого элемента.
Extends: ru.dgis.sdk.NativeObject
Methods
fun entries(begin: RoutePoint, end: RoutePoint): List<CameraRouteEntry>
Элементы, попадающие в отрезок [begin, end).
Parameters
fun findNearBackward(point: RoutePoint): CameraRouteEntry?
Найти ближайший элемент, позиция которого
<
= point.<p>Сложность операции log2(N), где N = size.</p>
Parameters
fun findNearForward(point: RoutePoint): CameraRouteEntry?
Найти ближайший элемент, позиция которого >= point.<p>Сложность операции log2(N), где N = size.</p>
Parameters
Properties
val size
Количество элементов.
val isEmpty
Элементы отсутсвуют.
val first
Первый элемент.
val last
Последний элемент.
val entries
Все элементы.
CameraRouteEntry
Элемент маршрута - точка и знач ение в ней.
CameraRouteEntry(point: RoutePoint, value: RouteCamera)
Элемент маршрута - точка и значение в ней.
Parameters
Properties
CameraZoomRestrictions
Допустимый диапазон изменения zoom-уровня.
CancelEvent
Событие отмены текущего действия.<p>Вызывается, например, при отмене жеста, потере фокуса окна или при потере захвата мыши.
Также может быть вызван изнутри карты при смене ограничений zoom-уровня, некоторых изменениях режима слежения
и установке интерактивного режима карты.</p>
Extends: ru.dgis.sdk.map.Event
CancelEvent()
CarBriefRouteInfo
Базовая информация об автомобильном маршруте.
CarBriefRouteInfo(
length: RouteDistance,
landmark: String,
trafficSpeed: CarBriefRouteInfoTrafficSpeed
)
Базовая информация об автомобильном маршруте.
Parameters
Properties
val length
Длина маршрута.
val landmark
Ориентир.
val trafficSpeed
Скорость движения.
CarInstructionCrossroad
Описание манёвров на перекрёстке.
CarInstructionCrossroad(
direction: CarInstructionCrossroadDirection = CarInstructionCrossroadDirection.STRAIGHT,
turnAngle: Int = 0,
landmark: CarInstructionCrossroadLandmark = CarInstructionCrossroadLandmark.NONE,
exitName: String
)
Описание манёвров на перекрёстке.
Parameters
direction
turnAngle
landmark
exitName
Properties
val direction
Направление движения на перекрёстке.
val turnAngle
Угол поворота в градусах <a href="#">-180,180</a>.
val landmark
Ориентир.
val exitName
Название съезда.
CarInstructionFinish
Конец автомобильной части маршрута.
CarInstructionFinish()
Конец автомобильной части маршрута.
CarInstructionRoundabout
Описание маневров на перекрёстке с круговым движением.
CarInstructionRoundabout(
type: CarInstructionRoundaboutType = CarInstructionRoundaboutType.ENTRY,
turnAngle: Int = 0,
exitNumber: Int = 0,
exitName: String
)
Описание маневров на перекрёстке с круговым движением.
Parameters
Properties
val type
Тип инструкции.
val turnAngle
Угол поворота в градусах <a href="#">-180,180</a>.
val exitNumber
Номер съезда - <a href="#">1,inf</a> или 0, если номер съезда неизвестен.
val exitName
Название съезда.
CarInstructionStart
Начало автомобильной части маршрута.
CarInstructionStart()
Начало автомобильной части маршрута.
CarInstructionUTurn
Разворот на дороге (не на перекрёстке).<p>Разворот на перекрестке описывается инструкцией Crossroad.</p>
CarInstructionUTurn(exitName: String)
Разворот на дороге (не на перекрёстке).<p>Разворот на перекрестке описывается инструкцией Crossroad.</p>
Parameters
exitName
Properties
val exitName
Название съезда.
CarRouteSearchOptions
Параметры поиска маршрута на легковом автомобиле.
CarRouteSearchOptions(
avoidTollRoads: Boolean = false,
avoidUnpavedRoads: Boolean = false,
avoidFerries: Boolean = false,
avoidLockedRoads: Boolean = true,
routeSearchType: RouteSearchType = RouteSearchType.JAM,
excludedAreas: List<ExcludedArea> = listOf()
)
Параметры поиска маршрута на легковом автомобиле.
Parameters
avoidTollRoads
avoidUnpavedRoads
avoidFerries
avoidLockedRoads
routeSearchType
excludedAreas
Properties
val avoidTollRoads
Избегать платных дорог.
val avoidUnpavedRoads
Избегать грунтовых дорог.
val avoidFerries
Избегать паромных переправ.
val avoidLockedRoads
Избегать закрытых для проезда дорог.
При значении true поиск маршрута не будет учитывать перекрытые для проезда участки дорог.
При значении false маршрут может быть проложен через перекрытые для проезда участки дорог, если невозможно
построить маршрут без проезда через перекрытые участки.
val routeSearchType
Тип поиска маршрута.
val excludedAreas
Исключаемые области (не больше 25).
Certificate
SSL-сертификат.
Methods
fun match(
system: Function1,
fromFile: Function1,
fromAsset: Function1
): T
Parameters
system
fromFile
fromAsset
Returns
T
fun toString(): String
Returns
fun hashCode(): Int
Returns
Properties
val isSystem
val asSystem
val isFromFile
val asFromFile
val isFromAsset
val asFromAsset
val value
val default
Сертификаты, используемые по умолчанию.
Системные + российские, поставляемые вместе с SDK.
CertificateFromAsset
SSL-сертификат из Android asset-а.
Properties
val path
Путь относительно корневой директории asset-ов.
CertificateFromFile
SSL-сертификат из файла.
Properties
val path
Путь к файлу.
Circle
Окружность.
Extends: ru.dgis.sdk.map.SimpleMapObject
Properties
var position
Местоположение центра окружности.
var radius
Радиус окружности.
var color
Цвет заливки окружности.
var strokeWidth
Ширина линии границы окружности.
var strokeColor
Цвет границы окружности.
CircleOptions
Параметры для создания г еометрического объекта карты типа "Окружность".
CircleOptions(
position: GeoPoint,
radius: Meter,
color: Color = Color(),
strokeWidth: LogicalPixel = LogicalPixel(value = 0.0f),
strokeColor: Color = Color(),
visible: Boolean = true,
userData: Any? = null,
zIndex: ZIndex = ZIndex(value = 0),
levelId: LevelId? = null
)
Параметры для создания геометрического объекта карты типа "Окружность".
Parameters
Properties
val position
Географическая позиция.
val radius
Радиус в метрах.
val color
Цвет заливки.
val strokeWidth
Ширина линии границы окружности.
val strokeColor
Цвет линии границы окружности.
val visible
Флаг видимости.
val userData
Пользовательские данные (не используются внутри SDK, нужны только для пользователя API).
val zIndex
Уровень отрисовки объекта.
val levelId
Привязка к поэтажному плану здания.
ClusterObject
Кластер объектов.
Extends: ru.dgis.sdk.map.MapObject
Properties
val position
Получение позиции кластера на карте.
val objectCount
Получение количества маркеров в кластере.
val objects
Получение списка маркеров в кластере.
val geometryObject
Получение геометрического объекта кла стера.
ClusterOptions
Параметры маркера кластера.
Color
Цвет
CompassControl
Контрол компаса.
Extends: ru.dgis.sdk.map.MapControl
CompassControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0,
layout: Int = R.layout.dgis_compass_control
)
Контрол компаса.
Parameters
CompassControl
Extends: ru.dgis.sdk.map.CompassControl
CompassControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Parameters
CompassControlModel
Модель контрола компаса.
Контрол состоит из кнопки компаса, при нажатии на которую
камера карты меняет угол в направлении севера.
Если камера карты смотрит на сервер, то контрол необходимо скрывать.
Потокобезопасно.
Extends: ru.dgis.sdk.NativeObject
Methods
fun onClicked(): Unit
Returns
Properties
ComplexGeometry
Составная геометрия, состоит из набора простых или составных геометрий.<p>Поддерживается произвольный уровень вложенности составных геометрий в наборе.</p>
Extends: ru.dgis.sdk.geometry.Geometry
Properties
val elements
ContactInfo
Способ связаться с организацией.
Properties
val type
Тип контакта. Один из следующих:<ul><li>email — электронная почта</li><li>website — сайт</li><li>phone — телефон</li><li>fax — факс</li><li>pobox — абонентский ящик</li><li>icq</li><li>jabber</li><li>skype</li><li>vkontakte</li><li>twitter</li><li>odnoklassniki</li><li>youtube</li><li>linkedin</li><li>googleplus</li><li>pinterest</li><li>whatsapp</li><li>viber</li><li>telegram</li></ul>
val displayText
Значение контакта для вывода на экран.
val value
Техническое значение контакта. В зависимости от типа контакта имеет следующую семантику:<ul><li>email — адрес почты</li><li>website — полный url</li><li>phone — номер телефона в международном формате, например: "+73831234567"</li><li>fax — номер телефона в международном формате, например: "+73831234567"</li><li>pobox — адрес почтового ящика</li><li>icq — идентификатор пользователя</li><li>jabber — идентификатор пользователя</li><li>skype — идентификатор пользователя</li><li>vkontakte — полный url</li><li>twitter — полный url</li><li>odnoklassniki — полный url</li><li>youtube — полный url</li><li>linkedin — полный url</li><li>googleplus — полный url</li><li>pinterest — полный url</li><li>whatsapp — полный url</li><li>viber — полный url</li><li>telegram — полный url</li></ul>
val comment
Уточняющая информация о контакте.
Context
Контекст - окружение, необходимое для работы SDK.
Extends: ru.dgis.sdk.NativeObject
DashboardControl
DashboardControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Parameters
Methods
fun onAttachedToWindow(): Unit
Returns
fun toggleExpandedState(): Unit
Returns
Properties
val remainingRouteInfoControl
var onFinishClicked
var onShowRouteClicked
var isFreeRoam
val headerHeight
DashedPolylineOptions
Параметры пунктирной полилинии
DashedPolylineOptions(dashLength: LogicalPixel = LogicalPixel(value = 5.0f), dashSpaceLength: LogicalPixel = LogicalPixel(value = 2.0f))
Параметры пунктирной полилинии
Parameters
Properties
val dashLength
Длина пунктира
val dashSpaceLength
Длина межпунктирного расстояния
DayTime
Временной момент внутри дня.
DefaultLocationSource
Реализация источника геопозиции, которую рекомендуется использовать по умолчанию.
При наличии GMS использует их, иначе - LocationManager.
Implements: ru.dgis.sdk.positioning.LocationSource
DefaultLocationSource(context: Context)
Реализация источника геопозиции, которую рекомендуется использовать по умолчанию.
При наличии GMS использует их, иначе - LocationManager.
Parameters
context
Methods
@Synchronized
fun activate(listener: LocationChangeListener): Unit
Parameters
@Synchronized
fun deactivate(): Unit
Returns
@Synchronized
fun setDesiredAccuracy(accuracy: DesiredAccuracy): Unit
Parameters
fun onPermissionGranted(): Unit
Метод необходимо вызвать после получения разрешений на использование геопозиции.
Returns
@Synchronized
fun onProvidersChanged(): Unit
Returns
Properties
val lastLocation
Наилучшая известная на текущий момент геопозиция.
Если известная на текущий момент геопозиция отсутствует, возвращается null.
Возвращаемая геопозиция может быть недостоверной, например являться устаревшей и/или
не соответствовать требуемой точности
var isGMSAllowed
Использовать ли GMS.
DefaultNavigationControls
UI контролы навигатора, предлагаемые к использованию по умолчанию: полосность, ограничение скорости,
обозначение следующего манёвра и т.д. Пользователи SDK также могут создать свои собственные UI контролы
и использовать UI модель навигатора для получения оповещений о событиях при ведении по маршруту.
DefaultNavigationControls(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
UI контролы навигатора, предлагаемые к использованию по умолчанию: полосность, ограничение скорости,
обозначение следующего манёвра и т.д. Пользователи SDK также могут создать свои собственные UI контролы
и использовать UI модель навигатора для получения оповещений о событиях при ведении по маршруту.
Parameters
Methods
fun onConfigurationChanged(newConfig: Configuration): Unit
Parameters
fun onAttachedToWindow(): Unit
Returns
Properties
var onFinishClicked
var isFreeRoamDefault
Состояние контрола навигатора по умолчанию.
Нужно для установки корректного начального состояния контролов.
Данное свойство допускает возможность задания только до момента отображения контрола.
DeviceDensity
Множитель, который вычисляется как отношение DPI к базовому DPI устройства.<p>В Android соответствует resources.displayMetrics.density
В iOS соответствует nativeScale</p><p>должен быть положительным.</p>
DeviceDensity(value: Float = 0.0f)
Множитель, который вычисляется как отношение DPI к базовому DPI устройства.<p>В Android соответствует resources.displayMetrics.density
В iOS соответствует nativeScale</p><p>должен быть положительным.</p>
Parameters
value
Properties
val value
DevicePpi
Разрешающая способность дисплея устройства, в пикселях на дюйм.<p>должна быть положительной.</p>
DevicePpi(value: Float = 0.0f)
Разрешающая способность дисплея устройства, в пикселях на дюйм.<p>должна быть положительной.</p>
Parameters
value
Properties
val value
DGis
Точка входа в 2GIS SDK. На старте работы необходимо вызвать initialize
Methods
@JvmStatic
@JvmOverloads
fun initialize(
appContext: Context,
httpOptions: HttpOptions = HttpOptions(),
logOptions: LogOptions = LogOptions(LogLevel.WARNING),
vendorConfig: VendorConfig = VendorConfig(),
keySource: KeySource = KeySource(KeyFromAsset("dgissdk.key")),
dataCollectConsent: PersonalDataCollectionConsent = PersonalDataCollectionConsent.GRANTED
): Context
Необходимо вызвать этот метод до начала работы с SDK
Parameters
appContext
контекст android приложения
httpOptions
logOptions
vendorConfig
keySource
dataCollectConsent
согласие на сбор данных и обработку данных
Returns
ContextsdkContext необходимый д ля работы сервисов SDK
@JvmStatic
fun context(): Context
Returns
DgisMapObject
Объект карты 2GIS.<p>информацию об объекте можно получить через справочник (directory)</p>
Extends: ru.dgis.sdk.map.MapObject
Properties
val id
Стабильный числовой идентификатор объекта.
DgisObjectId
DgisSource
Основной интерфейс источников данных 2GIS
Extends: ru.dgis.sdk.map.Source
Methods
fun setHighlighted(directoryObjectIds: List<DgisObjectId>, highlighted: Boolean): Unit
Установка или снятие выделения объектов.<p>добавляет объекту атрибут "selected", который можно использовать в стилях.</p>
Parameters
directoryObjectIds
идентификаторы изменяемых объектов.
highlighted
установка или снятие выделения.
Returns
@JvmStatic
fun createDgisSource(context: Context, workingMode: DgisSourceWorkingMode = DgisSourceWorkingMode.ONLINE): Source
Создание источника, получающего данные с серверов 2ГИС
или использующего в работе предварительно загруженные данн ые.
Parameters
Properties
val highlightedObjectsChannel
Получение списка идентификаторов выделенных объектов.
val highlightedObjects
Получение списка идентификаторов выделенных объектов.
DirectMapControlBeginEvent
Событие начала прямого управления картой.
Сообщает карте, что необходимо обрабатывать события прямого управления картой.
События прямого управления работают только от DirectMapControlBeginEvent до DirectMapControlEndEvent.
После завершения последовательности событий прямого управления может запуститься кинематика.
Кинематика использует время возникновения события, поэтому лучше использовать время, полученное от системы,
а не заполнять значение при обработке.
Пока кинематика работает только для перемещения карты, но не для вращения и масштабирования.
Extends: ru.dgis.sdk.map.Event
DirectMapControlBeginEvent()
DirectMapControlEndEvent
Событие окончания прямого управления картой.
Завершает прямое управление картой, начатое после получения события DirectMapControlBeginEvent.
О событиях прямого управления картой описано в DirectMapControlBeginEvent.
Extends: ru.dgis.sdk.map.InputEvent
DirectMapRotationEvent
Событие прямого вращения карты. О событиях прямого управления картой описано в DirectMapControlBeginEvent.
Extends: ru.dgis.sdk.map.InputEvent
DirectMapRotationEvent(
bearingDelta: Bearing,
timestamp: Duration,
rotationCenter: ScreenPoint? = null
)
Parameters
bearingDelta
изменение угла поворота карты, в градусах.
Положительные значения соответствуют направлению вращения против часовой стрелки
timestamp
время генерации системного события.
rotationCenter
точка на экране, вокруг которой вращается карта. Если точка не задана,
то вращение происходит относительно точки позиции карты.
Properties
val bearingDelta
Изменение угла поворота карты.
val rotationCenter
Точка на экране, вокруг которой вращается карта.
DirectMapScalingEvent
Событие прямого масштабирования карты. О событиях прямого управления картой описано в DirectMapControlBeginEvent.
Extends: ru.dgis.sdk.map.InputEvent
DirectMapScalingEvent(
zoomDelta: Float,
timestamp: Duration,
scalingCenter: ScreenPoint? = null
)
Parameters
zoomDelta
величина, на которую изменится текущее значение масштаба.
timestamp
время генерации системного события.
scalingCenter
точка на экране, относительно которой масштабируется карта. Если точка не задана,
то масштабирование происходит относительно точки позиции карты.
Properties
val zoomDelta
Величина, на которую изменится текущее значение масштаба.
val scalingCenter
Точка на экране, относительно которой масштабируется карта.
DirectMapShiftEvent
Событие прямого сдвига карты. О событиях прямого управления картой описано в DirectMapControlBeginEvent.
Extends: ru.dgis.sdk.map.InputEvent
DirectMapShiftEvent(
screenShift: ScreenShift,
shiftedPoint: ScreenPoint,
timestamp: Duration
)
Parameters
screenShift
изменение экранной позиции карты относительно предыдущей, в пикселях.
shiftedPoint
центральная точка, от которой производится смещение карты.
timestamp
время генерации системного события.
Properties
val screenShift
Изменение экранной позиции карты.
val shiftedPoint
Центральная точка, от которой производится смещение карты.
DirectMapTiltEvent
Событие прямого наклона камеры. О событиях прямого управления картой описано в DirectMapControlBeginEvent.
Extends: ru.dgis.sdk.map.InputEvent
Properties
val delta
Изменение угла накл она в градусах.
DirectoryFilter
Фильтры для справочника.
DirectoryFilter(workTime: WorkTimeFilter?, dynamic: List<DynamicFilter>)
Фильтры для справочника.
Parameters
Properties
val workTime
Фильтр по времени работы.
val dynamic
Динамические фильтры.
DirectoryObject
Объект справочника.
Extends: ru.dgis.sdk.NativeObject
Methods
fun formattedAddress(type: FormattingType): FormattedAddress?
Отформатированное в соответствии с указанным требованием к длине строковое представление адреса.
Parameters
Properties
val types
Тип объекта.
Может быть несколько, например, ТЦ Сан Сити - филиал организации и здание одновременно.
Первый тип в этом списке - основной.
val title
Заголовок объекта.
val titleAddition
Дополнительная информация заголовка
Пример: "(кв. 1-12)"
val subtitle
Подзаголовок объекта.<p>при отсутствии может быть пустой строкой</p>
val id
Стабильный числовой идентификатор объекта.
val markerPosition
Точка объекта, где следует разместить маркер.
val address
Адрес объекта в виде набора компонент.
val attributes
Доп. атрибуты объекта.
val contextAttributes
Контекстные доп. атрибуты объекта.
val timeZoneOffset
Сдвиг локального времени объекта относительно UTC в секундах в текущий момент.
val openingHours
Время работы объекта.
val contactInfos
Контакты объекта.
val reviews
Отзывы.
val parkingInfo
Дополнительная инф ормация о парковке.
val workStatus
Статус работы.
val levelId
Идентификатор этажа, на котором расположен объект.
val buildingLevels
Информация об этажных планах здания.
val entrances
Информация о входах.
val tradeLicense
Данные о лицензии организации.
DoubleRouteAttribute
Контейнер, который описывает точечный атрибут маршрута.
Каждый элемент хранится в виде точки на маршруте, в которой этот элемент расположен и значения самого элемента.
Extends: ru.dgis.sdk.NativeObject
Methods
fun entries(begin: RoutePoint, end: RoutePoint): List<DoubleRouteEntry>
Элементы, попадающие в отрезок [begin, end).
Parameters
fun findNearBackward(point: RoutePoint): DoubleRouteEntry?
Найти ближайший элемент, позиция которого
<
= point.<p>Сложность операции log2(N), где N = size.</p>
Parameters
fun findNearForward(point: RoutePoint): DoubleRouteEntry?
Найти ближайший элемент, позиция которого >= point.<p>Сложность операции log2(N), где N = size.</p>
Parameters
Properties
val size
Количество элементов.
val isEmpty
Элементы отсутсвуют.
val first
Первый элемент.
val last
Последний элемент.
val entries
Все элементы.
DoubleRouteEntry
Элемент маршрута - точка и значение в ней.
DoubleRouteEntry(point: RoutePoint, value: Double)
Элемент маршрута - точка и значение в ней.
Parameters
Properties
DragBeginData
Данные о начале перетаскивания: точка старта перемещения и перемещаемый объект.
DragBeginData(point: ScreenPoint, item: RenderedObject)
Данные о начале перетаскивания: точка старта перемещения и перемещаемый объект.
Parameters
Properties
Duration
Класс, представляющий период времени.
Implements: kotlin.Comparable
Methods
operator fun unaryMinus(): Duration
Returns
fun toString(): String
Returns
DynamicFilter
Динамические фильтры поисковой выдачи.
Methods
fun match(flagFilter: Function1, rangeFilter: Function1): T
Parameters
fun toString(): String
Returns
fun hashCode(): Int
Returns
Properties
val isFlagFilter
val asFlagFilter
val isRangeFilter
val asRangeFilter
val value
DynamicRouteInfo
DynamicRouteInfo(roadEvents: RoadEventRouteAttribute, traffic: Traffic)
Parameters
Properties
DynamicRouteInfoSettings
Настройки получения динамических данных о маршруте.
Extends: ru.dgis.sdk.NativeObject
Properties
var updatePeriod
Периодичность, с которой должны обновляться динамические данные о маршруте.
Elevation
Неотрицательная высота точки над поверхностью в метрах.
Elevation(value: Float = 0.0f)
Неотрицательная высота точки над поверхностью в метрах.
Parameters
value
Properties
val value
EmptyFollowController
Базовый класс для пользовательских контроллеров. Можно использовать как основу для реализации контроллера на платформе.
Implements: ru.dgis.sdk.map.CustomFollowController
EmptyFollowController()
Базовый класс для пользовательских контроллеров. Можно использовать как основу для реализации контроллера на платформе.
Methods
fun availableValues(): EnumSet<FollowValue>
Набор видов значений, которыми умеет управлять данный контроллер.
Returns
fun requestValues(values: EnumSet<FollowValue>): Unit
С помощью этого метода в контроллер сообщается, какие из
предоставляемых им значений используются. Это позволяет освободить
ресурсы, связанные с вычислением неиспользуемых значений. Метод может
вызываться многократно с разными значениями, в этом случае актуальным
является последнее из них.
Parameters
fun setNewValuesNotifier(notifier: NewValuesNotifier?): Unit
Установка нотифаера, который оповещает о новых значениях.
Нотифаер нужно сохранить в реализуемом контроллере
Parameters
EntranceGeometry
Геометрии для отображения входа на карте.
EntranceGeometry(entrancePoints: List<GeoPoint>, entrancePolylines: List<List<GeoPoint>>)
Геометрии для отображения входа на карте.
Parameters
Properties
val entrancePoints
Местоположение входа
val entrancePolylines
Геометрии стрелок, указывающих на вход
EntranceInfo
Информация о входе в здание.
EntranceInfo(
id: DgisObjectId,
buildingNumber: String?,
porchName: String?,
porchNumber: String?,
apartmentRanges: List<ApartmentRange>,
geometry: EntranceGeometry?
)
Информация о входе в здание.
Parameters
id
buildingNumber
porchName
porchNumber
apartmentRanges
geometry
Properties
val id
Идентификатор объекта входа.
val buildingNumber
Номер дома, к которому относится вход.
val porchName
Непустое имя подъезда. Заполняется только для подъездов.
Может принимать значения имени подъезда (например "Подъезд 1") или
номера здания, если подъезд имеет собственный адрес.
val porchNumber
Непустой номер подъезда. Заполняется только для подъездов.
Может принимать значения номера подъезда (например "1") или
номера здания, если подъезд имеет собственный адрес.
val apartmentRanges
Номера квартир, относящихся к подъезду.
val geometry
Геометрии для отображения входа на карте.
Event
Базовый класс для всех обрабатываемых событий
Extends: ru.dgis.sdk.NativeObject
EventsProcessingSettings
EventsProcessingSettings(rotationCenter: RotationCenter, scalingCenter: ScalingCenter)
Parameters
Properties
val rotationCenter
Точка, относительно которой производится вращение карты.
val scalingCenter
Точка, относительно которой производится масштабирование карты.
ExceedSpeedLimitSettings
Настройки детектирования превышения максимальной разрешённой скорости.
Extends: ru.dgis.sdk.NativeObject
ExcludedArea
Исключаемая область, которую следует избегать при построении маршрута.
ExcludedArea(
type: ExcludedAreaType = ExcludedAreaType.POINT,
severity: ExcludedAreaSeverity = ExcludedAreaSeverity.SOFT,
extent: RouteDistance,
points: List<GeoPoint>
)
Исключаемая область, которую следует избегать при построении маршрута.
Parameters
Properties
val type
Тип исключаемой области.
val severity
Приоритет исключения области.
val extent
Размер исключаемой области (не больше 25 км).
val points
Координаты точек исключаемой области (не больше 500).
ExtraInstructionInfo
ExtraInstructionInfo(bicycleStart: BicycleInstructionStart)
Parameters
bicycleStart
ExtraInstructionInfo(bicycleFinish: BicycleInstructionFinish)
Parameters
bicycleFinish
ExtraInstructionInfo(bicycleCrossroad: BicycleInstructionCrossroad)
Parameters
bicycleCrossroad
ExtraInstructionInfo(carCrossroad: CarInstructionCrossroad)
Parameters
carCrossroad
ExtraInstructionInfo(carRoundabout: CarInstructionRoundabout)
Parameters
carRoundabout
ExtraInstructionInfo(pedestrianStart: PedestrianInstructionStart)
Parameters
pedestrianStart
ExtraInstructionInfo(pedestrianFinish: PedestrianInstructionFinish)
Parameters
pedestrianFinish
ExtraInstructionInfo(pedestrianCrossroad: PedestrianInstructionCrossroad)
Parameters
pedestrianCrossroad
ExtraInstructionInfo(pedestrianIndoorFloorChange: PedestrianInstructionIndoorFloorChange)
Parameters
pedestrianIndoorFloorChange
ExtraInstructionInfo(pedestrianIndoorEnter: PedestrianInstructionIndoorEnter)
Parameters
pedestrianIndoorEnter
ExtraInstructionInfo(pedestrianIndoorExit: PedestrianInstructionIndoorExit)
Parameters
pedestrianIndoorExit
ExtraInstructionInfo(scooterStart: ScooterInstructionStart)
Parameters
scooterStart
ExtraInstructionInfo(scooterFinish: ScooterInstructionFinish)
Parameters
scooterFinish
ExtraInstructionInfo(scooterCrossroad: ScooterInstructionCrossroad)
Parameters
scooterCrossroad
Methods
fun match(
bicycleStart: Function1,
bicycleFinish: Function1,
bicycleCrossroad: Function1,
carStart: Function1,
carFinish: Function1,
carCrossroad: Function1,
carRoundabout: Function1,
carUturn: Function1,
pedestrianStart: Function1,
pedestrianFinish: Function1,
pedestrianCrossroad: Function1,
pedestrianIndoorFloorChange: Function1,
pedestrianIndoorEnter: Function1,
pedestrianIndoorExit: Function1,
scooterStart: Function1,
scooterFinish: Function1,
scooterCrossroad: Function1
): T
Parameters
bicycleStart
bicycleFinish
bicycleCrossroad
carStart
carFinish
carCrossroad
carRoundabout
carUturn
pedestrianStart
pedestrianFinish
pedestrianCrossroad
pedestrianIndoorFloorChange
pedestrianIndoorEnter
pedestrianIndoorExit
scooterStart
scooterFinish
scooterCrossroad
Returns
T
fun toString(): String
Returns
fun hashCode(): Int
Returns
Properties
val isBicycleStart
val asBicycleStart
val isBicycleFinish
val asBicycleFinish
val isBicycleCrossroad
val asBicycleCrossroad
val isCarStart
val asCarStart
val isCarFinish
val asCarFinish
val isCarCrossroad
val asCarCrossroad
val isCarRoundabout
val asCarRoundabout
val isCarUturn
val asCarUturn
val isPedestrianStart
val asPedestrianStart
val isPedestrianFinish
val asPedestrianFinish
val isPedestrianCrossroad
val asPedestrianCrossroad
val isPedestrianIndoorFloorChange
val asPedestrianIndoorFloorChange
val isPedestrianIndoorEnter
val asPedestrianIndoorEnter
val isPedestrianIndoorExit
val asPedestrianIndoorExit
val isScooterStart
val asScooterStart
val isScooterFinish
val asScooterFinish
val isScooterCrossroad
val asScooterCrossroad
val value
File
Идентификатор файла.<p>Может являться не только файлом на файловой системе, но и произвольным источником данных.</p>
Extends: ru.dgis.sdk.NativeObject
Methods
@JvmStatic
fun fromString(contents: String): File
Файл с содержимым из заданной строки.
Parameters
FinishRouteControl
Extends: ru.dgis.sdk.map.MapControl
FinishRouteControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Parameters
Methods
fun onAttachedToWindow(): Unit
Returns
fun expand(): Unit
Returns
Properties
FlagFilter
Фильтр - флаг.
FloatRouteLongAttribute
Контейнер, который хранит протяженный атрибут маршрута.
Каждый элемент хранится в виде пары, состоящей из точки и значения элемента атрибута.
Действие атрибута начинается с данной точки и заканчивается в следущей точке,
начиная с которой начинается действие атрибута следующего элемента.
Extends: ru.dgis.sdk.NativeObject
Methods
fun entry(point: RoutePoint): FloatRouteLongEntry?
Элемент, в который попадает заданная точка.
Parameters
fun entries(begin: RoutePoint, end: RoutePoint): List<FloatRouteLongEntry>
Элементы, чистично или полностью покрываемые отрезком <a href="#">begin,end</a>.
Parameters
Properties
val size
Количество элементов.
val isEmpty
Элементы отсутсвуют.
val first
Первый элемент.
val last
Последний элемент.
val entries
Все элементы.
FloatRouteLongEntry
Протяженный элемент маршрута - отрезок и значение на нем.
FloatRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: Float
)
Протяженный элемент маршрута - отрезок и значение на нем.
Parameters
Properties
FloorInfo
Информация об этажном плане для маркера - элемента поисковой выдачи.
FloorInfo(levelId: LevelId, buildingId: BuildingId)
Информация об этажном плане для маркера - элемента поисковой выдачи.
Parameters
Properties
FollowControl
Контрол включения слежения за маркером местоположения.
Extends: ru.dgis.sdk.map.MapControl
FollowControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Контрол включения слежения за маркером местоположения.
Parameters
FollowController
Класс, позволяющий управлять положением камеры и маркера геопозиции.
Реализации всех его методов должны быть потокобезопасны. У большинства
методов есть тривиальные реализации по умолчанию (таким образом
FollowController, отвечающий за масштаб, не обязан переопределять методы
coordinates() и т.п.).
Extends: ru.dgis.sdk.NativeObject
Methods
fun requestValues(values: EnumSet<FollowValue>): Unit
С помощью этого метода в FollowController сообщается, какие из
предоставляемых им значений используются. Это позволяет освободить
ресурсы, связанные с вычислением неиспользуемых значений. Метод может
вызываться многократно с разными значениями, в этом случае актуальным
является последнее из них.
Parameters
fun setClock(clock: FollowControllerClock?): Unit
С помощью этого метода в FollowController передаётся источник времени.
Значения времени, которые возвращаются из next_timestamp(), должны быть
вычислены относительно значений, полученных из clock. Этот метод
повторно не вызывается чтобы заменить ранее установленное с помощью него
ненулевое значение на отличное от него ненулевое значение.
Parameters
fun setThresholds(shiftMeters: Double, rotation: Double): Unit
Пороговые значения для смещения позиции и угла поворота. Считается,
что смещения на меньшее расстояние и повороты на меньший угол визуально
не различимы.
Parameters
fun updateValues(): Unit
Запрос на вычисление всех предоставляемых значений. Непосредственно
после вызова этого метода, все значения (coordinates(),
satellite_bearing(), и т.д.) считаются актуальными.
Returns
Properties
val availableValues
Набор видов значений, которыми умеет управлять данный
FollowController. Например, один FollowController может управлять
только координатами, а другой только наклоном карты.
val nextTimestampChannel
Канал, сообщающий подписчикам о времени следующего видимого изменения
значений. О времени изменения значений, отсутствующих среди запрошенных
с помощью request_values(), может не сообщаться. Значения времени
интерпретируются относительно источника, переданного в set_clock().
val nextTimestamp
Канал, сообщающий подписчикам о времени следующего видимого изменения
значений. О времени изменения значений, отсутствующих среди запрошенных
с помощью request_values(), может не сообщаться. Значения времени
интерпретируются относительно источника, переданного в set_clock().
val coordinates
Географические координаты.
val satelliteBearing
Направление движения.
val magneticBearing
Направление на магнитный север.
val tilt
Наклон карты.
val styleZoom
Стилевой zoom-уровень карты.
val accuracy
Радиус круга точности (метры).
FollowControllerClock
Часы, используемые для измерения времени в FollowController.
Extends: ru.dgis.sdk.NativeObject
Properties
val now
FollowPosition
Настройки слежения за направлением, наклоном и уровнем зума.
FollowPosition(
bearing: FollowBearing = FollowBearing.OFF,
tilt: FollowTilt = FollowTilt.OFF,
styleZoom: FollowStyleZoom = FollowStyleZoom.OFF
)
Настройки слежения за направлением, наклоном и уровнем зума.
Parameters
Properties
FormattedAddress
Человекочитаемое представление адреса.
Properties
val drilldownAddress
Адрес из дриллдауна.
Пример: "Новосибирск, Кировский район".
val streetAddress
Адрес внутри населённого пункта.
Пример: "Николаева, 11".
val addressComment
Комментарий к адресу.
Пример: "301 офис; 9 этаж".
val postCode
Почтовый индекс объекта с кодом здания, если есть.
Пример: "630088", "630007/XBVJF8".
Fps
Frames per second, частота кадров.
Properties
val value
FreeRoamSettings
Extends: ru.dgis.sdk.NativeObject
Properties
var onRoutePrefetchLength
Тайлы дорожного графа загружаются в http-кэш во время ведения по маршруту,
если они соответствуют участку марш рута от текущей позиции до указанного расстояния.
Значение по умолчанию - 5 км.<p>Загрузка тайлов в http-кэш не выполняется, если параметр соответствует нулевому или отрицательному расстоянию.</p>
var onRoutePrefetchRadiusMeters
При кэшировании тайлов дорожного графа во время ведения по маршруту тайлы
загружаются в http-кэш, если оказываются ближе заданного расстояния в метрах
от линии маршрута.
Значение по умолчанию - 1 км.<p>Загрузка тайлов в http-кэш не выполняется, если параметр соответствует нулевому или отрицательному расстоянию.</p>
var prefetchRadiusMeters
Тайлы дорожного графа загружаются в http-кэш если оказываются ближе заданного расстояния в метрах от текущей
позиции.
Значение по умолчанию - 2 км.<p>Загрузка тайлов в http-кэш не выполняется, если параметр соответствует нулевому или отрицательному расстоянию.</p>
Geometry
Объект геометрии
Extends: ru.dgis.sdk.NativeObject
Methods
fun intersects(geometry: Geometry): Boolean
Функция intersects позволяет определить, имеет ли данная геометрия
пересечение с другим объектом геометрии
Parameters
Properties
val kind
val bounds
Прямоугольник минимального размера, содержащий геометрию.
val minPoint
Минимальнная точка ограничивающего прямоугольника.
val maxPoint
Максимальная точка ограничивающего прямоугольника.
GeometryMapObject
Геометрический объект карты.<p>методы потокобезопасны</p><p>объект будет отображаться на карте при выполнении следующих условий:</p><ul><li>объект видимый;</li><li>объект добавлен в источник данных;</li><li>источник данных, содержащий объект, добавлен в карту;</li><li>в стилях, установленных в карту, есть параметры отображения, применимые к этому объекту.
Подробнее про отображение на карте - см. ISource.</li></ul>
Extends: ru.dgis.sdk.map.MapObject
Properties
val geometryChannel
Геометрия объекта.
var geometry
Геометрия объекта.
val objectAttributes
Получение свойств объекта карты для чтения и изменения.
val isVisibleChannel
Текущий флаг видимости объекта.
var isVisible
Текущий флаг видимости объекта.
val isDraggableChannel
Текущий флаг перемещаемости объекта.
var isDraggable
Текущий флаг перемещаемости объекта.
val bounds
Прямоугольник минимального размера, содержащий геометрию.
GeometryMapObjectBuilder
Класс для установки свойств и последующего создания геометрических объектов.
Extends: ru.dgis.sdk.NativeObject
GeometryMapObjectBuilder()
Methods
fun setObjectAttribute(name: String, value: AttributeValue): GeometryMapObjectBuilder
Установка свойства объекта карты.
Parameters
name
имя свойства объекта карты
value
значение свойства объекта карты
Returns
fun setObjectAttributes(values: Map): GeometryMapObjectBuilder
Установка свойств объекта карты.
Parameters
values
набор пар "имя":"значение" для добавляемых свойства объекта карты
<p>метод не заменяет весь набор свойств объекта, т.е. если свойство в values отсутствует,
но уже добавлено в объект ранее, оно не будет изменено.</p>
Returns
fun setGeometry(geometry: Geometry): GeometryMapObjectBuilder
Установка геометрии объекта карты.
Parameters
fun setVisible(visible: Boolean): GeometryMapObjectBuilder
Установка видимости объекта карты.
Parameters
fun setDraggable(draggable: Boolean): GeometryMapObjectBuilder
Установка возможности перетаскивания объекта карты.
Parameters
fun setUserData(userData: Any?): GeometryMapObjectBuilder
Установка пользовательских данных.<p>пользовательские данные никак не используются в SDK и нужны только чтобы возвращать их пользователю.</p>
Parameters
fun createObject(): GeometryMapObject
Конструирование объекта карты.<p>у объекта обязательно должна быть установлена геометрия</p><p>после вызова этой функции GeometryMapObjectBuilder непригоден для задания параметров объекта карты или
для его создания</p>
Returns
fun setObjectAttribute(name: String, value: Boolean): GeometryMapObjectBuilder
Parameters
fun setObjectAttribute(name: String, value: Long): GeometryMapObjectBuilder
Parameters
fun setObjectAttribute(name: String, value: Int): GeometryMapObjectBuilder
Parameters
fun setObjectAttribute(name: String, value: Double): GeometryMapObjectBuilder
Parameters
fun setObjectAttribute(name: String, value: Float): GeometryMapObjectBuilder
Parameters
fun setObjectAttribute(name: String, value: String): GeometryMapObjectBuilder
Parameters
fun setObjectAttribute(name: String, value: ByteArray): GeometryMapObjectBuilder
Parameters
fun setObjectAttribute(name: String, value: Color): GeometryMapObjectBuilder
Parameters
GeometryMapObjectSource
Источник геометрических объектов карты.
Extends: ru.dgis.sdk.map.Source
Methods
fun clusteringObjects(position: CameraPosition): List<MapObject>
Получить список объектов, участвующих в кластеризации при переданной позиции камеры.
В списке будут присутствовать как кластеры, так и геометрические объекты.
Parameters
fun addObject(item: GeometryMapObject): Unit
Добавление объекта в источник.<p>Добавление объектов по группой эффективнее, чем добавление по одному, особенно в случае,
когда источник уже добавлен в одну или несколько карт.</p><p>Добавление асинхронное, потокобезопасное, метод можно использовать из любого потока.</p><p>Для источника с кластеризацией добавление пока не реализовано, будет выброшено исключение.</p>
Parameters
fun addObjects(objects: List<GeometryMapObject>): Unit
Добавление нескольких объектов в источник.<p>Добавление объектов по группой эффективнее, чем добавление по одному, особенно в случае,
когда источник уже добавлен в одну или несколько карт.</p><p>Добавление асинхронное, потокобезопасное, метод можно использовать из любого потока.</p><p>Для источника с кластеризацией добавление пока не реализовано, будет выброшено исключение.</p>
Parameters
fun removeObject(item: GeometryMapObject): Unit
Удаление объекта из источника.<p>Удаление асинхронное, потокобезопасное, метод можно использовать из любого потока.</p>
Parameters
fun removeObjects(objects: List<GeometryMapObject>): Unit
Удаление объектов из источника.
Parameters
fun removeAndAddObjects(objectsToRemove: List<GeometryMapObject>, objectsToAdd: List<GeometryMapObject>): Unit
Удаление и добавление объектов у источника.
Parameters
Properties
val objects
Получить все объекты, добавленные в источник.
val sourceAttributes
Получение значений свойств по умолчанию для всех объектов, добавленных в источник (см. IAttributes).
GeometryMapObjectSourceBuilder
Extends: ru.dgis.sdk.NativeObject
Methods
fun setSourceAttribute(name: String, value: AttributeValue): GeometryMapObjectSourceBuilder
Установка свойства объектов карты, общего для всего источника (см. ISource).
Parameters
fun setSourceAttributes(values: Map): GeometryMapObjectSourceBuilder
Установка свойств объектов карты, общих для всего источника.
Parameters
fun addObject(item: GeometryMapObject): GeometryMapObjectSourceBuilder
добавление геометрического объекта карты в источник
Parameters
fun addObjects(objects: List<GeometryMapObject>): GeometryMapObjectSourceBuilder
добавление нескольких геометрических объектов карты в источник
Parameters
fun createSource(): GeometryMapObjectSource
Создание источника геометрических объектов.<p>после вызова этой функции использовать GeometryMapObjectSourceBuilder для создания источника данных или
для задания параметров источника данных нельзя</p>
Returns
GeoPoint
Точка в сферической системе координат, которая совместно с геодезической системой координат (например, WGS84)
указывает на точку на поверхности Земли.
Данная структура не привязана к конкретной геодезической системе координат.
Но данный модуль содержит свободные функции, которые оперируют данной структурой уже
в конкретной в системе координат (в какой именно см. в документации к функциям).
GeoPoint(latitude: Latitude, longitude: Longitude)
Точка в сферической системе координат, которая совместно с геодезической системой координат (например, WGS84)
указывает на точку на поверхности Земли.
Данная структура не привязана к конкретной геодезической системе координат.
Но данный модуль содержит свободные функции, которые оперируют данной структурой уже
в конкретной в системе координат (в какой именно см. в документации к функциям).
Parameters
Methods
fun move(bearing: Bearing, meter: Meter): GeoPoint
Вычисляет точку, полученную перемещением исходной точки в указанном направлении на указанное расстояние.
Parameters
fun withElevation(elevation: Elevation = Elevation(0.0f)): GeoPointWithElevation
Parameters
fun bearing(point: GeoPoint): Bearing
Вычисляет направление (путевой угол, т.е. угол между направлением на географический север и направлением движения,
отсчитываемый по часовой стрелке) между двумя точками.
Parameters
GeoPointRouteAttribute
Контейнер, который описывает точечный атрибут маршрута.
Каждый элемент хранится в виде точки на маршруте, в которой этот элемент расположен и значения самого элемента.
Extends: ru.dgis.sdk.NativeObject
Methods
fun entries(begin: RoutePoint, end: RoutePoint): List<GeoPointRouteEntry>
Элементы, попадающие в отрезок [begin, end).
Parameters
fun findNearBackward(point: RoutePoint): GeoPointRouteEntry?
Найти ближайший элемент, позиция которого
<
= point.<p>Сложность операции log2(N), где N = size.</p>
Parameters
fun findNearForward(point: RoutePoint): GeoPointRouteEntry?
Найти ближайший элемент, позиция которого >= point.<p>Сложность операции log2(N), где N = size.</p>
Parameters
fun calculateGeoPoint(routePoint: RoutePoint): SegmentGeoPoint?
Вычисляет GeoPoint по известной RoutePoint.
Parameters
routePoint
Returns
SegmentGeoPoint?Вычисленные географические координаты и направление сегмента, на который указывает параметр route_point.
Если маршрут пустой или route_point выходит за пределы маршрута, то возвращается null.
<p>Сложность операции O(log2(N)), где N = route_geometry.size()</p>
Properties
val size
Количество элементов.
val isEmpty
Элементы отсутсвуют.
val first
Первый элемент.
val last
Последний элемент.
val entries
Все элементы.
val length
Длина маршрута.
GeoPointRouteEntry
Элемент маршрута - точка и значение в ней.
GeoPointRouteEntry(point: RoutePoint, value: GeoPoint)
Элемент маршрута - точка и значение в ней.
Parameters
Properties
GeoPointWithElevation
Точка в географической системе координат (широта, долгота, возвышение).<p>возвышение (Elevation) в метрах над поверхностью, а не над уровнем моря.</p>
GeoPointWithElevation(
latitude: Latitude,
longitude: Longitude,
elevation: Elevation = Elevation(value = 0.0f)
)
Точка в географической системе коорди нат (широта, долгота, возвышение).<p>возвышение (Elevation) в метрах над поверхностью, а не над уровнем моря.</p>
Parameters
Methods
fun bearing(point: GeoPoint): Bearing
Вычисляет направление (путевой угол, т.е. угол между направлением на географический север и направлением движения,
отсчитываемый по часовой стрелке) для проекции точки на карту и заданной точкой.
Parameters
fun distance(point: GeoPoint): Meter
Вычисляет минимальное (по ортодромии) расстояние между проекцией точки на карту и заданной точкой.
Parameters
fun move(bearing: Bearing, meter: Meter): GeoPointWithElevation
Вычисляет точку, полученную перемещением проекции исходной точки в указанном направлении на указанное расстояние.
Parameters
GeoRect
Прямоугольная область в сферической системе координат (например, WGS84).
Данная структура не привязана к конкретной геодезической системе координат.
Methods
fun contains(rect2: GeoRect): Boolean
Содержится ли rect2 внутри rect1, т.е. все его точки находятся внутри.
Parameters
fun contains(point: GeoPoint): Boolean
Содержит ли прямоугольник точку.
Точки, расположенные на границе, так же считаются принадлежащими прямоугольнику.
Parameters
fun intersects(rect2: GeoRect): Boolean
Пересекаются ли прямоугольники, т.е. имеют общие точки.
Прямогольники, с общими точками лишь на границе, так же считаются пересекающимися.
Parameters
fun expand(rect2: GeoRect): GeoRect
Расширить прямоугольник.
Вернуть прямоугольник минимального размера, содержащий оба переданных прямоугольника.
Parameters
Properties
val isValid
Проверяет прямоугольник на корректность.
val isDegenerate
Проверяет прямоугольник на вырожденность.
Если точки в прямоугольнике равны, то он вырождается в точку.
Вырожденный прямоугольник является корректным прямоугольником. Некорректный прямоугольник не является вы рожденным.
val southWestPoint
Юго-западная точка, левая нижняя граница прямоугольника.
val northEastPoint
Северо-восточная точка, правая верхняя граница прямоугольника.
GestureManager
Класс для управления обработкой жестов.
Extends: ru.dgis.sdk.NativeObject
Methods
fun setSettingsAboutMapPositionPoint(settings: EventsProcessingSettings): Unit
Настраиваем точку, относительно которой происходит масштабирование и поворот.
Parameters
settings
настройки обработки событий.
<p>при вызове функции происходит пересоздание инструментов распознавания жестов.</p>
Returns
fun setMutuallyExclusiveGestures(rules: List<EnumSet<Gesture>>): Unit
Установка списка правил исключения одновременного срабатывания нескольких жестов.<p>К переданному списку правил добавляются правила по умолчанию, которые не позволяют жесту управления наклоном
срабатывать одновременно с другими жестами.
Каждое правило представляет собой перечень жестов, которые не могут срабатывать одновременно
Например, если в правиле указать жесты Scaling и Rotation то эти жесты не будут работать одновременно
В случае одновременного выполнения жестов из правила, сработает жест с большим приоритетом
Порядок приоритета жестов (по убыванию): (Shift ->) Tilt -> Scaling -> Rotation -> MultiTouchShift</p>
Parameters
Properties
var enabledGestures
var scalingSettings
var rotationSettings
var multitouchShiftSettings
var tiltSettings
GradientPolylineOptions
Параметры градиентной полилинии
GradientPolylineOptions(
borderWidth: LogicalPixel = LogicalPixel(value = 0.0f),
secondBorderWidth: LogicalPixel = LogicalPixel(value = 0.0f),
gradientLength: LogicalPixel = LogicalPixel(value = 1.0f),
borderColor: Color = Color(),
secondBorderColor: Color = Color(),
colors: List<Color>,
colorIndices: ByteArray
)
Параметры градиентной полилинии
Parameters
borderWidth
secondBorderWidth
gradientLength
borderColor
secondBorderColor
colors
colorIndices
Properties
val borderWidth
Ширина границы линии
val secondBorderWidth
Ширина второй границы линии
val gradientLength
Длина градиентной линии
val borderColor
Цвет окантовки
val secondBorderColor
Цвет второй окантовки
val colors
Палитра цветов градиентной полилинии
val colorIndices
Индексы цветов градиентной полилинии. Количество индексов должно быть
на 1 меньше количества точек полилинии.
HttpCacheManager
HttpOptions
Опции Http-клиента
HttpOptions(
certificates: List?<Certificate> = null,
timeout: Duration = Duration.ofMilliseconds(15000),
useCache: Boolean = true,
cacheStoragePath: String? = null,
cacheMaxSize: Long? = null,
proxy: HttpProxyOptions? = null
)
Опции Http-клиента
Parameters
certificates
timeout
useCache
cacheStoragePath
cacheMaxSize
proxy
Properties
val certificates
Сертификаты в PEM-фор мате.
Если не заданы, используются системные + поставляемые вместе с SDK.
val timeout
Таймаут для HTTP-запросов
val useCache
Использовать HTTP кэш.
val cacheStoragePath
Путь к каталогу верхнего уровня для основного файлового хранилища HTTP кэша.
Файловое хранилище будет находиться в подкаталоге http_cache в данном каталоге.
Если путь не указан, будет использоваться каталог, возвращаемый context.getCacheDir().
val cacheMaxSize
Максимальный размер HTTP кэша в байтах. Если не указан, по умолчанию максимальный
размер HTTP кэша составляет 300 Мб.
val proxy
Настройки proxy
HttpProxyOptions
Настройки proxy.
Image
Изображение.
Extends: ru.dgis.sdk.NativeObject
ImageData
Данные изображения: размер, формат и бинарные данные.
ImageData(
size: ScreenSize,
format: ImageFormat,
data: ByteArray
)
Данные изображения: размер, формат и бинарные данные.
Parameters
Methods
fun toBitmap(): Bitmap
Returns
Properties
IncompleteTextHandler
Предложено автодополнение для введенного пользователем текста.
Extends: ru.dgis.sdk.NativeObject
Properties
val queryText
Нужно подставить в строку поиска этот текст и дать пользователю продолжить вводить запрос.
IndoorBuilding
Здание с этажными планами.
Extends: ru.dgis.sdk.NativeObject
Properties
val id
Идентификатор здания с этажными планами.
val defaultLevelIndex
Индекс этажа по умолчанию.
val levels
Информация обо всех этажах.
val activeLevelIndexChannel
Индекс активного этажа.
var activeLevelIndex
Индекс активного этажа.
IndoorControl
Контрол этажей.<p>Представляет из себя колонку с названиями этажей, из которых активное подсвечено.
При нажатии на название переключается этажный план.
Одновременно отображается не более 5-ти название, непоместившиеся скролятся.</p>
Extends: ru.dgis.sdk.map.MapControl
IndoorControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Контрол этажей.<p>Представляет из себя колонку с названиями этажей, из которых активное подсвечено.
При нажатии на название переключается этажный план.
Одновременно отображается не более 5-ти название, непоместившиеся скролятся.</p>
Parameters
Methods
Properties
var markedLevels
Этажи, на которых отображаются пометки.
IndoorControlModel
Модель контрола этажей.
Extends: ru.dgis.sdk.NativeObject
Methods
Properties
val activeLevelIndexChannel
Индекс активного этажа.
var activeLevelIndex
Индекс активного этажа.
var markedLevels
Этажи, на которых отображаются пометки.
val levelNamesChannel
Названия этажей.
Пусто, если на карте не отображается здание с этажными планами, или у здания всего один этаж.
val levelNames
Названия этажей.
Пусто, если на карте не отображается здание с этажными планами, или у здания всего один этаж.
IndoorDetector
Extends: ru.dgis.sdk.NativeObject
Properties
val indoorChannel
Канал, который оповещает о нахождении пользователя в помещении.
val indoor
Канал, который оповещает о нахождении пользователя в помещении.
IndoorManager
Класс для получения текущего здания с этажными планами.
Extends: ru.dgis.sdk.NativeObject
Properties
val focusedBuildingChannel
Получение текущего здания с этажными планами.
val focusedBuilding
Получение текущего здания с этажными планами.
IndoorRouteLevelsGetter
Позволяет получать множество этажей, через которые проходят маршруты,
отображаемые на карте.
Extends: ru.dgis.sdk.NativeObject
Properties
InputEvent
Событие пользовательского ввода.
Extends: ru.dgis.sdk.map.Event
Properties
val timestamp
Получение времени регистрации события ввода.
InstructionRouteAttribute
Контейнер, который описывает точечный атрибут маршрута.
Каждый элемент хранится в виде точки на маршруте, в которой этот элемент расположен и значения самого элемента.
Extends: ru.dgis.sdk.NativeObject
Methods
fun entries(begin: RoutePoint, end: RoutePoint): List<InstructionRouteEntry>
Элементы, попадающие в отрезок [begin, end).
Parameters
fun findNearBackward(point: RoutePoint): InstructionRouteEntry?
Найти ближайший элемент, позиция которого
<
= point.<p>Сложность операции log2(N), где N = size.</p>
Parameters
fun findNearForward(point: RoutePoint): InstructionRouteEntry?
Найти ближайший элемент, позиция которого >= point.<p>Сложность операции log2(N), где N = size.</p>
Parameters
Properties
val size
Количество элементов.
val isEmpty
Элементы отсутсвуют.
val first
Первый элемент.
val last
Последний элемент.
val entries
Все элементы.
InstructionRouteEntry
Элемент маршрута - точка и значение в ней.
InstructionRouteEntry(point: RoutePoint, value: RouteInstruction)
Элемент маршрута - точка и значение в ней.
Parameters
Properties
IntRouteAttribute
Контейнер, который описывает точечный атрибут маршрута.
Каждый элемент хранится в виде точки на маршруте, в которой этот элемент расположен и значения самого элемента.
Extends: ru.dgis.sdk.NativeObject
Methods
fun entries(begin: RoutePoint, end: RoutePoint): List<IntRouteEntry>
Элементы, попадающие в отрезок [begin, end).
Parameters
fun findNearBackward(point: RoutePoint): IntRouteEntry?
Найти ближайший элемент, позиция которого
<
= point.<p>Сложность операции log2(N), где N = size.</p>
Parameters
fun findNearForward(point: RoutePoint): IntRouteEntry?
Найти ближайший элемент, позиция которого >= point.<p>Сложность операции log2(N), где N = size.</p>
Parameters
Properties
val size
Количество элементов.
val isEmpty
Элементы отсутсвуют.
val first
Первый элемент.
val last
Последний элемент.
val entries
Все элементы.
IntRouteEntry
Элемент маршрута - точка и значение в ней.
IntRouteEntry(point: RoutePoint, value: Int)
Элемент маршрута - точка и значение в ней.
Parameters
Properties
IsOpenNow
Открыто сейчас.
IsOpenNow()
Открыто сейчас.
ItemMarkerInfo
KeyFromAsset
Ключ из asset-а.
Properties
val path
Путь относительно корневой директории asset-ов.
KeyFromFile
Ключ из файла.
Properties
val path
Путь к файлу.
KeyFromString
Ключ из строки.
Properties
val contents
Содержимое.
KeySource
Источник ключа.
Methods
fun match(
fromAsset: Function1,
fromFile: Function1,
fromString: Function1
): T
Parameters
fun toString(): String
Returns
fun hashCode(): Int
Returns
Properties
val isFromAsset
val asFromAsset
val isFromFile
val asFromFile
val isFromString
val asFromString
val value
LanesCalloutMapPosition
Положение бабла полосности для маршрута.
LanesCalloutMapPosition(
mapId: MapId,
routePoint: RoutePoint,
geoPoint: GeoPoint
)
Положение бабла полосности для маршрута.
Parameters
Properties
val mapId
Идентификатор карты, для которой приведена позиция.
val routePoint
Позиция бабла полосности на маршруте.
val geoPoint
Позиция бабла полосности на карте.
LaneSignRouteLongAttribute
Контейнер, который хранит протяженный атрибут маршрута.
Каждый элемент хранится в виде пары, состоящей из точки и значения элемента атрибута.
Действие атрибута начинается с данной точки и заканчивается в следущей точке,
начиная с которой начинается действие атрибута следующего элемента.
Extends: ru.dgis.sdk.NativeObject
Methods
fun entry(point: RoutePoint): LaneSignRouteLongEntry?
Элемент, в который попадает заданная точка.
Parameters
fun entries(begin: RoutePoint, end: RoutePoint): List<LaneSignRouteLongEntry>
Элементы, чистично или полностью покрываемые отрезком <a href="#">begin,end</a>.
Parameters
Properties
val size
Количество элементов.
val isEmpty
Элементы отсутсвуют.
val first
Первый элемент.
val last
Последний элемент.
val entries
Все элементы.
LaneSignRouteLongEntry
Протяженный элемент маршрута - отрезок и значение на нем.
LaneSignRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: RouteLaneSign
)
Протяженный элемент маршрута - отрезок и значение на нем.
Parameters
Properties
Latitude
Географическая широта.
Properties
val value
LevelId
Идентификатор этажного плана.
Properties
val value
LevelInfo
Информация об этаже здания.
LocaleManager
Location
Геопозиция.
Location(
coordinates: LocationCoordinates,
altitude: LocationFuzzyDouble?,
course: LocationCourse?,
groundSpeed: LocationFuzzyDouble?,
source: String,
timestamp: Duration
)
Геопозиция.
Parameters
coordinates
altitude
course
groundSpeed
source
timestamp
Properties
val coordinates
coordinates::value - координаты геопозиции.
coordinates::accuracy - горизонтальная точность определения координат геопозиции (DRMS), м.
https://en.wikipedia.org/wiki/Circular_error_probable
Область значений: >= 0.
val altitude
altitude::value - высота над референсным эллипсоидом WGS84, м.
altitude::accuracy - стандартное отклонение ошибки измерения высоты, м.
null означает, что платформа не предоставляет данное поле.
https://en.wikipedia.org/wiki/Standard_deviation
Область значений: (null, > 0).
val course
course::value - путевой угол (направление движения вдоль поверхности Земли).
Угол измеряется относительно географического севера).
course::accuracy - стандартное отклонение ошибки измерения путевого угла.
null означает, что платформа не предоставляет данное поле.
https://en.wikipedia.org/wiki/Standard_deviation
Область значений: (null, > 0).
val groundSpeed
ground_speed - скорость движения вдоль поверхности Земли, м/с.
Область значений: >= 0.
ground_speed::accuracy - среднеквадратичное отклонение ошибки измерения скорости, м/с.
null означает, что платформа не предоставляет данное поле.
https://en.wikipedia.org/wiki/Rayleigh_distribution
Область значений: (null, > 0).
val source
Название источника геопозиции.<p>timestamp'ы между разными источниками геопозиции не синхронизированы,
поэтому сравнивать timestamp'ы у геопозиций, которые получены из разных источников нельзя.</p>
val timestamp
Временная точка, в которой была определена геопозиция.
Эта точка не привязана ни к какой конкретной дате и используется исключительно для того,
чтобы вычислить время между двумя измерениями геопозиции,
полученными от одного источника геопозиции в одной сессии.
Это поле должно монотонно возрастать (даже когда система находится в спящем режиме).
LocationCoordinates
LocationCourse
LocationFuzzyDouble
LogicalPixel
Пиксель, размер которого не зависит от плотности экрана.<p>1 логический пиксель соответствует 1 / (базовый ppi) дюйма.
Базовый PPI зависит от устройства и вычисляется из отношения DevicePpi/DeviceDensity.
DevicePpi и DeviceDensity, в свою очередь, задаются с ОС через интерфейс карты.
Для Android LogicalPixel соответствует dp, для iOS - point'у.</p>
LogicalPixel(value: Float = 0.0f)
Пиксель, размер которого не зависит от плотности экрана.<p>1 логический пиксель соответствует 1 / (базовый ppi) дюйма.
Базовый PPI зависит от устройства и вычисляется из отношения DevicePpi/DeviceDensity.
DevicePpi и DeviceDensity, в свою очередь, задаются с ОС через интерфейс карты.
Для Android LogicalPixel соответствует dp, для iOS - point'у.</p>
Parameters
value
Properties
val value
LogMessage
Сообщение, записываемое в лог.
LogOptions
Настройки логирования.
Longitude
Географическая долгота.
Properties
val value
MagneticChangeListener
Класс, отслеживающий изменения направления компаса и его доступность.
Extends: ru.dgis.sdk.NativeProxy
ManeuverControl
ManeuverControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Parameters
Map
Карта.
Extends: ru.dgis.sdk.NativeObject
Methods
fun addSource(source: Source): Unit
Добавление источника данных на карту.<p>Происходит асинхронно. Метод может вызываться из любого потока, потокобезопасен.</p>
Parameters
fun removeSource(source: Source): Unit
Удаление источника данных из карты.<p>Происходит асинхронно. Метод может вызываться из любого потока, потокобезопасен.</p>
Parameters
fun getRenderedObjects(centerPoint: ScreenPoint, radius: ScreenDistance = ScreenDistance(value = 1.0f)): Future<List<RenderedObjectInfo>>
Получение отображаемых объектов карты, проецирующихся на окружность на экране.
Parameters
centerPoint
центр окружности.
radius
радиус окружности.
<p>Список объектов формируется в порядке отрисовки от поздних к ранним.</p>
Returns
fun setAttribute(name: String, value: AttributeValue): Unit
Parameters
Properties
val id
Идентификатор экземпляра карты, уникальный в рамках процесса.
val camera
Получение камеры.
val indoorManager
Получение менеджера этажных планов.
val dataLoadingStateChannel
Нотификация о состоянии загружаемых в карту данных.<p>При слежении за позицией камеры состояние карты всегда будет MapDataLoadingState::Loading.</p>
val dataLoadingState
Нотификация о состоянии загружаемых в карту данных.<p>При слежении за позицией камеры состояние карты всегда будет MapDataLoadingState::Loading.</p>
val styleChannel
Получение текущих стилей карты.
var style
Получение текущих стилей карты.
val fontIconSizeMultiplierChannel
Множитель размера иконок и шрифтов, полученный из приложения.<p>Размер иконок и шрифтов задаётся в логических пикселях (см. LogicalPixel)
и умножается на множитель размера шрифтов и иконок.</p>
var fontIconSizeMultiplier
Множитель размера иконок и шрифтов, полученный из приложения.<p>Размер иконок и шрифтов задаётся в логических пикселях (см. LogicalPixel)
и умножается на множитель размера шрифтов и иконок.</p>
val sources
Получение источников данных карты.<p>Происходит асинхронно. Метод может вызываться из любого потока, потокобезопасен.</p>
val mapVisibilityStateChannel
var mapVisibilityState
val attributes
Получение атрибутов.<p>должны быть указаны свойства:
"theme"="day|night"
"navigatorOn"="true|false"</p><p>TODO: стилевые свойства для пробок</p>
val interactiveChannel
Интерактивность карты.
Под интерактивностью понимается наличие у пользователя в озможности взаимодействия с картой.
При отключении интерактивности карта перестанет реагировать на события ввода, пришедшие от пользователя.
Также перестанут работать контролы для работы с картой (приближения и перехода к текущему положению).
При этом остаётся возможность работать с картой через set_position/move.
При переходе в неинтерактивное состояние незавершённые жесты будут сброшены.
По умолчанию карта интерактивна (interactive == true).<p>функция может быть вызвана из любого потока.</p>
var interactive
Интерактивность карты.
Под интерактивностью понимается наличие у пользователя возможности взаимодействия с картой.
При отключении интерактивности карта перестанет реагировать на события ввода, пришедшие от пользователя.
Также перестанут работать контролы для работы с картой (приближения и перехода к текущему положению).
При этом остаётся возможность работать с картой через set_position/move.
При переходе в неинтерактивное состояние незавершённые жесты будут сброшены.
По умолчанию карта интерактивна (interactive == true).<p>функция может быть вызвана из любого потока.</p>
MapControl
Базовый класс для UI контролов карты.
Extends: android.widget.FrameLayout
MapControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Базовый класс для UI контролов карты.
Parameters
MapControls
Контролы управления картой во время навигации.
Extends: ru.dgis.sdk.map.MapControl
MapControls(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Контролы управления картой во время навигации.
Parameters
Methods
fun onLayout(
changed: Boolean,
left: Int,
top: Int,
right: Int,
bottom: Int
): Unit
Parameters
Properties
MapDirection
Угол поворота объекта относительно направления на север, в градусах, отсчитывается по часовой стрелке.
MapDirection(value: Double = 0.0)
Угол поворота объекта относительно направления на север, в градусах, отсчитывается по часовой стрелке.
Parameters
value
Properties
val value
MapId
Идентификатор экземпляра карты, уникальный в рамках процесса.
MapId(value: Int = 0)
Идентификатор экземпляра карты, уникальный в рамках процесса.
Parameters
value
Properties
val value
MapManager
Интерфейс, позволяющий добавлять карты в навигатор и убирать их из него
Extends: ru.dgis.sdk.NativeObject
MapObject
Объект на карте.
Extends: ru.dgis.sdk.NativeObject
Properties
var userData
Произвольные пользовательские данные, прикрепленные к объекту.
MapObjectManager
Extends: ru.dgis.sdk.NativeObject
MapObjectManager(map: Map, layerId: String? = null)
Создать IMapObjectManager.
Parameters
Methods
fun addObjects(objects: List<SimpleMapObject>): Unit
Добавить объекты
Parameters
fun removeObjects(objects: List<SimpleMapObject>): Unit
Удалить объекты
Parameters
fun removeAndAddObjects(objectsToRemove: List<SimpleMapObject>, objectsToAdd: List<SimpleMapObject>): Unit
Удалить и добавить объекты
Parameters
fun removeAll(): Unit
Returns
fun clusteringObjects(position: CameraPosition): List<MapObject>
Получить список объектов, участвующих в кластеризации при переданной позиции камеры.
В списке будут присутствовать как кластеры, так и маркеры.
Parameters
@JvmStatic
fun withClustering(
map: Map,
logicalPixel: LogicalPixel,
maxZoom: Zoom,
clusterRenderer: SimpleClusterRenderer,
minZoom: Zoom = Zoom(value = 0.0f),
layerId: String? = null
): MapObjectManager
Создать IMapObjectManager с кластеризацией данных. Кластеризуются только IMarker объекты.
Parameters
map
logicalPixel
минимально возможное расстояние на экране между точками привязки маркеров на уровнях,
где работает кластеризация.
maxZoom
уровень, начиная с которого видны все маркеры.
clusterRenderer
интерфейс для задания параметров отображения кластера.
minZoom
уровень, начиная с которого формируются кластеры.
layerId
ID слоя в стиле типа "Динамический объект".
Создаваемые объекты будут размещены на этом слое,
тем самым можно задать их порядок относительно других слоев.
Если не задан, объекты размещаются поверх остальных слоев.
Returns
@JvmStatic
fun withGeneralization(
map: Map,
logicalPixel: LogicalPixel,
maxZoom: Zoom,
minZoom: Zoom = Zoom(value = 0.0f),
layerId: String? = null
): MapObjectManager
Создать IMapObjectManager с генерализацией данных. Генерализуются только IMarker объекты.
Parameters
map
logicalPixel
минимально возможное расстояние на экране между точками привязки маркеров на уровнях,
где работает генерализация.
maxZoom
уровень, начиная с которого видны все маркеры.
minZoom
уровень, начиная с которого работает генерализация.
layerId
ID слоя в стиле типа "Динамический объект".
Создаваемые объекты будут размещены на этом слое,
тем самым можно задать их порядок относительно других слоев.
Если не задан, объекты размещаются поверх остальных слоев.
Returns
Properties
var isVisible
Переопределение видимости всех объектов, добавленных в экземпляр менеджера.
Значение false здесь имеет приоритет над видимостью отдельного объекта.
MapOptions
Параметры карты.
MapOptions()
Параметры карты.
Methods
@JvmStatic
fun fromAttributes(context: Context, attrs: AttributeSet): MapOptions
Parameters
Properties
var position
var sources
var styleFile
val mapAttributes
var fontIconSizeMultiplier
var copyrightInsetsSides
var maxFps
var powerSavingMaxFps
var renderMode
var lightTheme
var darkTheme
MapPaddingControl
Контрол, задающий padding карты.
Extends: ru.dgis.sdk.map.MapControl
Implements: android.view.ViewTreeObserver.OnGlobalLayoutListener
MapPaddingControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Контрол, задающий padding карты.
Parameters
MapRotationBeginEvent
MapRotationEndEvent
MapScalingBeginEvent
MapScalingEndEvent
MapShiftBeginEvent
MapShiftEndEvent
MapView
Контейнер, содержащий карту и дополнительные контролы.
Extends: android.widget.FrameLayout
Methods
fun onAttachedToWindow(): Unit
Returns
fun onDetachedFromWindow(): Unit
Returns
fun setTouchEventsObserver(observer: TouchEventsObserver?): Unit
Parameters
fun addObjectTappedCallback(callback: MapObjectTappedCallback): Unit
Parameters
fun removeObjectTappedCallback(callback: MapObjectTappedCallback): Unit
Parameters
fun addObjectLongTouchCallback(callback: MapObjectTappedCallback): Unit
Parameters
fun removeLongTouchCallback(callback: MapObjectTappedCallback): Unit
Parameters
fun setCopyrightMargins(
left: Int,
top: Int,
right: Int,
bottom: Int
): Unit
Parameters
fun onConfigurationChanged(newConfig: Configuration): Unit
Parameters
fun onSaveInstanceState(): Parcelable?
Returns
fun onVisibilityChanged(changedView: View, visibility: Int): Unit
Parameters
fun takeSnapshot(copyrightPosition: Alignment = Alignment.BOTTOM_RIGHT): Future<ImageData>
Parameters
fun useDefaultGestureRecognitionEngine(): Unit
Использовать встроенный распознаватель жестов.
Returns
fun useCustomGestureRecognitionEngine(customGestureRecognitionEngine: MapGestureRecognitionEngine): Unit
Использовать пользовательский распознаватель жестов.
Parameters
Properties
lateinit var mapOptions
var showApiVersionInCopyrightView
var maxFps
Максимально допустимая частота обновления карты.
Если не задана, равна частоте обновления экрана.
var powerSavingMaxFps
Максимально допустимая частота обновления карты в режиме сохранения энергии.
Если не задана, равна maxFps.
val fpsChannel
Частота обновления карты.
Для получения корректного значения необходимо держать подписку на канал.
Перед вызовом метода карта должна быть проинициализирована (завершен getMapAsync).
val renderView
Returns the View used for rendering OpenGL.
val gestureManager
MarkedByRouteIndoorControl
Контрол этажей, на котором отмечены этажи, через которые на карте проходят маршруты.
Extends: ru.dgis.sdk.map.IndoorControl
MarkedByRouteIndoorControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Контрол этажей, на котором отмечены этажи, через которые на карте проходят маршруты.
Parameters
MarkedUpText
Размеченный текст.
MarkedUpText(text: String, matchedParts: List<MarkedUpTextSpan>)
Размеченный текст.
Parameters
Properties
val text
Текст.
val matchedParts
Набор непересекающихся Span в порядке их расположения в строке text, описывающих части, совпадающие
с пользовательским запросом.
MarkedUpTextSpan
Описывает поднабор байтов строки text.
Marker
Точечная отметка на карте, представляющая интерес для пользователя.
Extends: ru.dgis.sdk.map.SimpleMapObject
Properties
var position
Получение местоположения маркера.
var icon
Получение иконки маркера.
var anchor
Получение точки привязки иконки маркера.
var iconOpacity
Получение прозрачности иконки маркера.
var text
Получение подписи маркера.
var textStyle
Получение стиля подписи маркера.
var isDraggable
Получение флага перемещаемости маркера.
var iconWidth
Получение целевой ширины маркера, используемой для масштабирования.
var iconMapDirection
Угол поворота маркера на карте относительно направления на север, по часовой стрелке.
var animatedAppearance
Анимировать ли появление.
MarkerOptions
Параметры маркера.
MarkerOptions(
position: GeoPointWithElevation,
icon: Image?,
iconMapDirection: MapDirection? = null,
anchor: Anchor = Anchor(x = 0.5f, y = 0.5f),
text: String? = null,
textStyle: TextStyle? = null,
iconOpacity: Opacity = Opacity(value = 1.0f),
visible: Boolean = true,
draggable: Boolean = false,
iconWidth: LogicalPixel = LogicalPixel(value = 0.0f),
userData: Any? = null,
zIndex: ZIndex = ZIndex(value = 0),
animatedAppearance: Boolean = true,
levelId: LevelId? = null
)
Параметры маркера.
Parameters
position
icon
iconMapDirection
anchor
text
textStyle
iconOpacity
visible
draggable
iconWidth
userData
zIndex
animatedAppearance
levelId
Properties
val position
val icon
val iconMapDirection
val anchor
val text
val textStyle
val iconOpacity
val visible
val draggable
val iconWidth
целевая ширина, используемая для масштабирования
val userData
val zIndex
Уровень отрисовки объекта.
val animatedAppearance
Анимировать ли появление
val levelId
Привязка к поэтажному плану здания.
MessageControl
MessageControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Parameters
Meter
Длина/расстояние в метрах
Properties
val value
MillisecondsRouteAttribute
Контейнер, который описывает точечный атрибут маршрута.
Каждый элемент хранится в виде точки на маршруте, в которой этот элемент расположен и значения самого элемента.
Extends: ru.dgis.sdk.NativeObject
Methods
fun entries(begin: RoutePoint, end: RoutePoint): List<MillisecondsRouteEntry>
Элементы, попадающие в отрезок [begin, end).
Parameters
fun findNearBackward(point: RoutePoint): MillisecondsRouteEntry?
Найти ближайший элемент, позиция которого
<
= point.<p>Сложность операции log2(N), где N = size.</p>
Parameters
fun findNearForward(point: RoutePoint): MillisecondsRouteEntry?
Найти ближайший элемент, позиция которого >= point.<p>Сложность операции log2(N), где N = size.</p>
Parameters
fun calculateDuration(routePoint: RoutePoint): Duration
Вычисляет ожидаемое время движения до конца маршрута.
Parameters
Properties
val size
Количество элементов.
val isEmpty
Элементы отсутсвуют.
val first
Первый элемент.
val last
Последний элемент.
val entries
Все элементы.
MillisecondsRouteEntry
Элемент маршрута - точка и значение в ней.
MillisecondsRouteEntry(point: RoutePoint, value: Duration)
Элемент маршрута - точка и значение в ней.
Parameters
Properties
Model
Модель навигатора, предназначенная для отображения в UI.
Extends: ru.dgis.sdk.NativeObject
Methods
fun betterRouteResponse(response: BetterRouteResponse): Unit
Ответ пользователя о применении предложенного маршрута лучше
Parameters
Properties
val stateChannel
Состояние навигатора.
val state
Состояние навигатора.
val locationChannel
Текущая геопозиция, с которой работает навигатор.<p>see location_available_channel</p>
val location
Текущая геопозиция, с которой работает навигатор.<p>see location_available_channel</p>
val locationAvailableChannel
Флаг, который указывает используется ли текущая геопозия для навигации.
После получения геопозиции навигатор решает пригодна ли она для того, чтобы использовать её для навигации
(например, если у геопозиции слишком большая погрешность, навигатор может решить, что она не пригодна для
навигации)
Если геопозиция пригодна для навигации, навигатор выставляет в этом канале значение true,
если не пригодна - false.<p>Даже если значение в данном канале равно false, в канале location_channel геопо зиция может обновляться.</p><p>see location_channel</p>
val locationAvailable
Флаг, который указывает используется ли текущая геопозия для навигации.
После получения геопозиции навигатор решает пригодна ли она для того, чтобы использовать её для навигации
(например, если у геопозиции слишком большая погрешность, навигатор может решить, что она не пригодна для
навигации)
Если геопозиция пригодна для навигации, навигатор выставляет в этом канале значение true,
если не пригодна - false.<p>Даже если значение в данном канале равно false, в канале location_channel геопозиция может обновляться.</p><p>see location_channel</p>
val routeChannel
Маршрут с манёврами.<p>В режиме свободной езды (StateChannel::FreeRoam) отсутствует маршрут по которому движется пользователь.
Поэтому участок дороги, по которой в данный момент движется пользователь,
навигатор представляет в виде маршрута и отдает его как текущий маршрут.
Такое описание дороги не является полноценным маршрутом, т.к. у него нет финиша и манёвров.</p>
val route
Маршрут с манёврами.<p>В режиме свободной езды (StateChannel::FreeRoam) отсутствует маршрут по которому движется пользователь.
Поэтому участок дороги, по которой в данный момент движется пользователь,
навигатор представляет в виде маршрута и отдает его как текущий маршрут.
Такое описание дороги не является полноценным маршрутом, т.к. у него нет финиша и манёвров.</p>
val dynamicRouteInfoChannel
Дорожные события и пробочные данные на маршруте
или на прогнозируемой части маршрута для режима FreeRoam.
val dynamicRouteInfo
Дорожные события и пробочные данные на маршруте
или на прогнозируемой части маршрута для режима FreeRoam.
val routePositionChannel
Текущая позиция пользователя на маршруте.
val routePosition
Текущая позиция пользователя на маршруте.
val exceedingMaxSpeedLimitChannel
Флаг превышения максимальной разрешенной скорости.
val exceedingMaxSpeedLimit
Флаг превышения максимальной разрешенной скорости.
val betterRouteChannel
Сигнал о нахождении альтернативного маршрута с меньшей ожидаемой длительностью движения.
Если значение в кана ле равно null, это значит, что альтернативный маршрут
не найден, либо перестал быть актуальным.
val betterRoute
Сигнал о нахождении альтернативного маршрута с меньшей ожидаемой длительностью движения.
Если значение в канале равно null, это значит, что альтернативный маршрут
не найден, либо перестал быть актуальным.
val duration
val isFreeRoam
MultiTouchShiftSettings
Настройки обработки сдвига при касании несколькими пальцами.
MultiTouchShiftSettings(thresholdMm: Float)
Настройки обработки сдвига при касании несколькими пальцами.
Parameters
thresholdMm
Properties
val thresholdMm
Порог сдвига взвешенного среднего точек постановки пальцев, в миллиметрах, по достижению которого начинают
генерироваться события смещения несколькими пальцами
MyLocationControl
Контрол перелёта к текущему местоположению пользователя.
Extends: ru.dgis.sdk.map.MapControl
MyLocationControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Контрол перелёта к текущему местоположению пользователя.
Parameters
MyLocationController
Класс, контролирующий отображение маркера текущего положения.
Extends: ru.dgis.sdk.NativeObject
MyLocationControlModel
Модель контрола перелета к местоположению пользователя.
Контрол состоит из кнопки, при нажатии на которую камера перелетает к местоположению пользователя.
Если местоположение не определено, ничего не происходит.
Методы объекта необходимо вызывать на одном потоке.
Extends: ru.dgis.sdk.NativeObject
MyLocationControlModel(map: Map, transitionType: TransitionType = TransitionType.SMOOTH)
Parameters
Methods
fun onClicked(): Unit
Returns
Properties
val isEnabledChannel
val isEnabled
val followStateChannel
val followState
MyLocationMapObject
Маркер геопозиции.
Extends: ru.dgis.sdk.map.MapObject
MyLocationMapObjectSource
Источник, содержащий маркер геопозиции.
Extends: ru.dgis.sdk.map.Source
MyLocationMapObjectSource(context: Context, directionBehaviour: MyLocationDirectionBehaviour)
Создать источник маркера геопозиции, использующий данные карты с плавным изменением.
Parameters
MyLocationMapObjectSource(
context: Context,
directionBehaviour: MyLocationDirectionBehaviour,
controller: MyLocationController
)
Создать источник маркера геопозиции.
Parameters
Methods
fun setDirectionBehaviour(directionBehaviour: MyLocationDirectionBehaviour): Unit
Выбрать поведение направления маркера.
Parameters
Properties
val item
Получить маркер геопозиции.
NativeException
Исключение, преобразованное из исключения, брошенного в нативном коде.
NativeObject
Базовый класс для объектов, представляющих собой обёртки над объектами в нативном коде.
Implements: java.lang.AutoCloseable
NativeProxy
Технический класс, инкапсулирующий в себе слабый указатель на объект в нативном коде.
Methods
fun finalize(): Unit
Returns
NavigationControl
Контейнер с контролами уровня зума и перелёта к текущему местоположению пользователя.
Extends: android.widget.LinearLayout
NavigationControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Контейнер с контролами уровня зума и перелёта к текущему местоположению пользователя.
Parameters
NavigationControl
Базовый класс для UI контролов навигатора.
Extends: android.widget.FrameLayout
NavigationControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Базовый класс для UI контролов навигатора.
Parameters
Methods
fun onAttachedToWindow(): Unit
Returns
fun onDetachedFromWindow(): Unit
Returns
fun detachFromManager(): Unit
Returns
Properties
NavigationFollowController
Интерфейс для управления слежением карты за маркером геопозиции в навигаторе.
Extends: ru.dgis.sdk.NativeObject
Methods
Properties
var followReturnDelay
Таймаут, через который карта автоматически вернется в режим слежения за маркером геопозиции после того,
как пользователь подвигал её.
0 - автоматический возврат в режим слежения за маркером геопозиции отключен.
NavigationManager
Корневой публичный интерфейс навигатора.
Extends: ru.dgis.sdk.NativeObject
NavigationManager(platformContext: Context)
Точка входа в API навигатора, используемая в SDK по умолчанию.
Parameters
platformContext
Methods
fun start(): Unit
Запускает ведение в режиме без маршрута (free roam).
В этом режиме маршрут отсутствует, а навигатор сообщает об объектах,
находящихся на дороге рядом с пользователем.
Returns
fun start(routeBuildOptions: RouteBuildOptions, trafficRoute: TrafficRoute? = null): Unit
Запускает ведение по маршруту.
Parameters
routeBuildOptions
Параметры, с которыми навигатор будет перестраивать маршрут.
trafficRoute
Маршрут, по которому запускается ведение.
Если значение не задано, то навигатор построит маршрут от текущей геопозиции.
Returns
fun startSimulation(routeBuildOptions: RouteBuildOptions, trafficRoute: TrafficRoute): Unit
Запускает симуляцию ведения по маршруту.
Parameters
routeBuildOptions
Параметры, с которыми навигатор будет перестраивать маршрут.
trafficRoute
Маршрут, по которому запускается симуляция.
Returns
Properties
val uiModel
Модель навигатора, предназначенная для отображения в UI.
val indoorDetector
Навигация внутри помещений.
val mapFollowController
Управление автоматическим возвратом карты к слежению за маркером геопозиции.
val mapManager
Менеджер карт навигатора.
val zoomFollowSettings
Настройки масштабирования карты во время режима ведения.
val routeMapSettings
Настройки отображения маршрута на карте.
val routeSourceSettings
Настройки источника, используемого для отображения маршрута на карте.
val simulationSettings
Настройки симуляции ведения по маршруту.
val voiceSelector
Управление голосовыми пакетами в текущей сессии навигатора.
val exceedSpeedLimitSettings
Настройки детектирования превышения скорости.
val dynamicRouteInfoSettings
Настройки получения и обновления динамических данных о маршруте.
val soundNotificationSettings
Настройки звуковых оповещений в текущей сессии навигатора.
val freeRoamSettings
Настройки ведения без маршрута в режиме free roam.
val alternativeRoutesProviderSettings
Настройки поиска альтернативных маршрутов в режиме ведения.
NavigationView
UI элемент, отображающий состояние навигации на карте.<p>Добавление его в MapView приводит к отображению на ней маршрута, маркера геопозиции,
транспортных событий, слежению за камерой.
Внутри NavigationView можно размещать навигационные контролы - наследники NavigationControl,
в частности готовый к использованию набор контролов DefaultNavigationControls.</p>
Extends: ru.dgis.sdk.map.MapControl
NavigationView(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
UI элемент, отображающий состояние навигации на карте.<p>Добавление его в MapView приводит к отображению на ней маршрута, маркера геопозиции,
транспортных событий, слежению за камерой.
Внутри NavigationView можно размещать навигационные контролы - наследники NavigationControl,
в частности готовый к использованию набор контролов DefaultNavigationControls.</p>
Parameters
Methods
Properties
NavigationVoice
Голос для использования в навигаторе.
Extends: ru.dgis.sdk.NativeObject
NewValuesNotifier
Интерфейс объекта, который сообщает о том, что есть изменения в каком-либо из параметров.
Extends: ru.dgis.sdk.NativeObject
Methods
fun sendNotification(): Unit
Необходимо вызывать для того, чтобы сообщить об обновлении параметров.
Returns