class
ActivityTracker
val stopChannel
Флаг, активное состояние которого указывает на то, что навигатор необходимо остановить. Если в состоянии Finished навигация прекращается, т.е. движение останавливается или его скорость становится ниже порогового значения, и если такое состояние сохраняется некоторое время, то устанавливается флаг устанавливается в true, в противном случае он имеет значение false.
val stop
Флаг, активное состояние которого указывает на то, что навигатор необходимо остановить. Если в состоянии Finished навигация прекращается, т.е. движение останавливается или его скорость становится ниже порогового значения, и если такое состояние сохраняется некоторое время, то устанавливается флаг устанавливается в true, в противном случае он имеет значение false.
AddEventResult
Результат добавления события (объект события или ошибка).
fun match(event: Function1, error: Function1): T
fun toString(): String
fun hashCode(): Int
Address
Адрес в виде набора отдельных компонентов.
Address(
drillDown: List<AddressAdmDiv>,
components: List<AddressComponent>,
buildingName: String?,
postCode: String?,
buildingCode: String?,
fiasCode: String?,
addressComment: String?
)
Адрес в виде набора отдельных компонентов.
drillDown
components
buildingName
postCode
buildingCode
fiasCode
addressComment
val drillDown
Набор объектов административного деления, в которых находится описываемый объект.
val components
Полный адрес объекта может содержать несколько отдельных адресных компонент.
val buildingName
Название здания.
val postCode
Почтовый индекс.
val buildingCode
Уникальный почтовый код здания.
val fiasCode
Код ФИАС объекта.
val addressComment
Комментарий к адресу. Пример: "301 офис; 9 этаж"
AddressAdmDiv
Объект административного деления.
AddressComponent
Компонент адреса: улица, номер дома или словесное описание местоположения.
fun match(
streetAddress: Function1,
number: Function1,
location: Function1
): T
fun toString(): String
fun hashCode(): Int
AddressLocation
Применяется для компонентов, которые тяжело описать конкретным адресом.
AddressLocation(comment: String)
Применяется для компонентов, которые тяжело описать конкретным адресом.
comment
AddressNumber
В некоторых населённых пунктах обозначается только номер дома, без улицы (например, Краснообск).
AddressStreet
Обычный адрес, есть улица и номер дома.
AddRoadEventButton
Кнопка добавления дорожного события.
AddRoadEventButton(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Кнопка добавления дорожного события.
fun attachToModel(model: AddRoadEventCardModel): Unit
AddRoadEventCard
Карточка добавления дорожного события.
AddRoadEventCard(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Карточка добавления дорожного события.
fun attachToModel(model: AddRoadEventCardModel): Unit
AddRoadEventCardModel
Модель карточки добавления дорожного события.
AddRoadEventCardModel(roadEventManager: RoadEventManager, map: Map)
Модель карточки добавления дорожного события.
fun onEventTypeClicked(type: RoadEventType): Unit
Действие при нажатии UI-элемента управления выбором типа события.
fun onLaneClicked(lane: Lane): Unit
Действие при нажатии UI-элемента управления выбором полосы.
fun onDescriptionEntered(description: String): Unit
Действие при вводе описания.
fun close(): Unit
val eventTypeChannel
Выбранный тип события.
val lanesChannel
Выбранные полосы.
val canSelectLanesChannel
Есть ли возможность задать полосы.
val descriptionChannel
Введенное описание.
val markerPositionChannel
Позиция маркера на экране.
val canSendChannel
Есть ли возможность отправить событие.
val resultChannel
Результат отправки события.
AddRoadEventControl
Базовый класс для UI-элементов добавления дорожных событий.
AddRoadEventControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Базовый класс для UI-элементов добавления дорожных событий.
fun attachToModel(model: AddRoadEventCardModel): Unit
@CallSuper
fun detachFromModel(): Unit
fun onAttachedToWindow(): Unit
fun onDetachedFromWindow(): Unit
AddRoadEventControls
Набор UI-элементов для добавления дорожных событий. Состоит из карточки с параметрами события, кнопки "Отправить" и маркера, указывающего место добавления события на карте.
val cardHeightChannel
Высота в пикселях, на которую раскрыта карточка.
AddRoadEventMarker
Маркер добавления дорожного события.
AddRoadEventMarker(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Маркер добавления дорожного события.
fun attachToModel(model: AddRoadEventCardModel): Unit
fun detachFromModel(): Unit
AlternativeRouteSelector
AlternativeRoutesProviderSettings
Настройки поиска альтернативных маршрутов и маршрута лучше.
var alternativeRoutesEnabled
Флаг включения/выключения предложения альтернативных маршрутов. По умолчанию предложение альтернативных маршрутов включено.
var betterRouteEnabled
Флаг включения/выключения предложения маршрута лучше. По умолчанию предложение маршрута лучше включено.
var routeSearchDelay
Задержка перед поиском альтернативных маршрутов при старте поездки по маршруту или после перехода на какой-либо другой маршрут. Должна быть не меньше 5 секунд. По умолчанию 20 секунд.
var betterRouteTimeCostThreshold
Минимальная разница во времени движения между исходным маршрутом и альтернативным маршрутом, при которой альтернативный маршрут считается маршрутом лучше.
var betterRouteLengthThreshold
Минимальная суммарная длина рёбер маршрута, которые отличаются между исходным маршрутом и альтернативным маршрутом, при которой альтернативный маршрут считается маршрутом лучше.
Anchor
Точка привязки изображения (0, 0) - левый верхний угол, (1, 1) - правый нижний
ApartmentRange
Диапазон квартир.
val start
Начало диапазона/хранимое значение. На текущий момент возможны только числовые значения, а квартиры с суффиксами в данных пока отсутствуют.
val end
Окончание диапазона. Если отсутствует, то диапазон состоит из одного значения start. Иначе это арифметическая прогрессия от start до end с шагом 1.
Attribute
Дополнительный атрибут. Пример: { tag: "hotel_room_internet", name: "Бесплатный интернет в номерах" }
Attributes
Интерфейс для управления свойствами объекта карты.
Свойства есть только у объектов карты, но можно задавать свойства по умолчанию для всей карты, для стиля и для источника (подробнее см. ISource).
fun setAttributeValue(name: String, value: AttributeValue): Unit
Установка свойства.
fun setAttributeValues(values: Map, attributesToRemove: List<String> = listOf()): Unit
Установка набора свойств.
values
Набор пар "имя":"значение" для добавляемых свойства.
attributesToRemove
Список имён свойств, которые нужно удалить.
fun removeAttribute(name: String): Unit
Удаление свойства.
fun getAttributeValue(name: String): AttributeValue
Получение свойства.
AttributeValue
Свойства объектов карты.
AttributeValue()
fun match(
empty: Function0<T>,
boolean: Function1,
number: Function1,
integer: Function1,
string: Function1,
data: Function1,
array: Function1,
item: Function1
): T
empty
boolean
number
integer
string
data
array
item
fun toString(): String
fun hashCode(): Int
AudioStreamReader
fun read(): List<Short>
Описание типа функции обратного вызова, которую вызывает аудиодрайвер для чтения потока аудиоданных.
буфер, в который записывается аудиопоток.
Описание формата данных аудиопотока: Кодировка: LPCM (https://en.wikipedia.org/wiki/Pulse-code_modulation). Количество фреймов в пакете: 1. Количество семплов в фрейме: 1. Формат сэмпла: знаковое целое. Размер сэмпла: 16 бит. Количество каналов: 1. Частота дискретизации (Sample rate): 22050 семплов в секунду.
AuthorInfo
Информация об авторе события или фотографии.
AuthorInfo(type: AuthorType, name: String)
Информация об авторе события или фотографии.
val type
Категория автора контента.
val name
Строка, содержащая имя пользователя, добавившего событие или фотографию.
- Имя пользователя в случае, если автор является авторизированным пользователем и согласился на отображение своего имени.
- Пустая строка для анонимного пользователя или пользователя, отказавшегося от отображения своего имени.
AvailableCallback
BaseCamera
Камера.
Задаёт параметры проецирования карты на экран.
fun changePosition(positionChange: CameraPositionChange): Unit
Изменение только части параметров позиции камеры.
Вызов прерывает перелёт и обработку жестов, а также сбрасывает слежение за изменёнными параметрами, а при изменении координат также и слежение за стилевым уровнем масштабирования и направлением.
val projection
Проекция.
Используется для получения точки экрана по точке карты и точки карты по точке экрана. Параметры камеры фиксируются в момент вызова.
val positionChannel
Получение текущей позиции камеры.
var position
Получение текущей позиции камеры.
val zoomRestrictionsChannel
Получение актуальных ограничений уровня масштабирования.
var zoomRestrictions
Получение актуальных ограничений уровня масштабирования.
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 maxTiltRestrictionChannel
Получение текущей функции зависимости максимального угла наклона камеры от стилевого уровня масштабирования.
var maxTiltRestriction
Получение текущей функции зависимости максимального угла наклона камеры от стилевого уровня масштабирования.
Bearing
Угол между направлением на один объект и на другой объект, либо между направлением на объект и север. Угол отсчитывается по часовой стрелке. Диапазон значений 0°,360°.
BearingFollowController
Контроллер слежения за направлением карты.
BearingFollowController(
bearingSource: BearingSource,
animationDuration: Duration = Duration.ofMilliseconds(1000),
valueThreshold: Bearing = Bearing(value = 1.0)
)
Создание контроллера слежения за направлением карты.
bearingSource
источник информации о направлении.
animationDuration
неотрицательная длительность изменения реального направления.
valueThreshold
неотрицательное пороговое значение учитываемого изменения реального направления.
BetterRouteInfo
Информация о доступном альтернативном маршруте.
BetterRoutePromptControl
Диалог, предлагающий перейти на ведение по маршруту с меньшим ожидаемым временем прибытия.
val visibilityChannel
BicycleBriefRouteInfo
Базовая информация о велосипедном маршруте.
BicycleBriefRouteInfo(length: RouteDistance, landmark: String)
Базовая информация о велосипедном маршруте.
BicycleInstructionCrossroad
Описание манёвров при проходе через перекрёсток или по пешеходному переходу.
BicycleInstructionCrossroad(landmark: BicycleInstructionCrossroadLandmark = BicycleInstructionCrossroadLandmark.NONE, maneuvers: List<BicycleInstructionCrossroadManeuver>)
Описание манёвров при проходе через перекрёсток или по пешеходному переходу.
BicycleInstructionCrossroadManeuver
BicycleInstructionCrossroadManeuver(direction: BicycleInstructionCrossroadManeuverDirection = BicycleInstructionCrossroadManeuverDirection.STRAIGHT, turnAngle: Int = 0)
BicycleInstructionFinish
Конец велосипедной части маршрута.
BicycleInstructionFinish()
Конец велосипедной части маршрута.
BicycleInstructionStart
Начало велосипедной части маршрута.
BicycleInstructionStart()
Начало велосипедной части маршрута.
BicycleRouteSearchOptions
Параметры поиска маршрута на велосипеде.
BicycleRouteSearchOptions(
avoidCarRoads: Boolean = false,
avoidStairways: Boolean = false,
avoidUnderpassesAndOverpasses: Boolean = false,
excludedAreas: List<ExcludedArea> = listOf()
)
Параметры поиска маршрута на велосипеде.
avoidCarRoads
avoidStairways
avoidUnderpassesAndOverpasses
excludedAreas
BoolRouteLongAttribute
Контейнер, который хранит протяженный атрибут маршрута. Каждый элемент хранится в виде пары, состоящей из точки и значения элемента атрибута. Действие атрибута начинается с данной точки и заканчивается в следущей точке, начиная с которой начинается действие атрибута следующего элемента.
fun entry(point: RoutePoint): BoolRouteLongEntry?
Элемент, в который попадает заданная точка.
fun entries(begin: RoutePoint, end: RoutePoint): List<BoolRouteLongEntry>
Элементы, частично или полностью покрываемые отрезком begin,end.
BoolRouteLongEntry
Протяженный элемент маршрута - отрезок и значение на нем.
BoolRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: Boolean
)
Протяженный элемент маршрута - отрезок и значение на нем.
Borders
Описывает набор непрерывного упорядоченных значений.
val snapping
Задаёт притяжку до значения, кратного этому числу.
val isLg
Признак использования логарифмической шкалы.
val value
Значение, по которым происходит фильтрация.
val min
Нижняя граница набора значений.
val max
Верхняя граница набора значений.
val currentMin
Текущее установленное минимальное значение.
val currentMax
Текущее установленное максимальное значение.
BriefExtraRouteInfo
Дополнительная информация о маршруте для конкретного типа транспорта.
BriefExtraRouteInfo(pedestrian: PedestrianBriefRouteInfo)
pedestrian
BriefExtraRouteInfo(publicTransport: PublicBriefRouteInfo)
publicTransport
fun match(
bicycle: Function1,
car: Function1,
pedestrian: Function1,
publicTransport: Function1,
scooter: Function1
): T
bicycle
car
pedestrian
publicTransport
scooter
fun toString(): String
fun hashCode(): Int
BriefPublicTransportCard
Краткая карточка, отображающая информацию о маршруте на общественном транспорте. В отличии от PublicTransportCard не содержит информацию о пересадках.
BriefPublicTransportCard(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Краткая карточка, отображающая информацию о маршруте на общественном транспорте. В отличии от PublicTransportCard не содержит информацию о пересадках.
fun onAttachedToWindow(): Unit
var model
BriefPublicTransportCardModel
Модель для BriefPublicTransportCard.
BriefPublicTransportCardModel(route: TrafficRoute, context: Context)
Модель для BriefPublicTransportCard.
val title
Заголовок. Предполагаемое время проезда, например, "1 ч 42 мин."
val transports
Информация о транспорте.
val description
Описание. Количество пересадок и время пешком, например, 1пересадка,Пешком15мин.
BriefRoadEvent
BriefRouteInfo
Базовая информация о маршруте.
BriefRouteInfo(duration: Duration, extraInfo: BriefExtraRouteInfo)
Базовая информация о маршруте.
BriefRouteInfoSearchPoints
Точки для запроса поиска базовой информации о маршруте.
BriefRouteInfoSearchPoints(startPoint: RouteSearchPoint, finishPoint: RouteSearchPoint)
Точки для запроса поиска базовой информации о маршруте.
BuildingId
Идентификатор здания.
BuildingInfo
Информация о здании.
BuildingInfo(
buildingName: String? = null,
purposeName: String? = null,
purposeCode: PurposeCode? = null,
buildingLevels: BuildingLevels? = null
)
Информация о здании.
BuildingLevels
Информация об этажных планах здания.
BuildingLevels(defaultLevelId: LevelId, levels: List<LevelInfo>)
Информация об этажных планах здания.
CalloutMapPosition
Положение бабла маршрута.
CalloutMapPosition(
mapId: MapId,
calloutPosition: GeoPoint?,
routePoint: RoutePoint?
)
Положение бабла маршрута.
Camera
Камера для запуска перемещения карты и настроек слежения.
fun move(moveController: CameraMoveController): Future<CameraAnimatedMoveResult>
Запуск перемещения карты.
Сбрасывает текущий режим слежения карты и прерывает обработку жестов.
moveController
Контроллер анимированного перемещения камеры.
fun move(
position: CameraPosition,
time: Duration = Duration.ofMilliseconds(300),
animationType: CameraAnimationType = CameraAnimationType.DEFAULT
): Future<CameraAnimatedMoveResult>
Запуск анимированного перемещения карты с использованием встроенного контроллера перемещений карты.
Сбрасывает слежение за позицией, уровнем масштабирования, наклоном и направлением и прерывает обработку жестов.
position
Конечная позиция камеры.
time
Время, выделенное на перемещение карты.
animationType
Тип анимации при перемещении камеры.
fun move(
point: GeoPoint,
zoom: Zoom,
tilt: Tilt?,
bearing: Bearing,
time: Duration = Duration.ofMilliseconds(300),
animationType: CameraAnimationType = CameraAnimationType.DEFAULT
): Future<CameraAnimatedMoveResult>
Запуск анимированного перемещения карты с использованием встроенного контроллера перемещений карты.
Сбрасывает слежение за позицией, уровнем масштабирования и направлением и прерывает обработку жестов.
Если tilt задан, то сбрасывается слежение за наклоном.
Если tilt не задан и слежения за наклоном нет, то используется текущее значение наклона.
point
точка конечной позиции камеры
zoom
уровень масштабирования в конечной позиции камеры
tilt
наклон в конечной позиции камеры или пустое значение, если нужно в зависимости от активного режима слежения использовать значение из follow controller'а или текущее значение
bearing
поворот в конечной позиции камеры
time
время, выделенное на перемещение карты
animationType
тип анимации при перемещении камеры
fun processMovementAndStop(): Unit
Установка позиции камеры в соответствие с текущим временем и прекращение анимированного перемещения.
Вызов прерывает перелёт и обработку жестов, а также сбрасывает слежение за позицией, уровнем масштабирования и направлением.
fun setBehaviour(behaviour: CameraBehaviour): Unit
Смена режима слежения камеры. Если новый режим более ограниченный, чем текущий, вызов прервёт перелёт и обработку жестов.
fun addFollowController(followController: FollowController): Unit
Добавление контроллера слежения.
Их может быть несколько разных, например контроллер слежения за масштабом, за углом наклона карты, за геолокацией и т.д.
fun removeFollowController(followController: FollowController): Unit
Удаление контроллера слежения.
fun setCustomFollowController(followController: CustomFollowController): Unit
Добавление контроллера слежения, реализованного на платформе.
Можно установить только один такой контроллер. Если установить несколько контроллеров, то будет использоваться только последний установленный.
fun removeCustomFollowController(): Unit
Удаление контроллера слежения, реализованного на платформе.
CameraBehaviour
Режим слежения камеры.
Режимы камеры деградируются по следующим правилам:
- смещение карты сбрасывает слежение за позицией (включая слежение за направлением и стилевым уровнем масштабирования) события: DirectMapShiftEvent, MapShiftBeginEvent, DirectMapRotationEvent с указанием центра события, DirectMapScalingEvent с указанием центра события, ScaleMapEvent с указанием центра события
- поворот карты относительно точки позиции отбрасывает Bearing события: MapRotationBeginEvent, RotateMapToNorthEvent, DirectMapRotationEvent без центра события
- изменение масштаба относительно точки позиции отбрасывает StyleZoom события: MapScalingBeginEvent, DirectMapScalingEvent без центра события, ScaleMapEvent без центра события
- наклон отбрасывает Tilt события: DirectMapTiltEvent
CameraBehaviour(position: FollowPosition?, tilt: FollowTilt = FollowTilt.OFF)
Режим слежения камеры.
Режимы камеры деградируются по следующим правилам:
- смещение карты сбрасывает слежение за позицией (включая слежение за направлением и стилевым уровнем масштабирования) события: DirectMapShiftEvent, MapShiftBeginEvent, DirectMapRotationEvent с указанием центра события, DirectMapScalingEvent с указанием центра события, ScaleMapEvent с указанием центра события
- поворот карты относительно точки позиции отбрасывает Bearing события: MapRotationBeginEvent, RotateMapToNorthEvent, DirectMapRotationEvent без центра события
- изменение масштаба относительно точки позиции отбрасывает StyleZoom события: MapScalingBeginEvent, DirectMapScalingEvent без центра события, ScaleMapEvent без центра события
- наклон отбрасывает Tilt события: DirectMapTiltEvent
CameraBehaviourChange
Изменение режима слежения.
CameraBehaviourChange(newBehaviour: CameraBehaviour, changeReason: CameraBehaviourChangeReason)
Изменение режима слежения.
CameraNotifier
Предупреждает о попадании в зону действия дорожной камеры.
CameraPosition
Позиция камеры.
val point
Точка местности, которая находится в точке позиции камеры (см. ICamera::position_point()).
val zoom
Уровень масштабирования. 0 - это весь мир, вписанный в квадрат 256x256 логических пикселей (см. LogicalPixel)
val tilt
Угол наклона направления взгляда по вертикали.
0 - надир (смотрим вертикально вниз), максимальное значение - 60 градусов.
val bearing
Угол поворота направления взгляда по горизонтали относительно направления на север. Отсчитывается по часовой стрелке, в градусах.
CameraPositionChange
Описание изменения части параметров позиции камеры.
CameraPositionPoint
Относительная экранная позиция точки, к которой привязана камера.
Область экрана задаётся padding'ами. x - отступ от левого края области экрана, y - отступ от верхнего края Допустимый интервал значений отступов (0.0f, 1.0f) 0,0 - левый верхний угол области экрана, 1,1 - правый нижний
CameraPositionPoint(x: Float = 0.5f, y: Float = 0.5f)
Относительная экранная позиция точки, к которой привязана камера.
Область экрана задаётся padding'ами. x - отступ от левого края области экрана, y - отступ от верхнего края Допустимый интервал значений отступов (0.0f, 1.0f) 0,0 - левый верхний угол области экрана, 1,1 - правый нижний
CameraProgressInfo
Информация о прогрессе прохождения зоны камеры.
CameraRouteAttribute
Контейнер, который описывает точечный атрибут маршрута. Каждый элемент хранится в виде точки на маршруте, в которой этот элемент расположен и значения самого элемента.
fun entries(begin: RoutePoint, end: RoutePoint): List<CameraRouteEntry>
Элементы, попадающие в отрезок [begin, end).
fun findNearBackward(point: RoutePoint): CameraRouteEntry?
Найти ближайший элемент, позиция которого < = point.
Сложность операции log2(N), где N = size.
fun findNearForward(point: RoutePoint): CameraRouteEntry?
Найти ближайший элемент, позиция которого >= point.
Сложность операции log2(N), где N = size.
CameraRouteEntry
Элемент маршрута - точка и значение в ней.
CameraRouteEntry(point: RoutePoint, value: RouteCamera)
Элемент маршрута - точка и значение в ней.
CameraZoomRestrictions
Допустимый диапазон изменения уровня масштабирования.
CancelEvent
Событие отмены текущего действия.
Вызывается, например, при отмене жеста, потере фокуса окна или при потере захвата мыши. Также может быть вызван изнутри карты при смене ограничений уровня масштабирования, некоторых изменениях режима слежения и установке интерактивного режима карты.
CancelEvent()
CarBriefRouteInfo
Базовая информация об автомобильном маршруте.
CarBriefRouteInfo(
length: RouteDistance,
landmark: String,
trafficSpeed: CarBriefRouteInfoTrafficSpeed
)
Базовая информация об автомобильном маршруте.
CarInstructionCrossroad
Описание манёвров на перекрёстке.
CarInstructionCrossroad(
direction: CarInstructionCrossroadDirection = CarInstructionCrossroadDirection.STRAIGHT,
turnAngle: Int = 0,
landmark: CarInstructionCrossroadLandmark = CarInstructionCrossroadLandmark.NONE,
exitName: String
)
Описание манёвров на перекрёстке.
direction
turnAngle
landmark
exitName
CarInstructionFinish
Конец автомобильной части маршрута.
CarInstructionFinish()
Конец автомобильной части маршрута.
CarInstructionRoundabout
Описание манёвров на перекрёстке с круговым движением.
CarInstructionRoundabout(
type: CarInstructionRoundaboutType = CarInstructionRoundaboutType.ENTRY,
turnAngle: Int = 0,
exitNumber: Int = 0,
exitName: String
)
Описание манёвров на перекрёстке с круговым движением.
CarInstructionStart
Начало автомобильной части маршрута.
CarInstructionStart()
Начало автомобильной части маршрута.
CarInstructionUTurn
Разворот на дороге (не на перекрёстке).
Разворот на перекрестке описывается инструкцией Crossroad.
CarInstructionUTurn(exitName: String)
Разворот на дороге (не на перекрёстке).
Разворот на перекрестке описывается инструкцией Crossroad.
exitName
CarRouteSearchOptions
Параметры поиска маршрута на легковом автомобиле.
CarRouteSearchOptions(
avoidTollRoads: Boolean = false,
avoidUnpavedRoads: Boolean = false,
avoidFerries: Boolean = true,
avoidLockedRoads: Boolean = true,
routeSearchType: RouteSearchType = RouteSearchType.JAM,
excludedAreas: List<ExcludedArea> = listOf()
)
Параметры поиска маршрута на легковом автомобиле.
avoidTollRoads
avoidUnpavedRoads
avoidFerries
avoidLockedRoads
routeSearchType
excludedAreas
val avoidTollRoads
Избегать платных дорог.
val avoidUnpavedRoads
Избегать грунтовых дорог.
val avoidFerries
Избегать паромных переправ.
val avoidLockedRoads
Избегать закрытых для проезда дорог. При значении true поиск маршрута не будет учитывать перекрытые для проезда участки дорог. При значении false маршрут может быть проложен через перекрытые для проезда участки дорог, если невозможно построить маршрут без проезда через перекрытые участки.
val routeSearchType
Тип поиска маршрута.
val excludedAreas
Исключаемые области (не больше 25).
Certificate
SSL-сертификат.
fun match(
system: Function1,
fromFile: Function1,
fromAsset: Function1
): T
system
fromFile
fromAsset
fun toString(): String
fun hashCode(): Int
CertificateFromAsset
SSL-сертификат из Android asset-а.
CertificateFromFile
SSL-сертификат из файла.
CheckableGroupedItem
Единичный элемент из GroupCheckableItem.
CheckableItem
Базовое представление отмечаемого элемента из CheckableItemsGroup.
CheckableItemsGroup
Виджет для представления группы отмечаемых элементов.
val items
Получение группы элементов виджета.
Checkbox
Виджет-чекбокс.
val filterType
Получение типа фильтра, который представляет виджет.
val checkedText
Получение текста подписи для "отмеченного" чекбокса.
val uncheckedText
Получение текста подписи для "неотмеченного" чекбокса.
val values
Получение списка значений, по которым происходит фильтрация. Обычно одно значение.
var isChecked
Получение состояния виджета.
Circle
Окружность.
CircleOptions
Параметры для создания геометрического объекта карты типа "Окружность".
CircleOptions(
position: GeoPoint,
radius: Meter,
color: Color = Color(),
strokeWidth: LogicalPixel = LogicalPixel(value = 0.0f),
strokeColor: Color = Color(),
dashedStrokeOptions: DashedStrokeCircleOptions? = null,
visible: Boolean = true,
userData: Any? = null,
zIndex: ZIndex = ZIndex(value = 0),
levelId: LevelId? = null
)
Параметры для создания геометрического объекта карты типа "Окружность".
position
radius
color
strokeWidth
strokeColor
dashedStrokeOptions
visible
userData
zIndex
levelId
val position
Географическая позиция.
val radius
Радиус в метрах.
val color
Цвет заливки.
val strokeWidth
Ширина линии границы окружности.
val strokeColor
Цвет линии границы окружности.
val dashedStrokeOptions
Параметры пунктирной границы.
val visible
Флаг видимости.
val userData
Пользовательские данные (не используются внутри SDK, нужны только для пользователя API).
val zIndex
Уровень отрисовки объекта.
val levelId
Привязка к поэтажному плану здания.
ClusterObject
Кластер объектов.
ClusterOptions
Параметры маркера кластера.
Color
Цвет
CompassControl
CompassControl
UI-элемент управления компасом.
CompassControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0,
layout: Int = R.layout.dgis_compass_control
)
UI-элемент управления компасом.
CompassControlModel
Модель контрола компаса. Контрол состоит из кнопки компаса, при нажатии на которую камера карты меняет угол в направлении севера. Если камера карты смотрит на сервер, то контрол необходимо скрывать. Потокобезопасно.
fun onClicked(): Unit
ComplexGeometry
Составная геометрия, состоит из набора простых или составных геометрий.
Поддерживается произвольный уровень вложенности составных геометрий в наборе.
val elements
ContactInfo
Способ связаться с организацией.
val type
Тип контакта. Один из следующих:
- email — электронная почта
- website — сайт
- phone — телефон
- fax — факс
- pobox — абонентский ящик
- icq
- jabber
- skype
- vkontakte
- odnoklassniki
- youtube
- googleplus
- viber
- telegram
val displayText
Значение контакта для вывода на экран.
val value
Техническое значение контакта. В зависимости от типа контакта имеет следующую семантику:
- email — адрес почты
- website — полный url
- phone — номер телефона в международном формате, например: "+73831234567"
- fax — номер телефона в международном формате, например: "+73831234567"
- pobox — адрес почтового ящика
- icq — идентификатор пользователя
- jabber — идентификатор пользователя
- skype — идентификатор пользователя
- vkontakte — полный url
- twitter — полный url
- odnoklassniki — полный url
- youtube — полный url
- linkedin — полный url
- googleplus — полный url
- pinterest — полный url
- whatsapp — полный url
- viber — полный url
- telegram — полный url
val comment
Уточняющая информация о контакте.
Context
Контекст - окружение, необходимое для работы SDK.
CoordinatesFollowController
Контроллер слежения за координатами позиции карты.
CoordinatesFollowController(animationDuration: Duration = Duration.ofMilliseconds(1000), valueThreshold: Meter = Meter(value = 0.1f))
Создание контроллера слежения за координатами позиции карты.
CustomDashboardButton
Класс содержит поля необходимые для замены стандартной кнопки добавления дорожных событий в дашборде навигатора.
CustomizableDashboardButton
DashboardButtonAbsent
Используется в DefaultNavigationControls.setCustomDashboardButton для обозначения того, что кнопку действия необходимо скрыть.
DashboardControl
DashedPolylineOptions
Параметры пунктирной полилинии.
DashedPolylineOptions(dashLength: LogicalPixel = LogicalPixel(value = 5.0f), dashSpaceLength: LogicalPixel = LogicalPixel(value = 2.0f))
Параметры пунктирной полилинии.
DashedStrokeCircleOptions
DashedStrokeCircleOptions(dashLength: LogicalPixel = LogicalPixel(value = 5.0f), dashSpaceLength: LogicalPixel = LogicalPixel(value = 2.0f))
DayTime
Момент времени внутри дня.
DefaultLocationSource
Реализация источника геопозиции, которую рекомендуется использовать по умолчанию. При наличии GMS использует их, иначе - LocationManager.
DefaultLocationSource(context: Context)
Реализация источника геопозиции, которую рекомендуется использовать по умолчанию. При наличии GMS использует их, иначе - LocationManager.
context
@Synchronized
fun activate(listener: LocationChangeListener): Unit
@Synchronized
fun deactivate(): Unit
@Synchronized
fun setDesiredAccuracy(accuracy: DesiredAccuracy): Unit
fun onPermissionGranted(): Unit
Метод необходимо вызвать после получения разрешений на использование геопозиции.
@Synchronized
fun onProvidersChanged(): Unit
val lastLocation
Наилучшая известная на текущий момент геопозиция. Если известная на текущий момент геопозиция отсутствует, возвращается null. Возвращаемая геопозиция может быть недостоверной, например являться устаревшей и/или не соответствовать требуемой точности
var isGMSAllowed
Использовать ли GMS.
DefaultNavigationControls
UI контролы навигатора, предлагаемые к использованию по умолчанию: полосность, ограничение скорости, обозначение следующего манёвра и т.д. Пользователи SDK также могут создать свои собственные UI контролы и использовать UI модель навигатора для получения оповещений о событиях при ведении по маршруту.
DeviceDensity
Множитель, который вычисляется как отношение DPI к базовому DPI устройства.
В Android соответствует resources.displayMetrics.density В iOS соответствует nativeScale
должен быть положительным.
DeviceDensity(value: Float = 0.0f)
Множитель, который вычисляется как отношение DPI к базовому DPI устройства.
В Android соответствует resources.displayMetrics.density В iOS соответствует nativeScale
должен быть положительным.
value
DevicePpi
Разрешающая способность дисплея устройства, в пикселях на дюйм.
должна быть положительной.
DevicePpi(value: Float = 0.0f)
Разрешающая способность дисплея устройства, в пикселях на дюйм.
должна быть положительной.
value
DGis
Точка входа в 2GIS SDK. На старте работы необходимо вызвать initialize.
@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,
platformHttpClient: HttpClient? = null,
mapOptions: GlobalMapOptions = GlobalMapOptions()
): Context
Необходимо вызвать этот метод до начала работы с SDK.
appContext
контекст android приложения.
httpOptions
настройки сетевого клиента.
logOptions
параметры логирования.
vendorConfig
переопределение конфигурации SDK.
keySource
источник ключа.
dataCollectConsent
согласие на сбор данных и обработку данных
platformHttpClient
сетевой клиент, который будет использоваться вместо стандартного.
mapOptions
настройки, применяемые ко всем картам.
sdkContext необходимый для работы сервисов SDK.
@JvmStatic
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,
platformHttpClient: HttpClient? = null,
platformAudioDriver: AudioDriver? = null,
mapOptions: GlobalMapOptions = GlobalMapOptions()
): Context
Необходимо вызвать этот метод до начала работы с SDK.
appContext
контекст android приложения.
httpOptions
настройки сетевого клиента.
logOptions
параметры логирования.
vendorConfig
переопределение конфигурации SDK.
keySource
источник ключа.
dataCollectConsent
согласие на сбор данных и обработку данных
platformHttpClient
сетевой клиент, который будет использоваться вместо стандартного.
platformAudioDriver
платформенный аудиодрайвер.
mapOptions
настройки, применяемые ко всем картам.
sdkContext необходимый для работы сервисов SDK.
@JvmStatic
fun context(): Context
DgisMapObject
Объект карты 2GIS.
информацию об объекте можно получить через справочник (directory)
val id
Стабильный числовой идентификатор объекта.
DgisObjectId
DgisSource
Основной интерфейс источников данных 2ГИС.
fun setHighlighted(directoryObjectIds: List<DgisObjectId>, highlighted: Boolean): Unit
Установка или снятие выделения объектов.
добавляет объекту атрибут "selected", который можно использовать в стилях.
directoryObjectIds
Идентификаторы изменяемых объектов.
highlighted
Установка или снятие выделения.
@JvmStatic
fun createDgisSource(context: Context, workingMode: DgisSourceWorkingMode = DgisSourceWorkingMode.ONLINE): Source
Создание источника, получающего данные с серверов 2ГИС или использующего в работе предварительно загруженные данные.
DirectMapControlBeginEvent
Событие начала прямого управления картой. Сообщает карте, что необходимо обрабатывать события прямого управления картой. События прямого управления работают только от DirectMapControlBeginEvent до DirectMapControlEndEvent. После завершения последовательности событий прямого управления может запуститься кинематика. Кинематика использует время возникновения события, поэтому лучше использовать время, полученное от системы, а не заполнять значение при обработке. Пока кинематика работает только для перемещения карты, но не для вращения и масштабирования.
DirectMapControlBeginEvent()
DirectMapControlEndEvent
Событие окончания прямого управления картой. Завершает прямое управление картой, начатое после получения события DirectMapControlBeginEvent. О событиях прямого управления картой описано в DirectMapControlBeginEvent.
DirectMapRotationEvent
Событие прямого вращения карты. О событиях прямого управления картой описано в DirectMapControlBeginEvent.
DirectMapRotationEvent(
bearingDelta: Bearing,
timestamp: Duration,
rotationCenter: ScreenPoint? = null
)
bearingDelta
изменение угла поворота карты, в градусах. Положительные значения соответствуют направлению вращения против часовой стрелки
timestamp
Время генерации системного события.
rotationCenter
Точка на экране, вокруг которой вращается карта. Если точка не задана, то вращение происходит относительно точки позиции карты.
DirectMapScalingEvent
Событие прямого масштабирования карты. События прямого управления картой описаны в DirectMapControlBeginEvent.
DirectMapScalingEvent(
zoomDelta: Float,
timestamp: Duration,
scalingCenter: ScreenPoint? = null
)
zoomDelta
Величина, на которую изменится текущее значение масштаба.
timestamp
Время генерации системного события.
scalingCenter
Точка на экране, относительно которой масштабируется карта. Если точка не задана, то масштабирование происходит относительно точки позиции карты.
DirectMapShiftEvent
Событие прямого сдвига карты. События прямого управления картой описаны в DirectMapControlBeginEvent.
DirectMapShiftEvent(
screenShift: ScreenShift,
shiftedPoint: ScreenPoint,
timestamp: Duration
)
screenShift
Изменение экранной позиции карты относительно предыдущей, в пикселях.
shiftedPoint
Центральная точка, от которой производится смещение карты.
timestamp
Время генерации системного события.
DirectMapTiltEvent
Событие прямого наклона камеры. События прямого управления картой описаны в DirectMapControlBeginEvent.
DirectoryFilter
Фильтры для справочника.
DirectoryFilter(workTime: WorkTimeFilter?, dynamic: List<DynamicFilter>)
Фильтры для справочника.
DirectoryObject
Объект справочника.
fun formattedAddress(type: FormattingType): FormattedAddress?
Cтроковое представление адреса, отформатированное в соответствии с указанным требованием к длине.
val types
Тип объекта. Может быть несколько, например, ТЦ Сан Сити - филиал организации и здание одновременно. Первый тип в этом списке - основной.
val title
Заголовок объекта.
val titleAddition
Дополнительная информация заголовка Пример: "(кв. 1-12)"
val subtitle
Подзаголовок объекта.
при отсутствии может быть пустой строкой
val description
Описание объекта.
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
Данные о лицензии организации.
val buildingInfo
Информация о здании.
DoubleRouteAttribute
Контейнер, который описывает точечный атрибут маршрута. Каждый элемент хранится в виде точки на маршруте, в которой этот элемент расположен и значения самого элемента.
fun entries(begin: RoutePoint, end: RoutePoint): List<DoubleRouteEntry>
Элементы, попадающие в отрезок [begin, end).
fun findNearBackward(point: RoutePoint): DoubleRouteEntry?
Найти ближайший элемент, позиция которого < = point.
Сложность операции log2(N), где N = size.
fun findNearForward(point: RoutePoint): DoubleRouteEntry?
Найти ближайший элемент, позиция которого >= point.
Сложность операции log2(N), где N = size.
DoubleRouteEntry
Элемент маршрута - точка и значение в ней.
DoubleRouteEntry(point: RoutePoint, value: Double)
Элемент маршрута - точка и значение в ней.
DragBeginData
Данные о начале перетаскивания: точка старта перемещения и перемещаемый объект.
DragBeginData(point: ScreenPoint, item: RenderedObject)
Данные о начале перетаскивания: точка старта перемещения и перемещаемый объект.
Duration
Класс, представляющий период времени.
operator fun unaryMinus(): Duration
fun toString(): String
DynamicFilter
Динамические фильтры поисковой выдачи.
fun match(
flagFilter: Function1,
rangeFilter: Function1,
sortingFilter: Function1
): T
fun toString(): String
fun hashCode(): Int
DynamicRouteInfo
DynamicRouteInfoSettings
Настройки получения динамических данных о маршруте.
Elevation
Неотрицательная высота точки над поверхностью в метрах.
Elevation(value: Float = 0.0f)
Неотрицательная высота точки над поверхностью в метрах.
value
EmptyFollowController
Базовый класс для пользовательских контроллеров. Можно использовать как основу для реализации контроллера на платформе.
EmptyFollowController()
Базовый класс для пользовательских контроллеров. Можно использовать как основу для реализации контроллера на платформе.
fun availableValues(): EnumSet<FollowValue>
Набор видов значений, которыми умеет управлять данный контроллер.
fun requestValues(values: EnumSet<FollowValue>): Unit
С помощью этого метода в контроллер сообщается, какие из предоставляемых им значений используются. Это позволяет освободить ресурсы, связанные с вычислением неиспользуемых значений. Метод может вызываться многократно с разными значениями, в этом случае актуальным является последнее из них.
fun setNewValuesNotifier(notifier: NewValuesNotifier?): Unit
Установка нотифаера, который оповещает о новых значениях. Нотифаер нужно сохранить в реализуемом контроллере
fun coordinates(): GeoPoint?
Географические координаты. Метод вызывается только после вызова request_values с соответствующими параметрами.
fun bearing(): Bearing?
Направление. Метод вызывается только после вызова request_values с соответствующими параметрами.
fun tilt(): Tilt?
Наклон карты. Метод вызывается только после вызова request_values с соответствующими параметрами.
fun styleZoom(): StyleZoom?
Стилевой уровень масштабирования карты. Метод вызывается только после вызова request_values с соответствующими параметрами.
EntranceGeometry
Геометрии для отображения входа на карте.
EntranceGeometry(entrancePoints: List<GeoPoint>, entrancePolylines: List<List<GeoPoint>>)
Геометрии для отображения входа на карте.
EntranceInfo
Информация о входе в здание.
EntranceInfo(
id: DgisObjectId,
buildingNumber: String?,
porchName: String?,
porchNumber: String?,
apartmentRanges: List<ApartmentRange>,
geometry: EntranceGeometry?
)
Информация о входе в здание.
id
buildingNumber
porchName
porchNumber
apartmentRanges
geometry
val id
Идентификатор объекта входа.
val buildingNumber
Номер дома, к которому относится вход.
val porchName
Непустое имя подъезда. Заполняется только для подъездов. Может принимать значения имени подъезда (например "Подъезд 1") или номера здания, если подъезд имеет собственный адрес.
val porchNumber
Непустой номер подъезда. Заполняется только для подъездов. Может принимать значения номера подъезда (например "1") или номера здания, если подъезд имеет собственный адрес.
val apartmentRanges
Номера квартир, относящихся к подъезду.
val geometry
Геометрии для отображения входа на карте.
Event
Базовый класс для всех обрабатываемых событий.
EventsProcessingSettings
EventsProcessingSettings(rotationCenter: RotationCenter, scalingCenter: ScalingCenter)
ExceedSpeedLimitSettings
Настройки обнаружения превышения максимальной разрешённой скорости.
ExcludedArea
Исключаемая область, которую следует избегать при построении маршрута.
ExcludedArea(
type: ExcludedAreaType = ExcludedAreaType.POINT,
severity: ExcludedAreaSeverity = ExcludedAreaSeverity.SOFT,
extent: RouteDistance,
points: List<GeoPoint>
)
Исключаемая область, которую следует избегать при построении маршрута.
ExtraInstructionInfo
ExtraInstructionInfo(bicycleStart: BicycleInstructionStart)
bicycleStart
ExtraInstructionInfo(bicycleFinish: BicycleInstructionFinish)
bicycleFinish
ExtraInstructionInfo(bicycleCrossroad: BicycleInstructionCrossroad)
bicycleCrossroad
ExtraInstructionInfo(carCrossroad: CarInstructionCrossroad)
carCrossroad
ExtraInstructionInfo(carRoundabout: CarInstructionRoundabout)
carRoundabout
ExtraInstructionInfo(pedestrianStart: PedestrianInstructionStart)
pedestrianStart
ExtraInstructionInfo(pedestrianFinish: PedestrianInstructionFinish)
pedestrianFinish
ExtraInstructionInfo(pedestrianCrossroad: PedestrianInstructionCrossroad)
pedestrianCrossroad
ExtraInstructionInfo(pedestrianIndoorFloorChange: PedestrianInstructionIndoorFloorChange)
pedestrianIndoorFloorChange
ExtraInstructionInfo(pedestrianIndoorEnter: PedestrianInstructionIndoorEnter)
pedestrianIndoorEnter
ExtraInstructionInfo(pedestrianIndoorExit: PedestrianInstructionIndoorExit)
pedestrianIndoorExit
ExtraInstructionInfo(scooterStart: ScooterInstructionStart)
scooterStart
ExtraInstructionInfo(scooterFinish: ScooterInstructionFinish)
scooterFinish
ExtraInstructionInfo(scooterCrossroad: ScooterInstructionCrossroad)
scooterCrossroad
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
bicycleStart
bicycleFinish
bicycleCrossroad
carStart
carFinish
carCrossroad
carRoundabout
carUturn
pedestrianStart
pedestrianFinish
pedestrianCrossroad
pedestrianIndoorFloorChange
pedestrianIndoorEnter
pedestrianIndoorExit
scooterStart
scooterFinish
scooterCrossroad
fun toString(): String
fun hashCode(): Int
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
Идентификатор файла.
Может являться не только файлом на файловой системе, но и произвольным источником данных.
@JvmStatic
fun fromString(contents: String): File
Файл с содержимым из заданной строки.
FinishRouteControl
FlagFilter
Фильтр - флаг.
FloatRouteLongAttribute
Контейнер, который хранит протяженный атрибут маршрута. Каждый элемент хранится в виде пары, состоящей из точки и значения элемента атрибута. Действие атрибута начинается с данной точки и заканчивается в следущей точке, начиная с которой начинается действие атрибута следующего элемента.
fun entry(point: RoutePoint): FloatRouteLongEntry?
Элемент, в который попадает заданная точка.
fun entries(begin: RoutePoint, end: RoutePoint): List<FloatRouteLongEntry>
Элементы, частично или полностью покрываемые отрезком begin,end.
FloatRouteLongEntry
Протяженный элемент маршрута - отрезок и значение на нем.
FloatRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: Float
)
Протяженный элемент маршрута - отрезок и значение на нем.
FloorInfo
Информация об этажном плане для маркера - элемента поисковой выдачи.
FloorInfo(levelId: LevelId, buildingId: BuildingId)
Информация об этажном плане для маркера - элемента поисковой выдачи.
FollowControl
UI-элемент управления слежением за маркером местоположения.
FollowController
Класс, позволяющий управлять положением камеры. Реализации всех его методов должны быть потокобезопасны. У большинства методов есть тривиальные реализации по умолчанию (таким образом FollowController, отвечающий за масштаб, не обязан переопределять методы coordinates() и т.п.). Один контроллер может быть единомоментно добавлен только в одну карту.
FollowPosition
Настройки слежения за позицией.
FollowPosition(bearing: FollowBearing = FollowBearing.OFF, styleZoom: FollowStyleZoom = FollowStyleZoom.OFF)
Настройки слежения за позицией.
FormattedAddress
Человекочитаемое представление адреса.
val drilldownAddress
Адрес из дриллдауна. Пример: "Новосибирск, Кировский район".
val streetAddress
Адрес внутри населённого пункта. Пример: "Николаева, 11".
val addressComment
Комментарий к адресу. Пример: "301 офис; 9 этаж".
val postCode
Почтовый индекс объекта с кодом здания, если есть. Пример: "630088", "630007/XBVJF8".
Fps
Frames per second, частота кадров.
FreeRoamSettings
var onRoutePrefetchLength
Тайлы дорожного графа загружаются в http-кэш во время ведения по маршруту, если они соответствуют участку маршрута от текущей позиции до указанного расстояния. Значение по умолчанию - 5 км.
Загрузка тайлов в http-кэш не выполняется, если параметр соответствует нулевому или отрицательному расстоянию.
var onRoutePrefetchRadiusMeters
При кэшировании тайлов дорожного графа во время ведения по маршруту тайлы загружаются в http-кэш, если оказываются ближе заданного расстояния в метрах от линии маршрута. Значение по умолчанию - 1 км.
Загрузка тайлов в http-кэш не выполняется, если параметр соответствует нулевому или отрицательному расстоянию.
var prefetchRadiusMeters
Тайлы дорожного графа загружаются в http-кэш если оказываются ближе заданного расстояния в метрах от текущей позиции. Значение по умолчанию - 2 км.
Загрузка тайлов в http-кэш не выполняется, если параметр соответствует нулевому или отрицательному расстоянию.
Geometry
Объект геометрии.
fun intersects(geometry: Geometry): Boolean
Функция intersects позволяет определить, имеет ли данная геометрия пересечение с другим объектом геометрии
GeometryMapObject
Геометрический объект карты.
методы потокобезопасны
объект будет отображаться на карте при выполнении следующих условий:
- объект видимый;
- объект добавлен в источник данных;
- источник данных, содержащий объект, добавлен в карту;
- в стилях, установленных в карту, есть параметры отображения, применимые к этому объекту. Подробнее про отображение на карте - см. ISource.
val geometryChannel
Геометрия объекта.
var geometry
Геометрия объекта.
val objectAttributes
Получение свойств объекта карты для чтения и изменения.
val isVisibleChannel
Текущий флаг видимости объекта.
var isVisible
Текущий флаг видимости объекта.
val isDraggableChannel
Текущий флаг перемещаемости объекта.
var isDraggable
Текущий флаг перемещаемости объекта.
val bounds
Прямоугольник минимального размера, содержащий геометрию.
GeometryMapObjectBuilder
Класс для установки свойств и последующего создания геометрических объектов.
GeometryMapObjectBuilder()
fun setObjectAttribute(name: String, value: AttributeValue): GeometryMapObjectBuilder
Установка свойства объекта карты.
name
Имя свойства объекта карты.
value
Значение свойства объекта карты.
fun setObjectAttributes(values: Map): GeometryMapObjectBuilder
Установка свойств объекта карты.
values
набор пар "имя":"значение" для добавляемых свойства объекта карты
метод не заменяет весь набор свойств объекта, т.е. если свойство в values отсутствует, но уже добавлено в объект ранее, оно не будет изменено.
fun setGeometry(geometry: Geometry): GeometryMapObjectBuilder
Установка геометрии объекта карты.
fun setVisible(visible: Boolean): GeometryMapObjectBuilder
Установка видимости объекта карты.
fun setDraggable(draggable: Boolean): GeometryMapObjectBuilder
Установка возможности перетаскивания объекта карты.
fun setUserData(userData: Any?): GeometryMapObjectBuilder
Установка пользовательских данных.
пользовательские данные никак не используются в SDK и нужны только чтобы возвращать их пользователю.
fun createObject(): GeometryMapObject
Конструирование объекта карты.
у объекта обязательно должна быть установлена геометрия
после вызова этой функции GeometryMapObjectBuilder непригоден для задания параметров объекта карты или для его создания
fun setObjectAttribute(name: String, value: Boolean): GeometryMapObjectBuilder
fun setObjectAttribute(name: String, value: Long): GeometryMapObjectBuilder
fun setObjectAttribute(name: String, value: Int): GeometryMapObjectBuilder
fun setObjectAttribute(name: String, value: Double): GeometryMapObjectBuilder
fun setObjectAttribute(name: String, value: Float): GeometryMapObjectBuilder
fun setObjectAttribute(name: String, value: String): GeometryMapObjectBuilder
fun setObjectAttribute(name: String, value: ByteArray): GeometryMapObjectBuilder
fun setObjectAttribute(name: String, value: Color): GeometryMapObjectBuilder
GeometryMapObjectSource
Источник геометрических объектов карты.
fun clusteringObjects(position: CameraPosition): List<MapObject>
Получить список объектов, участвующих в кластеризации при переданной позиции камеры. В списке будут присутствовать как кластеры, так и геометрические объекты.
fun addObject(item: GeometryMapObject): Unit
Добавление объекта в источник.
Добавление объектов по группой эффективнее, чем добавление по одному, особенно в случае, когда источник уже добавлен в одну или несколько карт.
Добавление асинхронное, потокобезопасное, метод можно использовать из любого потока.
Для источника с кластеризацией добавление пока не реализовано, будет выброшено исключение.
fun addObjects(objects: List<GeometryMapObject>): Unit
Добавление нескольких объектов в источник.
Добавление объектов по группой эффективнее, чем добавление по одному, особенно в случае, когда источник уже добавлен в одну или несколько карт.
Добавление асинхронное, потокобезопасное, метод можно использовать из любого потока.
Для источника с кластеризацией добавление пока не реализовано, будет выброшено исключение.
fun removeObject(item: GeometryMapObject): Unit
Удаление объекта из источника.
Удаление асинхронное, потокобезопасное, метод можно использовать из любого потока.
fun removeObjects(objects: List<GeometryMapObject>): Unit
Удаление объектов из источника.
fun removeAndAddObjects(objectsToRemove: List<GeometryMapObject>, objectsToAdd: List<GeometryMapObject>): Unit
Удаление и добавление объектов в источник.
GeometryMapObjectSourceBuilder
fun setSourceAttribute(name: String, value: AttributeValue): GeometryMapObjectSourceBuilder
Установка свойства объектов карты, общего для всего источника (см. ISource).
fun setSourceAttributes(values: Map): GeometryMapObjectSourceBuilder
Установка свойств объектов карты, общих для всего источника.
fun addObject(item: GeometryMapObject): GeometryMapObjectSourceBuilder
Добавление геометрического объекта карты в источник.
fun addObjects(objects: List<GeometryMapObject>): GeometryMapObjectSourceBuilder
Добавление нескольких геометрических объектов карты в источник.
fun createSource(): GeometryMapObjectSource
Создание источника геометрических объектов.
после вызова этой функции использовать GeometryMapObjectSourceBuilder для создания источника данных или для задания параметров источника данных нельзя
GeoPoint
Точка в сферической системе координат, которая совместно с геодезической системой координат (например, WGS84) указывает на точку на поверхности Земли. Данная структура не привязана к конкретной геодезической системе координат. Но данный модуль содержит свободные функции, которые оперируют данной структурой уже в конкретной в системе координат (в какой именно см. в документации к функциям).
GeoPoint(latitude: Latitude, longitude: Longitude)
Точка в сферической системе координат, которая совместно с геодезической системой координат (например, WGS84) указывает на точку на поверхности Земли. Данная структура не привязана к конкретной геодезической системе координат. Но данный модуль содержит свободные функции, которые оперируют данной структурой уже в конкретной в системе координат (в какой именно см. в документации к функциям).
fun move(bearing: Bearing, meter: Meter): GeoPoint
Вычисляет точку, полученную перемещением исходной точки в указанном направлении на указанное расстояние.
fun withElevation(elevation: Elevation = Elevation(0.0f)): GeoPointWithElevation
fun bearing(point: GeoPoint): Bearing
Вычисляет направление (путевой угол, т.е. угол между направлением на географический север и направлением движения, отсчитываемый по часовой стрелке) между двумя точками.
GeoPointRouteAttribute
Контейнер, который описывает точечный атрибут маршрута. Каждый элемент хранится в виде точки на маршруте, в которой этот элемент расположен и значения самого элемента.
fun entries(begin: RoutePoint, end: RoutePoint): List<GeoPointRouteEntry>
Элементы, попадающие в отрезок [begin, end).
fun findNearBackward(point: RoutePoint): GeoPointRouteEntry?
Найти ближайший элемент, позиция которого < = point.
Сложность операции log2(N), где N = size.
fun findNearForward(point: RoutePoint): GeoPointRouteEntry?
Найти ближайший элемент, позиция которого >= point.
Сложность операции log2(N), где N = size.
fun calculateGeoPoint(routePoint: RoutePoint): SegmentGeoPoint?
Вычисляет GeoPoint по известной RoutePoint.
routePoint
Вычисленные географические координаты и направление сегмента, на который указывает параметр route_point. Если маршрут пустой или route_point выходит за пределы маршрута, то возвращается null.
Сложность операции O(log2(N)), где N = route_geometry.size()
GeoPointRouteEntry
Элемент маршрута - точка и значение в ней.
GeoPointRouteEntry(point: RoutePoint, value: GeoPoint)
Элемент маршрута - точка и значение в ней.
GeoPointWithElevation
Точка в географической системе координат (широта, долгота, возвышение).
возвышение (Elevation) в метрах над поверхностью, а не над уровнем моря.
GeoPointWithElevation(
latitude: Latitude,
longitude: Longitude,
elevation: Elevation = Elevation(value = 0.0f)
)
Точка в географической системе координат (широта, долгота, возвышение).
возвышение (Elevation) в метрах над поверхностью, а не над уровнем моря.
fun bearing(point: GeoPoint): Bearing
Вычисляет направление (путевой угол, т.е. угол между направлением на географический север и направлением движения, отсчитываемый по часовой стрелке) для проекции точки на карту и заданной точкой.
fun distance(point: GeoPoint): Meter
Вычисляет минимальное (по ортодромии) расстояние между проекцией точки на карту и заданной точкой.
fun move(bearing: Bearing, meter: Meter): GeoPointWithElevation
Вычисляет точку, полученную перемещением проекции исходной точки в указанном направлении на указанное расстояние.
GeoRect
Прямоугольная область в сферической системе координат (например, WGS84). Данная структура не привязана к конкретной геодезической системе координат.
fun contains(rect2: GeoRect): Boolean
Содержится ли rect2 внутри rect1, т.е. все его точки находятся внутри.
fun contains(point: GeoPoint): Boolean
Содержит ли прямоугольник точку. Точки, расположенные на границе, так же считаются принадлежащими прямоугольнику.
fun expand(rect2: GeoRect): GeoRect
Расширить прямоугольник. Вернуть прямоугольник минимального размера, содержащий оба переданных прямоугольника.
fun expand(point: GeoPoint): GeoRect
Расширить прямоугольник. Вернуть прямоугольник минимального размера, содержащий исходный прямоугольник и точку.
val isValid
Проверяет прямоугольник на корректность.
val isDegenerate
Проверяет прямоугольник на вырожденность. Если точки в прямоугольнике равны, то он вырождается в точку. Вырожденный прямоугольник является корректным прямоугольником. Некорректный прямоугольник не является вырожденным.
val southWestPoint
Юго-западная точка, левая нижняя граница прямоугольника.
val northEastPoint
Северо-восточная точка, правая верхняя граница прямоугольника.
GestureManager
Класс для управления обработкой жестов.
fun setSettingsAboutMapPositionPoint(settings: EventsProcessingSettings): Unit
Настройка точки, относительно которой происходит масштабирование и поворот.
settings
настройки обработки событий.
при вызове функции происходит пересоздание инструментов распознавания жестов.
fun setMutuallyExclusiveGestures(rules: List<EnumSet<Gesture>>): Unit
Установка списка правил исключения одновременного срабатывания нескольких жестов.
К переданному списку правил добавляются правила по умолчанию, которые не позволяют жесту управления наклоном срабатывать одновременно с другими жестами. Каждое правило представляет собой перечень жестов, которые не могут срабатывать одновременно Например, если в правиле указать жесты Scaling и Rotation то эти жесты не будут работать одновременно В случае одновременного выполнения жестов из правила, сработает жест с большим приоритетом Порядок приоритета жестов (по убыванию): (Shift ->) Tilt -> Scaling -> Rotation -> MultiTouchShift
GlobalMapOptions
Глобальные настройки карты. Задаются при инициализации SDK и используются для всех карт.
GlobalMapOptions(graphicsApi: GraphicsApi = GraphicsApi.OPEN_GL)
Глобальные настройки карты. Задаются при инициализации SDK и используются для всех карт.
graphicsApi
val graphicsApi
Графический API.
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
)
Параметры градиентной полилинии.
borderWidth
secondBorderWidth
gradientLength
borderColor
secondBorderColor
colors
colorIndices
val borderWidth
Ширина границы линии.
val secondBorderWidth
Ширина второй границы линии.
val gradientLength
Длина градиентной линии.
val borderColor
Цвет окантовки.
val secondBorderColor
Цвет второй окантовки.
val colors
Палитра цветов градиентной полилинии.
val colorIndices
Индексы цветов градиентной полилинии. Количество индексов должно быть на 1 меньше количества точек полилинии.
GroupCheckableItem
Набор отмечаемых элементов, работающих как радио-группа.
val items
Получение набора элементов группы.
HttpCacheManager
HttpHeader
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-клиента.
certificates
timeout
useCache
cacheStoragePath
cacheMaxSize
proxy
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.
HttpRequest
Структура для представления HTTP запроса.
HttpRequest(
url: String,
method: HttpMethod = HttpMethod.GET,
headers: List<HttpHeader> = listOf(),
body: ByteArray? = null
)
Структура для представления HTTP запроса.
HttpResponse
Структура для представления ответа на HTTP запрос.
тело ответа хранится и обрабатывается отдельно.
HttpResponse(statusCode: HttpStatusCode, headers: List<HttpHeader>)
Структура для представления ответа на HTTP запрос.
тело ответа хранится и обрабатывается отдельно.
HttpResponseCallback
Объект с обратными вызовами для обработки отправки и получения данных.
fun onResponse(response: HttpResponse): Boolean
Метод, обрабатывающий получение ответа от сервера.
response
ответ от сервера.
возвращает false если SDK отменил отправку/обработку запроса.
fun onReceive(body: ByteArray, size: Int): Boolean
Метод, обрабатывающий получение тела ответа. Обработка может вестись по частям.
fun onFinished(): Unit
Метод, оповещающий об окончании обработки запроса. Необходимо вызывать в конце процесса обработки. Даже если запрос был отменен на стороне SDK.
Отсутствие вызова метода может привести к отказу работы сети в SDK.
HttpStatusCode
HTTP статус код ответа.
Image
Изображение.
ImageData
Данные изображения: размер, формат и бинарные данные.
ImageData(
size: ScreenSize,
format: ImageFormat,
data: ByteArray
)
Данные изображения: размер, формат и бинарные данные.
fun toBitmap(): Bitmap
IncompleteTextHandler
Предложено автодополнение для введенного пользователем текста.
IndoorBuilding
Здание с этажными планами.
IndoorControl
Контрол этажей.
Представляет из себя колонку с названиями этажей, из которых активное подсвечено. При нажатии на название переключается этажный план. Одновременно отображается не более 5-ти название, непоместившиеся скролятся.
IndoorControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Контрол этажей.
Представляет из себя колонку с названиями этажей, из которых активное подсвечено. При нажатии на название переключается этажный план. Одновременно отображается не более 5-ти название, непоместившиеся скролятся.
var markedLevels
Этажи, на которых отображаются пометки.
IndoorControlModel
Модель элемента управления этажами.
val activeLevelIndexChannel
Индекс активного этажа.
var activeLevelIndex
Индекс активного этажа.
var markedLevels
Этажи, на которых отображаются пометки.
val levelNamesChannel
Названия этажей. Пусто, если на карте не отображается здание с этажными планами, или у здания всего один этаж.
val levelNames
Названия этажей. Пусто, если на карте не отображается здание с этажными планами, или у здания всего один этаж.
IndoorDetector
Детектор, который определяет находится ли пользователь в помещении.
IndoorManager
Класс для получения текущего здания с этажными планами.
fun setIndoorState(newState: IndoorManagerState): Unit
Переключение включенности/выключенности менеджера этажных планов
IndoorRouteLevelsGetter
Позволяет получать множество этажей, через которые проходят маршруты, отображаемые на карте.
InputEvent
Событие пользовательского ввода.
InstructionRouteAttribute
Контейнер, который описывает точечный атрибут маршрута. Каждый элемент хранится в виде точки на маршруте, в которой этот элемент расположен и значения самого элемента.
fun entries(begin: RoutePoint, end: RoutePoint): List<InstructionRouteEntry>
Элементы, попадающие в отрезок [begin, end).
fun findNearBackward(point: RoutePoint): InstructionRouteEntry?
Найти ближайший элемент, позиция которого < = point.
Сложность операции log2(N), где N = size.
fun findNearForward(point: RoutePoint): InstructionRouteEntry?
Найти ближайший элемент, позиция которого >= point.
Сложность операции log2(N), где N = size.
InstructionRouteEntry
Элемент маршрута - точка и значение в ней.
InstructionRouteEntry(point: RoutePoint, value: RouteInstruction)
Элемент маршрута - точка и значение в ней.
IntRouteAttribute
Контейнер, который описывает точечный атрибут маршрута. Каждый элемент хранится в виде точки на маршруте, в которой этот элемент расположен и значения самого элемента.
fun entries(begin: RoutePoint, end: RoutePoint): List<IntRouteEntry>
Элементы, попадающие в отрезок [begin, end).
fun findNearBackward(point: RoutePoint): IntRouteEntry?
Найти ближайший элемент, позиция которого < = point.
Сложность операции log2(N), где N = size.
fun findNearForward(point: RoutePoint): IntRouteEntry?
Найти ближайший элемент, позиция которого >= point.
Сложность операции log2(N), где N = size.
IntRouteEntry
Элемент маршрута - точка и значение в ней.
IntRouteEntry(point: RoutePoint, value: Int)
Элемент маршрута - точка и значение в ней.
IsOpenNow
Открыто сейчас.
IsOpenNow()
Открыто сейчас.
ItemMarkerInfo
KeyFromAsset
Ключ из asset-а.
KeyFromFile
Ключ из файла.
KeyFromString
Ключ из строки.
KeySource
Источник ключа.
fun match(
fromAsset: Function1,
fromFile: Function1,
fromString: Function1
): T
fun toString(): String
fun hashCode(): Int
LanesCalloutMapPosition
Положение бабла полосности для маршрута.
LanesCalloutMapPosition(
mapId: MapId,
routePoint: RoutePoint,
geoPoint: GeoPoint
)
Положение бабла полосности для маршрута.
LaneSignRouteLongAttribute
Контейнер, который хранит протяженный атрибут маршрута. Каждый элемент хранится в виде пары, состоящей из точки и значения элемента атрибута. Действие атрибута начинается с данной точки и заканчивается в следущей точке, начиная с которой начинается действие атрибута следующего элемента.
fun entry(point: RoutePoint): LaneSignRouteLongEntry?
Элемент, в который попадает заданная точка.
fun entries(begin: RoutePoint, end: RoutePoint): List<LaneSignRouteLongEntry>
Элементы, частично или полностью покрываемые отрезком begin,end.
LaneSignRouteLongEntry
Протяженный элемент маршрута - отрезок и значение на нем.
LaneSignRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: RouteLaneSign
)
Протяженный элемент маршрута - отрезок и значение на нем.
Latitude
Географическая широта.
LevelId
Идентификатор этажного плана.
LevelInfo
Информация об этаже здания.
Locale
Локаль.
fun toLocalePosix(): String
LocaleManager
Менеджер региональных настроек приложения.
fun overrideLocales(locales: List<Locale>): Unit
Установка списка локалей приложения
val localesChannel
Локали приложения, если заданы, иначе - локали, заданные пользователем в ОС.
val locales
Локали приложения, если заданы, иначе - локали, заданные пользователем в ОС.
val systemLocalesChannel
Получение локалей, предоставляемых ОС.
Локали ОС в порядке, заданном пользователем (в порядке от более приоритетной к менее приоритетной).
val systemLocales
Получение локалей, предоставляемых ОС.
Локали ОС в порядке, заданном пользователем (в порядке от более приоритетной к менее приоритетной).
Location
Геопозиция.
Location(
coordinates: LocationCoordinates,
altitude: LocationFuzzyDouble?,
course: LocationCourse?,
groundSpeed: LocationFuzzyDouble?,
source: String,
timestamp: Duration
)
Геопозиция.
coordinates
altitude
course
groundSpeed
source
timestamp
val coordinates
coordinates::value - координаты геопозиции в системе координат WGS 84. coordinates::accuracy - горизонтальная точность определения координат геопозиции (DRMS), м. https://en.wikipedia.org/wiki/Circular_error_probable Область значений: >= 0.
val altitude
altitude::value - высота над опорным эллипсоидом WGS 84, м. 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/Standard_deviation Область значений: (null, > 0).
val source
Название источника геопозиции.
timestamp'ы между разными источниками геопозиции не синхронизированы, поэтому сравнивать timestamp'ы у геопозиций, которые получены из разных источников нельзя.
val timestamp
Временная точка, в которой была определена геопозиция. Эта точка не привязана ни к какой конкретной дате и используется исключительно для того, чтобы вычислить время между двумя измерениями геопозиции, полученными от одного источника геопозиции в одной сессии. Это поле должно монотонно возрастать (даже когда система находится в спящем режиме).
LocationCoordinates
LocationCourse
LocationFuzzyDouble
LogicalPixel
Пиксель, размер которого не зависит от плотности экрана.
1 логический пиксель соответствует 1 / (базовый ppi) дюйма. Базовый PPI зависит от устройства и вычисляется из отношения DevicePpi/DeviceDensity. DevicePpi и DeviceDensity, в свою очередь, задаются с ОС через интерфейс карты. Для Android LogicalPixel соответствует dp, для iOS - point'у.
LogicalPixel(value: Float = 0.0f)
Пиксель, размер которого не зависит от плотности экрана.
1 логический пиксель соответствует 1 / (базовый ppi) дюйма. Базовый PPI зависит от устройства и вычисляется из отношения DevicePpi/DeviceDensity. DevicePpi и DeviceDensity, в свою очередь, задаются с ОС через интерфейс карты. Для Android LogicalPixel соответствует dp, для iOS - point'у.
value
LogMessage
Сообщение, записываемое в лог.
LogOptions
Настройки логирования.
Longitude
Географическая долгота.
MagneticChangeListener
Класс, отслеживающий изменения направления компаса и его доступность.
ManeuverControl
Map
Карта.
fun addSource(source: Source): Unit
Добавление источника данных на карту.
Происходит асинхронно. Метод может вызываться из любого потока, потокобезопасен.
fun removeSource(source: Source): Unit
Удаление источника данных из карты.
Происходит асинхронно. Метод может вызываться из любого потока, потокобезопасен.
fun getRenderedObjects(centerPoint: ScreenPoint, radius: ScreenDistance = ScreenDistance(value = 1.0f)): Future<List<RenderedObjectInfo>>
Получение отображаемых объектов карты, проецирующихся на окружность на экране.
centerPoint
центр окружности.
radius
радиус окружности.
Список объектов формируется в порядке отрисовки от поздних к ранним.
fun setAttribute(name: String, value: AttributeValue): Unit
val id
Идентификатор экземпляра карты, уникальный в рамках процесса.
val camera
Получение камеры.
val indoorManager
Получение менеджера этажных планов.
val dataLoadingStateChannel
Нотификация о состоянии загружаемых в карту данных.
При слежении за позицией камеры состояние карты всегда будет MapDataLoadingState::Loading.
val dataLoadingState
Нотификация о состоянии загружаемых в карту данных.
При слежении за позицией камеры состояние карты всегда будет MapDataLoadingState::Loading.
val styleChannel
Получение текущих стилей карты.
var style
Получение текущих стилей карты.
val fontIconSizeMultiplierChannel
Множитель размера иконок и шрифтов, полученный из приложения.
Размер иконок и шрифтов задаётся в логических пикселях (см. LogicalPixel) и умножается на множитель размера шрифтов и иконок.
var fontIconSizeMultiplier
Множитель размера иконок и шрифтов, полученный из приложения.
Размер иконок и шрифтов задаётся в логических пикселях (см. LogicalPixel) и умножается на множитель размера шрифтов и иконок.
val sources
Получение источников данных карты.
Происходит асинхронно. Метод может вызываться из любого потока, потокобезопасен.
val mapVisibilityStateChannel
var mapVisibilityState
val attributes
Получение атрибутов.
должны быть указаны свойства: "theme"="day|night" "navigatorOn"="true|false"
TODO: стилевые свойства для пробок
val interactiveChannel
Интерактивность карты. Под интерактивностью понимается наличие у пользователя возможности взаимодействия с картой. При отключении интерактивности карта перестанет реагировать на события ввода, пришедшие от пользователя. Также перестанут работать контролы для работы с картой (приближения и перехода к текущему положению). При этом остаётся возможность работать с картой через set_position/move. При переходе в неинтерактивное состояние незавершённые жесты будут сброшены. По умолчанию карта интерактивна (interactive == true).
функция может быть вызвана из любого потока.
var interactive
Интерактивность карты. Под интерактивностью понимается наличие у пользователя возможности взаимодействия с картой. При отключении интерактивности карта перестанет реагировать на события ввода, пришедшие от пользователя. Также перестанут работать контролы для работы с картой (приближения и перехода к текущему положению). При этом остаётся возможность работать с картой через set_position/move. При переходе в неинтерактивное состояние незавершённые жесты будут сброшены. По умолчанию карта интерактивна (interactive == true).
функция может быть вызвана из любого потока.
MapControl
Базовый класс для UI-элементов карты.
MapControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Базовый класс для UI-элементов карты.
MapControls
MapDirection
Угол поворота объекта относительно направления на север, в градусах, отсчитывается по часовой стрелке.
MapDirection(value: Double = 0.0)
Угол поворота объекта относительно направления на север, в градусах, отсчитывается по часовой стрелке.
value
MapId
Идентификатор экземпляра карты, уникальный в рамках процесса.
MapId(value: Int = 0)
Идентификатор экземпляра карты, уникальный в рамках процесса.
value
MapLocationController
Контроллер для управления позиционированием карты в навигаторе.
MapManager
Интерфейс, позволяющий добавлять карты в навигатор и убирать их из него.
MapObject
Объект на карте.
MapObjectManager
MapObjectManager(map: Map, layerId: String? = null)
Создать IMapObjectManager.
fun removeObject(item: SimpleMapObject): Unit
Удалить объект.
fun addObjects(objects: List<SimpleMapObject>): Unit
Добавить объекты.
fun removeObjects(objects: List<SimpleMapObject>): Unit
Удалить объекты.
fun removeAndAddObjects(objectsToRemove: List<SimpleMapObject>, objectsToAdd: List<SimpleMapObject>): Unit
Удалить и добавить объекты.
fun removeAll(): Unit
fun clusteringObjects(position: CameraPosition): List<MapObject>
Получить список объектов, участвующих в кластеризации при переданной позиции камеры. В списке будут присутствовать как кластеры, так и маркеры.
@JvmStatic
fun withClustering(
map: Map,
logicalPixel: LogicalPixel,
maxZoom: Zoom,
clusterRenderer: SimpleClusterRenderer,
minZoom: Zoom = Zoom(value = 0.0f),
layerId: String? = null
): MapObjectManager
Создать IMapObjectManager с кластеризацией данных. Кластеризуются только IMarker объекты.
map
logicalPixel
Минимально возможное расстояние на экране между точками привязки маркеров на уровнях, где работает кластеризация.
maxZoom
Уровень, начиная с которого видны все маркеры.
clusterRenderer
Интерфейс для задания параметров отображения кластера.
minZoom
Уровень, начиная с которого формируются кластеры.
layerId
ID слоя в стиле типа "Динамический объект". Создаваемые объекты будут размещены на этом слое, тем самым можно задать их порядок относительно других слоев. Если не задан, объекты размещаются поверх остальных слоев.
@JvmStatic
fun withGeneralization(
map: Map,
logicalPixel: LogicalPixel,
maxZoom: Zoom,
minZoom: Zoom = Zoom(value = 0.0f),
layerId: String? = null
): MapObjectManager
Создать IMapObjectManager с генерализацией данных. Генерализуются только IMarker объекты.
map
logicalPixel
Минимально возможное расстояние на экране между точками привязки маркеров на уровнях, где работает генерализация.
maxZoom
Уровень, начиная с которого видны все маркеры.
minZoom
Уровень, начиная с которого работает генерализация.
layerId
ID слоя в стиле типа "Динамический объект". Создаваемые объекты будут размещены на этом слое, тем самым можно задать их порядок относительно других слоев. Если не задан, объекты размещаются поверх остальных слоев.
MapOptions
Параметры карты.
MapOptions()
Параметры карты.
fun setTheme(theme: MapTheme): Unit
Устанавливает тему, которая будет использована в карте. Для изменения в течение жизненного цикла MapView, используйте MapView.setTheme.
@JvmStatic
fun fromAttributes(context: Context, attrs: AttributeSet): MapOptions
MapPaddingControl
UI-элемент, задающий внутренние отступы (padding) карты.
MapPaddingControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
UI-элемент, задающий внутренние отступы (padding) карты.
MapRotationBeginEvent
MapRotationEndEvent
MapScalingBeginEvent
MapScalingEndEvent
MapShiftBeginEvent
MapShiftEndEvent
MapTheme
Тема для использования в карте.
val name
Код стиля из редактора стилей.
val loadingBackground
Цвет подложки, используемый до загрузки стилей и отображения подложки карты. В темах по умолчанию соответствует цвету подложки карты по умолчанию.
val defaultTheme
Стандартная светлая тема для базовых стилей
val defaultDarkTheme
Стандартная темная тема для базовых стилей
MapView
Контейнер, содержащий карту и дополнительные элементы управления.
fun onAttachedToWindow(): Unit
fun onDetachedFromWindow(): Unit
fun setTouchEventsObserver(observer: TouchEventsObserver?): Unit
fun addObjectTappedCallback(callback: MapObjectTappedCallback): Unit
fun removeObjectTappedCallback(callback: MapObjectTappedCallback): Unit
fun addObjectLongTouchCallback(callback: MapObjectTappedCallback): Unit
fun removeLongTouchCallback(callback: MapObjectTappedCallback): Unit
fun setCopyrightMargins(
left: Int,
top: Int,
right: Int,
bottom: Int
): Unit
fun setTheme(theme: MapTheme): Unit
Устанавливает тему для использования в карте.
fun onConfigurationChanged(newConfig: Configuration): Unit
fun onSaveInstanceState(): Parcelable?
fun onVisibilityChanged(changedView: View, visibility: Int): Unit
fun takeSnapshot(copyrightPosition: Alignment = Alignment.BOTTOM_RIGHT): Future<ImageData>
fun useDefaultGestureRecognitionEngine(): Unit
Использовать встроенный распознаватель жестов.
fun useCustomGestureRecognitionEngine(customGestureRecognitionEngine: MapGestureRecognitionEngine): Unit
Использовать пользовательский распознаватель жестов.
lateinit var mapOptions
var showApiVersionInCopyrightView
var maxFps
Максимально допустимая частота обновления карты. Если не задана, равна частоте обновления экрана.
var powerSavingMaxFps
Максимально допустимая частота обновления карты в режиме сохранения энергии. Если не задана, равна maxFps.
val fpsChannel
Частота обновления карты. Для получения корректного значения необходимо держать подписку на канал. Перед вызовом метода карта должна быть проинициализирована (завершен getMapAsync).
val renderView
Возвращает View, используемый для рендера OpenGL.
val gestureManager
val mapTheme
Тема, которая используется картой. Для изменения в течение жизненного цикла MapView, используйте setTheme.
MarkedByRouteIndoorControl
UI-элемент, где отмечены этажи, через которые на карте проходят маршруты.
MarkedByRouteIndoorControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
UI-элемент, где отмечены этажи, через которые на карте проходят маршруты.
MarkedUpText
Размеченный текст.
MarkedUpText(text: String, matchedParts: List<MarkedUpTextSpan>)
Размеченный текст.
MarkedUpTextSpan
Описывает поднабор байтов строки text.
Marker
Точечная отметка на карте, представляющая интерес для пользователя.
var position
Получение местоположения маркера.
var icon
Получение иконки маркера.
var anchor
Получение точки привязки иконки маркера.
var iconOpacity
Получение прозрачности иконки маркера.
var text
Получение подписи маркера.
var textStyle
Получение стиля подписи маркера.
var isDraggable
Получение флага перемещаемости маркера.
var iconWidth
Получение целевой ширины маркера, используемой для масштабирования.
var iconMapDirection
Угол поворота маркера на карте относительно направления на север, по часовой стрелке.
var animatedAppearance
Анимировать ли появление.
var iconAnimationMode
Получение режима анимации анимированного маркера.
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,
iconAnimationMode: AnimationMode = AnimationMode.NORMAL
)
Параметры маркера.
position
icon
iconMapDirection
anchor
text
textStyle
iconOpacity
visible
draggable
iconWidth
userData
zIndex
animatedAppearance
levelId
iconAnimationMode
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
Привязка к поэтажному плану здания.
val iconAnimationMode
Режим анимации.
MessageControl
Meter
Длина/расстояние в метрах.
MillisecondsRouteAttribute
Контейнер, который описывает точечный атрибут маршрута. Каждый элемент хранится в виде точки на маршруте, в которой этот элемент расположен и значения самого элемента.
fun entries(begin: RoutePoint, end: RoutePoint): List<MillisecondsRouteEntry>
Элементы, попадающие в отрезок [begin, end).
fun findNearBackward(point: RoutePoint): MillisecondsRouteEntry?
Найти ближайший элемент, позиция которого < = point.
Сложность операции log2(N), где N = size.
fun findNearForward(point: RoutePoint): MillisecondsRouteEntry?
Найти ближайший элемент, позиция которого >= point.
Сложность операции log2(N), где N = size.
fun calculateDuration(routePoint: RoutePoint): Duration
Вычисляет ожидаемое время движения до конца маршрута.
MillisecondsRouteEntry
Элемент маршрута - точка и значение в ней.
MillisecondsRouteEntry(point: RoutePoint, value: Duration)
Элемент маршрута - точка и значение в ней.
Model
Модель навигатора, предназначенная для отображения в UI.
val stateChannel
Состояние навигатора.
val state
Состояние навигатора.
val locationChannel
Текущая геопозиция, с которой работает навигатор.
see location_available_channel
val location
Текущая геопозиция, с которой работает навигатор.
see location_available_channel
val locationAvailableChannel
Флаг, который указывает используется ли текущая геопозия для навигации. После получения геопозиции навигатор решает пригодна ли она для того, чтобы использовать её для навигации (например, если у геопозиции слишком большая погрешность, навигатор может решить, что она не пригодна для навигации) Если геопозиция пригодна для навигации, навигатор выставляет в этом канале значение true, если не пригодна - false.
Даже если значение в данном канале равно false, в канале location_channel геопозиция может обновляться.
see location_channel
val locationAvailable
Флаг, который указывает используется ли текущая геопозия для навигации. После получения геопозиции навигатор решает пригодна ли она для того, чтобы использовать её для навигации (например, если у геопозиции слишком большая погрешность, навигатор может решить, что она не пригодна для навигации) Если геопозиция пригодна для навигации, навигатор выставляет в этом канале значение true, если не пригодна - false.
Даже если значение в данном канале равно false, в канале location_channel геопозиция может обновляться.
see location_channel
val routeChannel
Маршрут с манёврами.
В режиме свободной езды (StateChannel::FreeRoam) отсутствует маршрут по которому движется пользователь. Поэтому участок дороги, по которой в данный момент движется пользователь, навигатор представляет в виде маршрута и отдает его как текущий маршрут. Такое описание дороги не является полноценным маршрутом, т.к. у него нет финиша и манёвров.
val route
Маршрут с манёврами.
В режиме свободной езды (StateChannel::FreeRoam) отсутствует маршрут по которому движется пользователь. Поэтому участок дороги, по которой в данный момент движется пользователь, навигатор представляет в виде маршрута и отдает его как текущий маршрут. Такое описание дороги не является полноценным маршрутом, т.к. у него нет финиша и манёвров.
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)
Настройки обработки сдвига при касании несколькими пальцами.
thresholdMm
MyLocationControl
Контрол перелёта к текущему местоположению пользователя.
MyLocationControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Контрол перелёта к текущему местоположению пользователя.
MyLocationController
Класс, контролирующий отображение маркера текущего положения.
MyLocationController(
bearingSource: BearingSource?,
animationDuration: Duration = Duration.ofMilliseconds(1000),
coordinatesThreshold: Meter = Meter(value = 0.1f),
bearingThreshold: Bearing = Bearing(value = 1.0)
)
Создание контроллера перемещения маркера геопозиции. Один контроллер может быть добавлен только в источники одного контекста.
bearingSource
источник направления. Если отсутствует, будет отображаться маркер без направления.
animationDuration
неотрицательная длительность изменения реального направления.
coordinatesThreshold
неотрицательное пороговое значение учитываемого изменения реальной позиции и её точности.
bearingThreshold
неотрицательное пороговое значение учитываемого изменения реального направления.
MyLocationControlModel
Модель контрола перелета к местоположению пользователя. Контрол состоит из кнопки, при нажатии на которую камера перелетает к местоположению пользователя. Если местоположение не определено, ничего не происходит. Методы объекта необходимо вызывать на одном потоке.
fun onClicked(): Unit
MyLocationMapObject
Маркер геопозиции.
MyLocationMapObjectSource
Источник, содержащий маркер геопозиции.
MyLocationMapObjectSource(
context: Context,
controller: MyLocationController,
markerType: MyLocationMapObjectMarkerType = MyLocationMapObjectMarkerType.MODEL
)
Создать источник маркера геопозиции.
fun setController(controller: MyLocationController): Unit
Установка нового контроллера, отвечающего за параметры маркера.
val item
Получить маркер геопозиции.
NativeException
Исключение, преобразованное из исключения, брошенного в нативном коде.
NativeObject
Базовый класс для объектов, представляющих собой обёртки над объектами в нативном коде.
NativeProxy
Технический класс, инкапсулирующий в себе слабый указатель на объект в нативном коде.
fun finalize(): Unit
NavigationControl
Базовый класс для UI-элементов навигатора.
NavigationControl
Контейнер с UI-элементами управления уровнем масштабирования и перелётом к текущему местоположению пользователя.
NavigationFollowController
Интерфейс для управления слежением карты за маркером геопозиции в навигаторе.
var followReturnDelay
Таймаут, через который карта автоматически вернется в режим слежения за маркером геопозиции после того, как пользователь подвигал её. 0 - автоматический возврат в режим слежения за маркером геопозиции отключен.
var cameraBehaviour
Режим слежения камеры за маркером геопозиции в навигаторе.
NavigationManager
Корневой публичный интерфейс навигатора.
val uiModel
Модель навигатора, предназначенная для отображения в UI.
val indoorDetector
Навигация внутри помещений.
val mapFollowController
Управление автоматическим возвратом карты к слежению за маркером геопозиции.
val mapLocationController
Контроллер для управления позиционированием карты в навигаторе.
val mapManager
Менеджер карт навигатора.
val zoomFollowSettings
Настройки масштабирования карты во время режима ведения.
val routeMapSettings
Настройки отображения маршрута на карте.
val routeSourceSettings
Настройки источника, используемого для отображения маршрута на карте.
val simulationSettings
Настройки симуляции ведения по маршруту.
val voiceSelector
Управление голосовыми пакетами в текущей сессии навигатора.
val exceedSpeedLimitSettings
Настройки детектирования превышения скорости.
val dynamicRouteInfoSettings
Настройки получения и обновления динамических данных о маршруте.
val soundNotificationSettings
Настройки звуковых оповещений в текущей сессии навигатора.
val freeRoamSettings
Настройки ведения без маршрута в режиме free roam.
val alternativeRoutesProviderSettings
Настройки поиска альтернативных маршрутов в режиме ведения.
val alternativeRouteSelector
Выбор альтернативного маршрута.
NavigationView
UI-элемент, отображающий состояние навигации на карте.
Добавление его в MapView приводит к отображению на ней маршрута, маркера геопозиции, транспортных событий, слежению за камерой. Внутри NavigationView можно размещать навигационные контролы - наследники NavigationControl, в частности готовый к использованию набор контролов DefaultNavigationControls.
var navigationManager
NavigationVoice
Голос для использования в навигаторе.
NewValuesNotifier
Интерфейс объекта, который сообщает о том, что есть изменения в каком-либо из параметров.
fun sendNotification(): Unit
Необходимо вызывать, чтобы сообщить об обновлении параметров.
ObstacleInfo
Информация о препятствии на маршруте.
ObstacleInfo(type: Obstacle = Obstacle.OTHER, limitation: ObstaclePassLimitation = ObstaclePassLimitation.UNLIMITED)
Информация о препятствии на маршруте.
ObstacleInfoRouteAttribute
Контейнер, который описывает точечный атрибут маршрута. Каждый элемент хранится в виде точки на маршруте, в которой этот элемент расположен и значения самого элемента.
fun entries(begin: RoutePoint, end: RoutePoint): List<ObstacleInfoRouteEntry>
Элементы, попадающие в отрезок [begin, end).
fun findNearBackward(point: RoutePoint): ObstacleInfoRouteEntry?
Найти ближайший элемент, позиция которого < = point.
Сложность операции log2(N), где N = size.
fun findNearForward(point: RoutePoint): ObstacleInfoRouteEntry?
Найти ближайший элемент, позиция которого >= point.
Сложность операции log2(N), где N = size.
ObstacleInfoRouteEntry
Элемент маршрута - точка и значение в ней.
ObstacleInfoRouteEntry(point: RoutePoint, value: ObstacleInfo)
Элемент маршрута - точка и значение в ней.
ObstacleInfoRouteLongAttribute
Контейнер, который хранит протяженный атрибут маршрута. Каждый элемент хранится в виде пары, состоящей из точки и значения элемента атрибута. Действие атрибута начинается с данной точки и заканчивается в следущей точке, начиная с которой начинается действие атрибута следующего элемента.
fun entry(point: RoutePoint): ObstacleInfoRouteLongEntry?
Элемент, в который попадает заданная точка.
fun entries(begin: RoutePoint, end: RoutePoint): List<ObstacleInfoRouteLongEntry>
Элементы, частично или полностью покрываемые отрезком begin,end.
ObstacleInfoRouteLongEntry
Протяженный элемент маршрута - отрезок и значение на нем.
ObstacleInfoRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: ObstacleInfo
)
Протяженный элемент маршрута - отрезок и значение на нем.
Opacity
Непрозрачность - от 0.0 (полная прозрачность) до 1.0 (полная непрозрачность).
Opacity(value: Float = 0.0f)
Непрозрачность - от 0.0 (полная прозрачность) до 1.0 (полная непрозрачность).
value
OpeningHours
Часы работы организации.
OpeningHours(weekOpeningHours: List<List<WeekTimeInterval>>, isOpen24x7: Boolean)
Часы работы организации.
OrderedValue
Описывает одно значение из набора.
OrderedValues
Описывает набор дискретных упорядоченных значений.
OrderedValues(
values: List<OrderedValue>,
currentMinIndex: Long? = null,
currentMaxIndex: Long? = null
)
Описывает набор дискретных упорядоченных значений.
Package
Пакет. Для удобства работы с данными (установки, обновления, удаления), данные в 2ГИС SDK группируются в наборы по функционально-логическому назначению. Набор сгруппированных данных называется пакетом. В пределах одного пакета функциональное назначение данных уникально. Однако, множества данных пакетов с единым функциональным назначением могут пересекаться, то есть, возможна ситуация, когда данные нескольких пакетов имеют общие файлы. При операциях с группой таких пакетов общие данные будут обрабатываться (скачиваться, распаковываться, удаляться) только один раз.
val id
Стабильный технический идентификатор пакета.
val infoChannel
Информация о пакете.
val info
Информация о пакете.
val progressChannel
Прогресс операции установки или обновления пакета в процентах. Если пакет не установлен локально, канал содержит значение 0. Если пакет установлен локально, независимо от актуальности данных и их совместимости с текущей версией SDK, канал содержит значение 100. Если пакет находится на этапе установки или обновления, канал содержит обновляемое значение в диапазоне 0,100.
val progress
Прогресс операции установки или обновления пакета в процентах. Если пакет не установлен локально, канал содержит значение 0. Если пакет установлен локально, независимо от актуальности данных и их совместимости с текущей версией SDK, канал содержит значение 100. Если пакет находится на этапе установки или обновления, канал содержит обновляемое значение в диапазоне 0,100.
PackageInfo
Информация о пакете. См. IPackage.
PackageInfo(
name: String,
installed: Boolean = false,
incomplete: Boolean = true,
preinstalled: Boolean = false,
compatible: Boolean = false,
hasUpdate: Boolean = false,
error: PackageInfoError?,
updateStatus: PackageUpdateStatus = PackageUpdateStatus.NOT_AVAILABLE,
finalSizeOnDisk: Long? = null,
currentSizeOnDisk: Long = 0
)
Информация о пакете. См. IPackage.
name
installed
incomplete
preinstalled
compatible
hasUpdate
error
updateStatus
finalSizeOnDisk
currentSizeOnDisk
val name
Локализованное название пакета.
val installed
Признак установки - true в случае, если пакет был выбран для установки.
val incomplete
Признак незавершенности установки - true, если нет полностью загруженной версии пакета (возможно, несовместимой с текущей версией SDK).
val preinstalled
Признак предустановленных пакетов. Предустановленные пакеты всегда установлены и полностью загружены, и их нельзя удалить.
val compatible
Признак совместимости - true в случае, если загруженный пакет совместим с текущей версией SDK.
val hasUpdate
Признак наличия обновления - true в случае наличия обновления для загруженного пакета. Возможна ситуация, когда во время процесса обновления до новой версии на сервере стала доступна ещё более новая версия пакета. В этом случае значение будет true как во время обновления, так и по его окончании.
val error
Ошибка, произошедшая при попытке загрузки и/или установки пакета, или null, если ошибки нет.
val updateStatus
Статус обновления пакета.
val finalSizeOnDisk
Размер территории в байтах, который она занимает на диске после установки. Неинициализированное значение означает, что территория не содержит файлов (информация получена на основе предустановленного файла состояния, в котором нет списка файлов для территории).
val currentSizeOnDisk
Размер в байтах, который занимают на данный момент уже установленные файлы территории.
PackageManager
Интерфейс для централизованной работы с пакетами:
- Управления автообновлением и получением его статуса;
- Принудительной проверкой обновлений;
- Запуском и остановкой установки/обновления всех доступных пакетов.
- Подпиской на изменения информации о пакетах;
- Подпиской на изменения информации о всеобщем прогрессе установки пакетов.
var autoupdateEnabled
Статус (включено/выключено) автообновления.
val packagesChannel
Канал со списком всех известных пакетов. Обновляется в случае изменения информации о хотя бы об одном из пакетов, либо при изменении состава списка.
val packages
Канал со списком всех известных пакетов. Обновляется в случае изменения информации о хотя бы об одном из пакетов, либо при изменении состава списка.
PackedMapState
Сериализованное состояние карты.
fun toBytes(): ByteArray
Представление состояния карты в виде последовательности байтов.
@JvmStatic
fun of(
position: CameraPosition,
showTraffic: Boolean,
behaviour: CameraBehaviour
): PackedMapState
Получение состояния карты.
position
Позиция камеры.
showTraffic
Состояние отображения пробок на карте.
behaviour
Режим слежения камеры.
Сериализованное состояние карты.
@JvmStatic
fun fromBytes(data: ByteArray): PackedMapState
Получение состояния карты.
data
Состояние карты в виде последовательности байтов.
Сериализованное состояние карты.
@JvmStatic
fun fromMap(map: Map): PackedMapState
Получение состояния карты.
map
Карта, состояние которой необходимо получить.
Сериализованное состояние карты.
PackedNavigationState
Вспомогательный объект для сериализации и десериализации состояния навигации.
PackedSearchQuery
Вспомогательный объект для сериализации и десериализации поискового запроса.
fun toBytes(): ByteArray
fun toSearchQuery(): SearchQuery
@JvmStatic
fun fromBytes(data: ByteArray): PackedSearchQuery
Десериализация запроса поиска.
@JvmStatic
fun fromSearchQuery(searchQuery: SearchQuery): PackedSearchQuery
val queryText
Текст запроса. Для некоторых запросов (например, раскрытие рубрики из suggest'а) текст отсутствует, т.к. в запросе хранятся идентификаторы, и поведение отличается от поиска по тексту элемента suggest'а.
val spatialRestriction
Геометрия, ограничивающая область поиска.
val areaOfInterest
Прямоугольная область интереса.
val allowedResultTypes
Ограничение по возвращаемым поиском типам объектов.
val pageSize
Размер страницы выдачи.
val directoryFilter
Информация об активных фильтрах.
val sortingType
Тип сортировки результатов.
Padding
Отступы от краёв камеры.
Задаётся от краёв внутрь, в физических пикселях. Отступы влияют на:
- точку позиции;
- анимированное перемещение карты;
- расположение динамических объектов карты (например баблы маршрутов).
Padding(
left: Int = 0,
top: Int = 0,
right: Int = 0,
bottom: Int = 0
)
Отступы от краёв камеры.
Задаётся от краёв внутрь, в физических пикселях. Отступы влияют на:
- точку позиции;
- анимированное перемещение карты;
- расположение динамических объектов карты (например баблы маршрутов).
Page
Страница результатов поиска.
fun fetchPrevPage(): Future<Page?>
Получить предыдущую страницу результатов.
future, резолвящаяся в ненулевой указатель на предыдущую страницу, если страница успешно получена future, резолвящаяся в нулевой указатель, если предыдущая страница отсутствует exceptional future, если произошла ошибка при получении страницы
fun fetchNextPage(): Future<Page?>
Получить следующую страницу результатов.
future, резолвящаяся в ненулевой указатель на следующую страницу, если страница успешно получена future, резолвящаяся в нулевой указатель, если следующая страница отсутствует exceptional future, если произошла ошибка при получении страницы
val items
Непустой набор объектов справочника этой страницы.
ParkingCapacity
Вместимость парковки.
ParkingCapacity(total: String?, specialSpaces: List<SpecialSpace>)
Вместимость парковки.
ParkingInfo
Общая информация о парковке.
ParkingInfo(
type: ParkingType?,
purpose: ParkingPurpose,
access: ParkingAccess,
pavingType: ParkingPavingType?,
isPaid: Boolean,
isIncentive: Boolean,
forTrucks: Boolean,
levelCount: Short?,
capacity: ParkingCapacity?
)
Общая информация о парковке.
type
purpose
access
pavingType
isPaid
isIncentive
forTrucks
levelCount
capacity
PedestrianBriefRouteInfo
Базовая информация о пешеходном маршруте.
PedestrianBriefRouteInfo(length: RouteDistance, landmark: String)
Базовая информация о пешеходном маршруте.
PedestrianInstructionCrossroad
Описание манёвров при проходе через перекрёсток или по пешеходному переходу.
PedestrianInstructionCrossroad(landmark: PedestrianInstructionCrossroadLandmark = PedestrianInstructionCrossroadLandmark.NONE, maneuvers: List<PedestrianInstructionCrossroadManeuver>)
Описание манёвров при проходе через перекрёсток или по пешеходному переходу.
PedestrianInstructionCrossroadManeuver
PedestrianInstructionCrossroadManeuver(direction: PedestrianInstructionCrossroadManeuverDirection = PedestrianInstructionCrossroadManeuverDirection.STRAIGHT, turnAngle: Int = 0)
PedestrianInstructionFinish
Конец пешеходной части маршрута.
PedestrianInstructionFinish()
Конец пешеходной части маршрута.
PedestrianInstructionIndoorEnter
Вход в здание.
PedestrianInstructionIndoorEnter(levelId: LevelId = LevelId())
Вход в здание.
levelId
PedestrianInstructionIndoorExit
Выход из здания.
PedestrianInstructionIndoorExit()
Выход из здания.
PedestrianInstructionIndoorFloorChange
Смена этажа в здании.
PedestrianInstructionIndoorFloorChange(
type: PedestrianInstructionIndoorFloorChangeType = PedestrianInstructionIndoorFloorChangeType.UNDEFINED,
beginId: LevelId = LevelId(),
endId: LevelId = LevelId()
)
Смена этажа в здании.
PedestrianInstructionStart
Начало пешеходной части маршрута.
PedestrianInstructionStart()
Начало пешеходной части маршрута.
PedestrianRouteSearchOptions
Параметры поиска пешеходного маршрута.
PedestrianRouteSearchOptions(
avoidStairways: Boolean = false,
avoidUnderpassesAndOverpasses: Boolean = false,
useIndoor: Boolean = true,
excludedAreas: List<ExcludedArea> = listOf()
)
Параметры поиска пешеходного маршрута.
avoidStairways
avoidUnderpassesAndOverpasses
useIndoor
excludedAreas
PerformSearchHandler
Предложено поискать определенный набор объектов.
val searchQuery
Запрос для прогона через поисковик.
PointGeometry
PointGeometryData
Данные геометрии точечного объекта.
PointGeometryData(geoPointWithElevation: GeoPointWithElevation)
geoPointWithElevation
fun match(geoPoint: Function1, geoPointWithElevation: Function1): T
fun toString(): String
fun hashCode(): Int
Polygon
Полигон на карте.
Polygon(options: PolygonOptions)
Cоздание полигона на основе параметров.
options
PolygonGeometry
PolygonOptions
Параметры полигона.
PolygonOptions(
contours: List<List<GeoPoint>>,
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
)
Параметры полигона.
contours
color
strokeWidth
strokeColor
visible
userData
zIndex
levelId
Polyline
Ломаная линия на карте.
PolylineGeometry
PolylineOptions
Параметры полилинии.
PolylineOptions(
points: List<GeoPoint>,
width: LogicalPixel = LogicalPixel(value = 1.0f),
color: Color = Color(),
erasedPart: Double = 0.0,
dashedPolylineOptions: DashedPolylineOptions? = null,
gradientPolylineOptions: GradientPolylineOptions? = null,
visible: Boolean = true,
userData: Any? = null,
zIndex: ZIndex = ZIndex(value = 0),
levelId: LevelId? = null
)
Параметры полилинии.
points
width
color
erasedPart
dashedPolylineOptions
gradientPolylineOptions
visible
userData
zIndex
levelId
val points
Точки полилинии.
val width
Ширина полилинии.
val color
Основной цвет полилинии.
val erasedPart
val dashedPolylineOptions
Параметры пунктирной полилинии.
Пунктирная градиентная линия в данный момент не поддерживается, поэтому если в PolylineOptions присутствуют и dashed_polyline_options, и gradient_polyline_options, то dashed_polyline_options будут проигнорированы при создании полилинии.
val gradientPolylineOptions
Параметры градиентной полилинии.
Пунктирная градиентная линия в данный момент не поддерживается, поэтому если в PolylineOptions присутствуют и dashed_polyline_options, и gradient_polyline_options, то dashed_polyline_options будут проигнорированы при создании полилинии.
val visible
Видимость полилинии.
val userData
Пользовательские данные.
val zIndex
Уровень отрисовки объекта.
val levelId
Привязка к поэтажному плану здания.
Projection
Проекция.
Используется сферическая проекция Меркатора (EPSG:3857), зацикленная по долготе. Отображаемые данные ограничены по широте от -85.06° до 85.06°.
fun screenToMap(point: ScreenPoint): GeoPoint?
Вычисление точки карты в указанной точке экрана.
Функция возвращает пустое значение, если указанная точка экрана за пределами проекции карты.
fun mapToScreen(point: GeoPoint): ScreenPoint?
Вычисление точки экрана, соответствующей указанной точке карты.
Функция возвращает пустое значение:
fun mapToScreen(point: GeoPointWithElevation): ScreenPoint?
Вычисление точки экрана, соответствующей указанной точке карты с высотой.
Функция возвращает пустое значение:
- point имеет невалидное значение (latitude лежит вне диапазона -90;90, longitude лежит вне диапазона -180;180 или elevation отрицателен).
- если указанная точка карты находится выше плоскости проекции карты на экран.
- если указанная точка карты находится слишком далеко за пределами экрана и возникает переполнение типа.
fun screenToMapClipped(point: ScreenPoint): GeoPoint
Вычисление ближайшей точки карты к проекции указанной точки экрана.
PublicBriefRouteInfo
Базовая информация о маршруте на общественном транспорте.
PublicBriefRouteInfo(publicTransportInfos: List<PublicBriefRouteTransportInfo>)
Базовая информация о маршруте на общественном транспорте.
publicTransportInfos
val publicTransportInfos
Описание способов проезда на общественном транспорте.
PublicBriefRouteTransportInfo
Описание общественного транспортного средства.
PublicBriefRouteTransportInfo(
type: PublicTransportType = PublicTransportType.BUS,
names: List<String>,
color: Int?,
routeLogo: String
)
Описание общественного транспортного средства.
val type
Тип общественного транспортного средства.
val names
Названия маршрутов общественного транспорта, на которых происходит проезд.
val color
Argb представление цвета, ассоциированного с данным видом общественного транспорта, например, цвет линии метро. При отсутствии информации о цвете в поле будет значение null.
val routeLogo
Идентификатор иконки для остановок маршрута. Пустая строка, если информация недоступна. Техническое поле.
PublicRoutePart
Описание участка маршрута на общественном транспорте.
PublicRoutePart(transports: List<PublicTransportInfo>, intermediateStops: List<PublicTransportStop>)
Описание участка маршрута на общественном транспорте.
val transports
Виды общественного транспорта, на котором можно проехать данный участок маршрута.
Если список пустой, то данный участок маршрута предлагается преодолеть на личном или арендуемом транспорте либо пешком.
val intermediateStops
Промежуточные остановки, которые транспорт проедет прежде, чем доберется до точки пересадки.
Остановки отсортированы в порядке следования по маршруту.
На этих остановках не нужно выходить.
Начальная и конечная остановки не входят в этот список.
PublicTransportCard
Карточка, отображающая информацию о маршруте на общественном транспорте.
PublicTransportCard(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Карточка, отображающая информацию о маршруте на общественном транспорте.
fun onAttachedToWindow(): Unit
var model
PublicTransportCardModel
Модель для PublicTransportCard.
PublicTransportCardModel(
route: TrafficRoute,
context: Context,
startName: String? = null,
finishName: String? = null
)
Модель для PublicTransportCard.
PublicTransportInfo
Описание общественного транспортного средства.
PublicTransportInfo(
type: PublicTransportType = PublicTransportType.BUS,
names: List<String>,
suggestedCarNumbers: List<Int>,
boardingSuggest: String,
color: Int?,
routeLogo: String
)
Описание общественного транспортного средства.
type
names
suggestedCarNumbers
boardingSuggest
color
routeLogo
val type
Тип общественного транспортного средства.
val names
Названия маршрутов общественного транспорта, на которых происходит проезд.
val suggestedCarNumbers
Номера вагонов, в которые рекомендуется посадка.
Если транспортное средство состоит из одного вагона или можно садиться в любой вагон, то этот список будет пустым.
val boardingSuggest
Текстовое описание вагонов, в которые рекомендуется посадка.
val color
Argb представление цвета, ассоциированного с данным видом общественного транспорта, например, цвет линии метро. При отсутствии информации о цвете в поле будет значение null.
val routeLogo
Идентификатор иконки для остановок маршрута. Пустая строка, если информация недоступна. Техническое поле.
PublicTransportRouteSearchOptions
Параметры поиска маршрута на общественном транспорте.
PublicTransportRouteSearchOptions(
startTime: TimePoint? = null,
useSchedule: Boolean = false,
transportTypes: EnumSet<PublicTransportType> = EnumSet.noneOf(PublicTransportType::class.java)
)
Параметры поиска маршрута на общественном транспорте.
val startTime
Время в UTC, на которое нужно построить маршрут. Если не задано, используется текущее время.
val useSchedule
Учёт расписания движения общественного транспорта при построении маршрута.
val transportTypes
Типы общественного транспорта. Если не заполнены, маршруты будут строиться для всех поддерживаемых типов общественного транспорта.
PublicTransportStop
Описание остановки общественного транспорта.
PublicTransportTransfer
Описание способа добраться на общественном транспорте до следующей точки пересадки.
PublicTransportTransfer(
startPointName: String,
finishPointName: String,
routeParts: List<PublicRoutePart>
)
Описание способа добраться на общественном транспорте до следующей точки пересадки.
val startPointName
Название точки, из которой начинается движение для данного участка маршрута.
val finishPointName
Название точки назначения для данного участка маршрута.
val routeParts
Описание участка маршрута на общественном транспорте, по которому можно добраться до следующей точки пересадки.
Все участки маршрута из этого списка проходят по одной и той же линии геометрии.
Если список пустой, то данный участок маршрута предлагается преодолеть на личном или арендуемом транспорте либо пешком.
PublicTransportTransferRouteLongAttribute
Контейнер, который хранит протяженный атрибут маршрута. Каждый элемент хранится в виде пары, состоящей из точки и значения элемента атрибута. Действие атрибута начинается с данной точки и заканчивается в следущей точке, начиная с которой начинается действие атрибута следующего элемента.
fun entry(point: RoutePoint): PublicTransportTransferRouteLongEntry?
Элемент, в который попадает заданная точка.
fun entries(begin: RoutePoint, end: RoutePoint): List<PublicTransportTransferRouteLongEntry>
Элементы, частично или полностью покрываемые отрезком begin,end.
PublicTransportTransferRouteLongEntry
Протяженный элемент маршрута - отрезок и значение на нем.
PublicTransportTransferRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: PublicTransportTransfer
)
Протяженный элемент маршрута - отрезок и значение на нем.
PurposeCode
Код назначения здания.
Range
Описывает набор непрерывных или дискретных упорядоченных значений.
fun match(borders: Function1, orderedValues: Function1): T
fun toString(): String
fun hashCode(): Int
RangeFilter
Фильтр диапазонов значений.
RangeWidget
Виджет для представления непрерывного или дискретного набора упорядоченных значений.
RemainingRouteInfoControl
Контрол UI навигатора, отображающий информацию об оставшемся расстоянии до конца маршрута и об оставшемся времени движения по маршруту.
Remover
Объект для удаления пользовательского контента.
fun remove(): Future<ActionResult>
Удаление контента.
действие доступно для контента, автором которого является пользователь.
RenderedObject
Отображаемый объект карты.
RenderedObjectInfo
Подробная информация об отображаемом объекте карты.
RenderedObjectInfo(
closestViewportPoint: ScreenPoint,
closestMapPoint: GeoPointWithElevation,
item: RenderedObject
)
Подробная информация об отображаемом объекте карты.
Reviews
Отзывы.
RoadCameraInfo
Информация о камере.
RoadCameraInfo(purposes: EnumSet<CameraPurpose>, speedLimit: Short?)
Информация о камере.
val purposes
Назначения камеры.
Могут отсутствовать, если нет информации, или если камеру добавил пользователь.
val speedLimit
Ограничение скорости в км/ч.
На текущий момент доступно только для камер, контролирующих скорость и среднюю скорость на участке.
Может отсутствовать и для камер контроля скорости, если значение неизвестно.
RoadEvent
Дорожное событие.
val type
Тип события.
val name
Локализованное название события.
val author
Информация о пользователе, добавившем событие.
val timestamp
Временная метка создания события.
val location
Координаты события.
val description
Пользовательское описание дорожного события.
val cameraInfo
Информация о камере.
Доступна только для событий типа "Camera".
val schedule
Расписание.
На текущий момент доступно только для перекрытий, и даже для них может отсутствовать.
val lanes
Затронутые событием полосы.
На текущий момент могут быть проставлены только у пользовательских событий.
val availableActions
Список доступных действий с событием.
val remover
Получение объекта для удаления события.
RoadEventAction
Действие события.
fun set(): Future<ActionResult>
Применение действия (например, добавление отметки "нравится", подтверждение события).
Есть действия, противоположные друг другу, например, "нравится" и "не нравится". Если для события доступны оба действия, вызов метода сбрасывает применение противоположного - невозможно одновременно поставить "нравится" и "не нравится".
fun reset(): Future<ActionResult>
Отмена действия (например, сброс отметки "нравится", сброс подтверждения события).
Есть действия, противоположные друг другу, например, "нравится" и "не нравится". Если для события доступны оба действия, вызов метода не вызывает применение противоположного действия.
RoadEventActionButton
Кнопка действия над дорожным событием (подтвердить, поставить "нравится" и т.д.).
RoadEventActionButton(model: RoadEventActionButtonModel, context: Context)
Кнопка действия над дорожным событием (подтвердить, поставить "нравится" и т.д.).
val model
RoadEventActionInfo
Информация о действии.
RoadEventActionInfo(state: RoadEventActionState, count: Int?)
Информация о действии.
RoadEventCard
Карточка, отображающая информацию о дорожном событии.
RoadEventCard(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Карточка, отображающая информацию о дорожном событии.
RoadEventCardModel
Модель карточки дорожного события.
RoadEventCardModel(
event: RoadEvent,
photoSize: StatefulChannel<ScreenSize>,
context: Context
)
Модель карточки дорожного события.
fun close(): Unit
val name
Название, например, "Перекрытие".
val description
Описание, например, "Ремонтные работы".
val lanes
Затронутые событием полосы, например, "Левый ряд, средний ряд".
val schedule
Расписание, например, "10 октября 08:00 – 15 октября 23:30".
val creationTime
Время создания, например, "5 часов назад", "5 августа", "10 декабря 2020 г".
val author
Автор, например, "2ГИС".
val photoChannel
Фотография.
val actionCompletedChannel
Уведомление о завершении действия.
val removeCompletedChannel
Уведомление о завершении удаления события.
val actions
Действия.
RoadEventManager
Объект для создания транспортных событий.
RoadEventManager(context: Context)
Получение объекта для создания дорожных событий.
context
fun createAccident(
location: GeoPoint,
lanes: EnumSet<Lane>,
description: String
): Future<AddEventResult>
Создание события "ДТП".
location
Местоположение события.
lanes
Полосы дороги, затрагиваемые событием.
description
Пользовательское описание события.
fun createCamera(location: GeoPoint, description: String): Future<AddEventResult>
Создание события "Камера".
location
Местоположение события.
description
Пользовательское описание события.
fun createRoadRestriction(location: GeoPoint, description: String): Future<AddEventResult>
Создание события "Перекрытие дорожного движения".
location
Местоположение события.
description
Пользовательское описание события.
fun createComment(location: GeoPoint, description: String): Future<AddEventResult>
Создание события "Комментарий".
location
Местоположение события.
description
Пользовательское описание события.
fun createOther(
location: GeoPoint,
lanes: EnumSet<Lane>,
description: String
): Future<AddEventResult>
Создание события "Другое".
location
Местоположение события.
lanes
Полосы дороги, затрагиваемые событием.
description
Пользовательское описание события.
fun createRoadWorks(
location: GeoPoint,
lanes: EnumSet<Lane>,
description: String
): Future<AddEventResult>
Создание события "Дорожные работы".
location
Местоположение события.
lanes
Полосы дороги, затрагиваемые событием.
description
Пользовательское описание события.
RoadEventMapObject
RoadEventPhoto
Фотография дорожного события.
fun previewUrl(desiredSize: ScreenSize): String
URL превью фотографии.
fun report(): Future<ActionResult>
Отправка жалобы на фотографию.
жалоба на свою фотографию ни к чему не приведёт.
RoadEventRouteAttribute
Контейнер, который описывает точечный атрибут маршрута. Каждый элемент хранится в виде точки на маршруте, в которой этот элемент расположен и значения самого элемента.
fun entries(begin: RoutePoint, end: RoutePoint): List<RoadEventRouteEntry>
Элементы, попадающие в отрезок [begin, end).
fun findNearBackward(point: RoutePoint): RoadEventRouteEntry?
Найти ближайший элемент, позиция которого < = point.
Сложность операции log2(N), где N = size.
fun findNearForward(point: RoutePoint): RoadEventRouteEntry?
Найти ближайший элемент, позиция которого >= point.
Сложность операции log2(N), где N = size.
RoadEventRouteEntry
Элемент маршрута - точка и значение в ней.
RoadEventRouteEntry(point: RoutePoint, value: BriefRoadEvent)
Элемент маршрута - точка и значение в ней.
RoadEventSource
Интерфейс класса, управляющего отображением дорожных событий (tUGC) на карте.
RoadEventSource(context: Context)
Создание источника, отображающего дорожные события на карте.
context
fun setHighlighted(directoryObjectIds: List<DgisObjectId>, highlighted: Boolean): Unit
Установка или снятие выделения дорожных событий.
добавляет событию атрибут "selected", который можно использовать в стилях.
directoryObjectIds
Идентификаторы изменяемых событий. Можно получить из RoadEventMapObject.
highlighted
Установка или снятие выделения.
RoadMacroGraph
Пакет глобального дорожного графа, используется для построения проезда между двумя загруженными offline-территориями.
RoadRuleRouteLongAttribute
Контейнер, который хранит протяженный атрибут маршрута. Каждый элемент хранится в виде пары, состоящей из точки и значения элемента атрибута. Действие атрибута начинается с данной точки и заканчивается в следущей точке, начиная с которой начинается действие атрибута следующего элемента.
fun entry(point: RoutePoint): RoadRuleRouteLongEntry?
Элемент, в который попадает заданная точка.
fun entries(begin: RoutePoint, end: RoutePoint): List<RoadRuleRouteLongEntry>
Элементы, частично или полностью покрываемые отрезком begin,end.
RoadRuleRouteLongEntry
Протяженный элемент маршрута - отрезок и значение на нем.
RoadRuleRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: RoadRule
)
Протяженный элемент маршрута - отрезок и значение на нем.
RoadSubtypeRouteLongAttribute
Контейнер, который хранит протяженный атрибут маршрута. Каждый элемент хранится в виде пары, состоящей из точки и значения элемента атрибута. Действие атрибута начинается с данной точки и заканчивается в следущей точке, начиная с которой начинается действие атрибута следующего элемента.
fun entry(point: RoutePoint): RoadSubtypeRouteLongEntry?
Элемент, в который попадает заданная точка.
fun entries(begin: RoutePoint, end: RoutePoint): List<RoadSubtypeRouteLongEntry>
Элементы, частично или полностью покрываемые отрезком begin,end.
RoadSubtypeRouteLongEntry
Протяженный элемент маршрута - отрезок и значение на нем.
RoadSubtypeRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: RoadSubtype
)
Протяженный элемент маршрута - отрезок и значение на нем.
RoadSurfaceRouteLongAttribute
Контейнер, который хранит протяженный атрибут маршрута. Каждый элемент хранится в виде пары, состоящей из точки и значения элемента атрибута. Действие атрибута начинается с данной точки и заканчивается в следущей точке, начиная с которой начинается действие атрибута следующего элемента.
fun entry(point: RoutePoint): RoadSurfaceRouteLongEntry?
Элемент, в который попадает заданная точка.
fun entries(begin: RoutePoint, end: RoutePoint): List<RoadSurfaceRouteLongEntry>
Элементы, частично или полностью покрываемые отрезком begin,end.
RoadSurfaceRouteLongEntry
Протяженный элемент маршрута - отрезок и значение на нем.
RoadSurfaceRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: RoadSurface
)
Протяженный элемент маршрута - отрезок и значение на нем.
RoadTypeRouteLongAttribute
Контейнер, который хранит протяженный атрибут маршрута. Каждый элемент хранится в виде пары, состоящей из точки и значения элемента атрибута. Действие атрибута начинается с данной точки и заканчивается в следущей точке, начиная с которой начинается действие атрибута следующего элемента.
fun entry(point: RoutePoint): RoadTypeRouteLongEntry?
Элемент, в который попадает заданная точка.
fun entries(begin: RoutePoint, end: RoutePoint): List<RoadTypeRouteLongEntry>
Элементы, частично или полностью покрываемые отрезком begin,end.
RoadTypeRouteLongEntry
Протяженный элемент маршрута - отрезок и значение на нем.
RoadTypeRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: RoadType
)
Протяженный элемент маршрута - отрезок и значение на нем.
RotateMapToNorthEvent
RotationSettings
Настройки обработки вращения карты.
val angleDiffDeg
Порог изменения угла, в градусах, по достижению которого начнёт отправлять сообщения вращения. Используется, если масштабирование неактивно.
val distanceDiffMm
Порог среднего радиального сдвига точек, в миллиметрах, по достижению которого начнёт отправлять сообщения вращения. Используется, если масштабирование неактивно.
val angleDiffInScalingDeg
Порог изменения угла, в градусах, по достижению которого начнёт отправлять сообщения вращения. Используется, если масштабирование активно.
val distanceDiffInScalingMm
Порог среднего радиального сдвига точек, в миллиметрах, по достижению которого начнёт отправлять сообщения вращения. Используется, если масштабирование активно.
Route
Класс, описывающий маршрут. Маршрут представляет собой набор атрибутов, каждый из которых представляет собой контейнер типа RouteAttribute или RouteLongAttribute, в котором хранятся элементы атрибутов маршрута. Атрибуты маршрута делятся на точечные и протяженные. Точечные атрибуты (например, точки геометрии или лежачие полицейские) задаются в виде пары из RoutePoint и значения атрибута. Протяженные атрибуты (например, ширина проезжей части или ограничение скорости) задаются в виде пары из RoutePoint, которая указывает на начало действия атрибута и значения атрибута. В конце маршрута ставится терминатор. Например, пусть ширина проезжей части задана в виде набора пар {{0m, 3m}, {10m, 7m}, {20m, 5m}, {30m, 0m}}, тогда первые 10 метров маршрута проезжая часть имеет ширину 3 метра, на интервале [10м., 20м.) - 7м., с 20м. до конца маршрута - 5м.
val geometry
Геометрия маршрута.
Не гарантируется, что RoutePoint у точек геометрии будет совпадать с RoutePoint у элементов других атрибутов, поэтому для того, чтобы вычислить географическую координату у элемента атрибута, не нужно искать в геометрии элемент, RoutePoint которого совпадает с RoutePoint элемента атрибута, вместо этого нужно воспользоваться функцией calculate_geo_point.
val instructions
Инструкции, которые необходимо выполнить для движения по маршруту.
val intermediatePoints
Промежуточные точки, через которые проходит маршрут. Маршрут может проходить не прямо через промежуточную точку, а рядом с ней. В значении атрибута хранится координата, в которую была установлена промежуточная точка, в ключе - координата проекции промежуточной точки на маршрут.
val altitudes
Высоты на маршруте.
val badRoads
Плохая дорога (на дороге присутствуют кочки и ямы, которые препятствуют проезду).
val obstacles
Препятствия на маршруте.
val roadNames
Названия дорог/улиц.
val settlements
Признак того, что участок маршрута проходит по населённому пункту.
val transportTypes
Вид транспорта, для которого построен участок маршрута.
val cameras
Дорожные камеры.
val carriagewaysWidth
Ширина проезжей части в метрах. 0 - ширина неизвестна.
val exitSigns
Знаки съездов.
val humps
Искусственные неровности.
val lanes
Полосы движения.
val levels
Этажи зданий.
val maxSpeedLimits
Ограничения максимальной допустимой скорости.
0 - ограничение скорости неизвестно.
val roadRules
Сторона движения.
val roadSubtypes
Дополнительное описание типа дороги, по которой пролегает маршрут.
val roadSurfaces
Покрытие дороги.
val roadTypes
Тип дороги, по которой пролегает маршрут.
val tolls
Участки маршрута, пролегающие по платным дорогам.
val truckData
Признак наличия или отсутствия данных для грузовой навигации.
val truckPassZoneIds
Пропускные зоны для грузового транспорта.
val truckRestrictedAreas
Признак действия знака запрета проезда грузового транспорта.
val vehicleRestrictedAreas
Признак действия знака запрета проезда любого автотранспорта (перекрытия).
val bicycleLanes
Признак наличия выделенной велополосы.
val trafficLights
Признак наличия светофоров.
val publicTransportTransfers
Описание способов перемещения на общественном транспорте между точками пересадок.
RouteBuildOptions
Структура, которая описывает параметры построения маршрута в навигаторе.
RouteCamera
Структура, описывающая дорожную камеру.
RouteCamera(
purposes: EnumSet<RouteCameraPurpose>,
rangeAgainst: RouteDistance,
rangeAlong: RouteDistance,
direction: RouteCameraDirection = RouteCameraDirection.AGAINST
)
Структура, описывающая дорожную камеру.
purposes
rangeAgainst
rangeAlong
direction
RouteDistance
Расстояние вдоль маршрута.
fun absoluteValue(): RouteDistance
operator fun plus(other: RouteDistance): RouteDistance
operator fun minus(other: RouteDistance): RouteDistance
RouteEditor
Интерфейс для редактора маршрута. Редактор маршрута получает точки начала и конца маршрута, строит маршруты и через каналы оповещает об их обновлениях и перестроениях.
Все методы этого интерфейса вызываются из одного потока.
fun setRouteParams(routeParams: RouteEditorRouteParams): Unit
Установка параметров редактора маршрута. Запускает поиск нового маршрута согласно переданным параметрам.
fun setActiveRouteIndex(index: RouteIndex): Unit
Установка индекса активного маршрута.
val routesInfoChannel
Канал, через который можно следить за обновлениями информации о маршрутах, которыми оперирует редактор.
val routesInfo
Канал, через который можно следить за обновлениями информации о маршрутах, которыми оперирует редактор.
val activeRouteIndexChannel
Канал, через который можно следить за обновлениями индекса активного маршрута. В случае отсутствия маршрутов в этот канал помещается null.
val activeRouteIndex
Канал, через который можно следить за обновлениями индекса активного маршрута. В случае отсутствия маршрутов в этот канал помещается null.
RouteEditorRouteParams
Информация о параметрах маршрута.
RouteEditorRouteParams(
startPoint: RouteSearchPoint,
finishPoint: RouteSearchPoint,
routeSearchOptions: RouteSearchOptions,
intermediatePoints: List<RouteSearchPoint> = listOf()
)
Информация о параметрах маршрута.
startPoint
finishPoint
routeSearchOptions
intermediatePoints
RouteEditorRoutesInfo
Информация о маршрутах, которыми оперирует редактор.
RouteEditorRoutesInfo(routes: List<TrafficRoute>, routeParams: RouteEditorRouteParams)
Информация о маршрутах, которыми оперирует редактор.
RouteEditorSource
Интерфейс класса, управляющего отображением маршрутов на карте.
RouteEditorSource(
context: Context,
routeEditor: RouteEditor,
activeDisplayFlags: EnumSet?<RouteMapObjectDisplayFlag> = null,
inactiveDisplayFlags: EnumSet?<RouteMapObjectDisplayFlag> = null,
activeCalloutLabelFlags: EnumSet?<RouteMapObjectCalloutLabelFlag> = null,
inactiveCalloutLabelFlags: EnumSet?<RouteMapObjectCalloutLabelFlag> = null,
calloutLabelDisplayMode: RouteMapObjectCalloutLabelDisplayMode = RouteMapObjectCalloutLabelDisplayMode.ABSOLUTE_VALUES,
activePermanentDisplayFlags: EnumSet?<RouteMapObjectPermanentDisplayFlag> = null,
inactivePermanentDisplayFlags: EnumSet?<RouteMapObjectPermanentDisplayFlag> = null
)
Функция создания IRouteEditorSource.
context
routeEditor
activeDisplayFlags
inactiveDisplayFlags
activeCalloutLabelFlags
inactiveCalloutLabelFlags
calloutLabelDisplayMode
activePermanentDisplayFlags
inactivePermanentDisplayFlags
fun setRoutesVisible(visible: Boolean): Unit
Включить или выключить отображение маршрутов на карте.
fun setShowOnlyActiveRoute(showOnlyActiveRoute: Boolean): Unit
Отображать на карте все маршруты (false) или только текущий активный маршрут (true).
fun setPassedDistanceVisualization(passedDistanceVisualization: RouteMapObjectPassedDistanceVisualization): Unit
Изменить способ визуализации расстояния, пройденного вдоль маршрута.
val objects
Объекты маршрута на карте.
val routeSourceSettings
Настройки отображения маневров на маршруте.
var activeDisplayFlags
Флаги отображения активного маршрута. См. IRouteMapObject::display_flags.
var inactiveDisplayFlags
Флаги отображения неактивных маршрутов. См. IRouteMapObject::display_flags.
var activeCalloutLabelFlags
Флаги, включающие отображение содержимого в баблах активного маршрута. См. IRouteMapObject::callout_label_flags.
var inactiveCalloutLabelFlags
Флаги, включающие отображение содержимого в баблах неактивных маршрутов. См. IRouteMapObject::callout_label_flags.
var calloutLabelDisplayMode
Режим отображения значений в баблах маршрутов. См. IRouteMapObject::callout_label_display_mode.
var activePermanentDisplayFlags
Флаги, исключающие скрытие компонентов активного маршрута с карты. См. IRouteMapObject::permanent_display_flags.
var inactivePermanentDisplayFlags
Флаги, исключающие скрытие компонентов неактивных маршрутов с карты. См. IRouteMapObject::permanent_display_flags.
RouteExitSign
Информация о знаке съезда.
RouteExitSign(
type: RouteExitSignType = RouteExitSignType.UNDEFINED,
roadNameTable: RouteExitSignTable,
roadNumberTable: RouteExitSignTable?
)
Информация о знаке съезда.
RouteExitSignRouteAttribute
Контейнер, который описывает точечный атрибут маршрута. Каждый элемент хранится в виде точки на маршруте, в которой этот элемент расположен и значения самого элемента.
fun entries(begin: RoutePoint, end: RoutePoint): List<RouteExitSignRouteEntry>
Элементы, попадающие в отрезок [begin, end).
fun findNearBackward(point: RoutePoint): RouteExitSignRouteEntry?
Найти ближайший элемент, позиция которого < = point.
Сложность операции log2(N), где N = size.
fun findNearForward(point: RoutePoint): RouteExitSignRouteEntry?
Найти ближайший элемент, позиция которого >= point.
Сложность операции log2(N), где N = size.
RouteExitSignRouteEntry
Элемент маршрута - точка и значение в ней.
RouteExitSignRouteEntry(point: RoutePoint, value: RouteExitSign)
Элемент маршрута - точка и значение в ней.
RouteExitSignTable
Информация о табличке съезда.
RouteExitSignTable(backgroundColor: RouteExitSignTableColor = RouteExitSignTableColor.UNDEFINED, text: String)
Информация о табличке съезда.
RouteIndex
Индекс активного маршрута.
RouteInfo
Описание маршрута с манёврами.
val route
Маршрут.
val routeBuildOptions
Параметры построения маршрута в навигаторе. Значение равное null означает, что у маршрута отсутствует конечная точка. В этом случае, на основании дорожного графа и параметров движения пользователя, вычисляется участок дороги, по которому предположительно движется пользователь и возвращается в виде маршрута в поле route. Следовательно, такой "маршрут" не может содержать инструкции и последняя точка в этом "маршруте" не является точкой назначения, в которую движется пользователь, а просто является точкой, до которой удалось предугадать движение пользователя. Куда он поедет дальше - неизвестно. Такой режим работы навигатора называется режим ведения без маршрута или free roam.
RouteInfoCalloutMapObject
Объект бабла с информацией о длине и/или длительности маршрута на карте.
RouteInstruction
Инструкция, которую необходимо выполнить для движения по маршруту.
RouteInstruction(
roadName: String,
range: RouteDistance,
extraInstructionInfo: ExtraInstructionInfo
)
Инструкция, которую необходимо выполнить для движения по маршруту.
val roadName
Название дороги, на которой окажется пользователь после совершения манёвра.
val range
Расстояние после точки инструкции, на протяжении которого считается, что пользователь находится в зоне действия инструкции.
val extraInstructionInfo
Специфичная для конкретного типа инструкции информация.
RouteLane
Структура, описывающая одну полосу движения.
RouteLane(
routeManeuver: RouteLaneManeuver = RouteLaneManeuver.UNDEFINED,
maneuvers: EnumSet<RouteLaneManeuver>,
speedLimit: Float = 0.0f,
prohibited: Boolean = false,
onlyPublicTransport: Boolean = false
)
Структура, описывающая одну полосу движения.
routeManeuver
maneuvers
speedLimit
prohibited
onlyPublicTransport
val routeManeuver
Манёвр, который необходимо совершить для движения по маршруту.
val maneuvers
Допустимые манёвры на полосе.
val speedLimit
Максимальная разрешенная скорость на полосе, м/с. 0 - ограничение скорости неизвестно.
val prohibited
Проезд по полосе запрещён.
val onlyPublicTransport
Полоса для общественного транспорта.
RouteLaneSign
Описание полос движения.
RouteLaneSign(
lanes: List<RouteLane>,
signStartPoint: RoutePoint?,
signPoint: RoutePoint?,
signEndPoint: RoutePoint?
)
Описание полос движения.
val lanes
Полосы движения для автомобилей на участке дороги. Перечислены в порядке следования от середины проезжей части к обочине.
Если количество полос неизвестно либо в направлении маршрута на дороге находится одна полоса движения, то этот массив будет пустым.
val signStartPoint
Точка на маршруте, в которой начинается действие знака, регулирующего движение по полосам. null, если положение начала действия знака неизвестно.
val signPoint
Точка на маршруте, в которой установлен знак, регулирующий движение по полосам. null, если положение знака неизвестно.
val signEndPoint
Точка на маршруте, в которой заканчивается действие знака, регулирующего движение по полосам. null, если положение окончания действия знака неизвестно.
RouteLevelInfo
Информация об этаже здания, соответствующая участку маршрута.
val beginId
Идентификатор этажного плана в начальной точке участка маршрута. Отсутствует, если точка не находится в здании.
val endId
Идентификатор этажного плана в конечной точке участка маршрута. Отсутствует, если точка не находится в здании.
val name
Название этажа. Пусто, если участок маршрута соединяет разные этажи.
RouteLevelInfoRouteLongAttribute
Контейнер, который хранит протяженный атрибут маршрута. Каждый элемент хранится в виде пары, состоящей из точки и значения элемента атрибута. Действие атрибута начинается с данной точки и заканчивается в следущей точке, начиная с которой начинается действие атрибута следующего элемента.
fun entry(point: RoutePoint): RouteLevelInfoRouteLongEntry?
Элемент, в который попадает заданная точка.
fun entries(begin: RoutePoint, end: RoutePoint): List<RouteLevelInfoRouteLongEntry>
Элементы, частично или полностью покрываемые отрезком begin,end.
RouteLevelInfoRouteLongEntry
Протяженный элемент маршрута - отрезок и значение на нем.
RouteLevelInfoRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: RouteLevelInfo
)
Протяженный элемент маршрута - отрезок и значение на нем.
RouteMapObject
Объект маршрута на карте.
RouteMapObject(
trafficRoute: TrafficRoute,
isActive: Boolean,
index: RouteIndex,
displayFlags: EnumSet?<RouteMapObjectDisplayFlag> = null,
calloutLabelFlags: EnumSet?<RouteMapObjectCalloutLabelFlag> = null,
calloutLabelDisplayMode: RouteMapObjectCalloutLabelDisplayMode = RouteMapObjectCalloutLabelDisplayMode.ABSOLUTE_VALUES,
permanentDisplayFlags: EnumSet?<RouteMapObjectPermanentDisplayFlag> = null
)
trafficRoute
isActive
index
displayFlags
calloutLabelFlags
calloutLabelDisplayMode
permanentDisplayFlags
val displayFlagsChannel
Набор флагов для отображения различных частей маршрута. Если не задан, используется логика отображения на основе статуса активности маршрута.
var displayFlags
Набор флагов для отображения различных частей маршрута. Если не задан, используется логика отображения на основе статуса активности маршрута.
val permanentDisplayFlagsChannel
Набор флагов для предотвращения скрытия различных составных частей маршрута с карты при обновлении пройденного вдоль маршрута расстояния. Если не задан, то при обновлении пройденного вдоль маршрута расстояния с карты скрываются все элементы маршрута, попадающие в неотображаемую часть маршрута.
var permanentDisplayFlags
Набор флагов для предотвращения скрытия различных составных частей маршрута с карты при обновлении пройденного вдоль маршрута расстояния. Если не задан, то при обновлении пройденного вдоль маршрута расстояния с карты скрываются все элементы маршрута, попадающие в неотображаемую часть маршрута.
val isActiveChannel
Статус активности маршрута.
var isActive
Статус активности маршрута.
val route
Маршрут.
val routeIndex
Индекс маршрута в редакторе маршрута.
val passedDistanceChannel
Пройденное расстояние вдоль маршрута.
var passedDistance
Пройденное расстояние вдоль маршрута.
val passedDistanceVisualizationChannel
var passedDistanceVisualization
val calloutPositionChannel
Положение бабла маршрута.
val calloutPosition
Положение бабла маршрута.
val calloutLabelFlagsChannel
Набор флагов для отображения содержимого баблов маршрута. Если не задан, то для активного маршрута отображается и время движения по маршруту, и его длина, а для неактивных маршрутов - только время движения.
var calloutLabelFlags
Набор флагов для отображения содержимого баблов маршрута. Если не задан, то для активного маршрута отображается и время движения по маршруту, и его длина, а для неактивных маршрутов - только время движения.
val calloutLabelDisplayModeChannel
Режим отображения значений в баблах маршрута. По умолчанию значения отображаются в виде абсолютных величин.
var calloutLabelDisplayMode
Режим отображения значений в баблах маршрута. По умолчанию значения отображаются в виде абсолютных величин.
val lanesCalloutPositionsChannel
Положения баблов полосности. Возвращаются только актуальные положения для текущего пройденного расстояния по маршруту и только если источник, в который помещён объект, работает в режиме навигации.
val lanesCalloutPositions
Положения баблов полосности. Возвращаются только актуальные положения для текущего пройденного расстояния по маршруту и только если источник, в который помещён объект, работает в режиме навигации.
RouteMapObjectSource
Источник объектов маршрута на карте.
RouteMapObjectSource(context: Context, routeVisualizationType: RouteVisualizationType = RouteVisualizationType.NORMAL)
Функция создания IRouteMapObjectSource.
fun addObject(item: RouteMapObject): Unit
Добавление объекта маршрута в источник.
fun removeObject(item: RouteMapObject): Unit
Удаление объекта маршрута из источника.
fun replaceObject(oldObject: RouteMapObject, newObject: RouteMapObject): Unit
Замена одного объекта маршрута в источнике на другой. В отличие от удаления и добавления объектов маршрута через последовательные вызовы remove_object и add_object замена одного маршрута на другой выполняется атомарно - старый маршрут удаляется, а новый появляется на карте одновременно.
Если старый маршрут не найден в источнике, то вызов эквивалентен вызову add_object.
fun replaceAllObjects(objects: List<RouteMapObject>): Unit
Замена всех ранее добавленных в источник объектов на передаваемый список объектов. В отличие от удаления и добавления объектов по одному замена выполняется атомарно - старые маршруты удаляются, а новые маршруты появляются на карте одновременно.
RouteMapSettings
Настройки отображения маршрута на карте.
var onRouteDisplayFlags
Флаги отображения маршрута на карте для режима ведения по маршруту. По умолчанию включены все флаги, за исключением флага InactiveFloors.
var freeRoamDisplayFlags
Флаги отображения маршрута на карте для режима free roam. По умолчанию включены флаги Cameras, Humps, Accidents, RoadWorks, Comments, RoadRestrictions, OtherEvents.
var onRoutePermanentDisplayFlags
Флаги, исключающие скрытие различных составных частей маршрута с карты при обновлении пройденного вдоль маршрута расстояния для режима ведения по маршруту. По умолчанию скрываются все элементы маршрута.
var freeRoamPermanentDisplayFlags
Флаги, исключающие скрытие различных составных частей маршрута с карты при обновлении пройденного вдоль маршрута расстояния для режима free roam. По умолчанию скрываются все элементы маршрута.
RouteOverviewControl
UI-элемент, отображаемый в режиме просмотра маршрута.
RoutePoint
Точка на маршруте, задается как расстояние вдоль маршрута относительно начала маршрута.
RoutePoint(distance: RouteDistance)
Точка на маршруте, задается как расстояние вдоль маршрута относительно начала маршрута.
distance
operator fun plus(distance: RouteDistance): RoutePoint
operator fun minus(distance: RouteDistance): RoutePoint
val distance
RoutePointMapObject
Точечный объект, являющийся частью маршрута на карте (например, точка начала или конца маршрута).
val route
Маршрут, часть которого представляет данный точечный объект.
val routeIndex
Индекс маршрута.
val kind
Тип точечного объекта маршрута.
val routePoint
Позиция на маршруте, соответствующая данному точечному объекту.
val pointChannel
Географические координаты, в которых находится данный точечный объект.
var point
Географические координаты, в которых находится данный точечный объект.
RouteSearchOptions
Параметры поиска маршрута.
RouteSearchOptions(pedestrian: PedestrianRouteSearchOptions)
pedestrian
RouteSearchOptions(publicTransport: PublicTransportRouteSearchOptions)
publicTransport
fun match(
bicycle: Function1,
car: Function1,
pedestrian: Function1,
publicTransport: Function1,
scooter: Function1,
taxi: Function1,
truck: Function1
): T
bicycle
car
pedestrian
publicTransport
scooter
taxi
truck
fun toString(): String
fun hashCode(): Int
RouteSearchPoint
Описание точек, по которым строится маршрут.
RouteSearchPoint(
coordinates: GeoPoint,
course: Bearing? = null,
objectId: DgisObjectId = DgisObjectId(objectId = 0, entranceId = 0),
levelId: LevelId? = null
)
Описание точек, по которым строится маршрут.
RouteSourceSettings
Настройки источника маршрута.
fun getLargeScaleMergeDistanceMeters(transportType: TransportType): Float
Минимально допустимое расстояние в метрах между последовательными стрелками манёвров для крупного масштаба. Если расстояние меньше заданного, то стрелки объединяются.
fun setLargeScaleMergeDistanceMeters(distance: Float, transportType: TransportType): Unit
Установить минимально допустимое расстояние в метрах между последовательными стрелками манёвров для крупного масштаба.
distance
Расстояние в метрах.
transportType
Тип транспорта, для которого устанавливается расстояние.
fun getSmallScaleMergeDistanceMeters(transportType: TransportType): Float
Минимально допустимое расстояние в метрах между последовательными стрелками манёвров для мелкого масштаба. Если расстояние меньше заданного, то стрелки объединяются.
fun setSmallScaleMergeDistanceMeters(distance: Float, transportType: TransportType): Unit
Установить минимально допустимое расстояние в метрах между последовательными стрелками манёвров для мелкого масштаба.
distance
Расстояние в метрах.
transportType
Тип транспорта, для которого устанавливается расстояние.
fun getLargeScaleCrossroadsOffsetMeters(transportType: TransportType): Float
Смещение в метрах от точки перекрестка до начала и конца стрелки манёвра для крупного масштаба.
fun setLargeScaleCrossroadsOffsetMeters(offset: Float, transportType: TransportType): Unit
Установить смещение в метрах от точки перекрестка до начала и конца стрелки маневра для крупного масштаба. Позволяет задать размер стрелки маневра.
offset
Смещение в метрах.
transportType
Тип транспорта, для которого устанавливается смещение.
fun getSmallScaleCrossroadsOffsetMeters(transportType: TransportType): Float
Смещение от точки перекрестка до начала и конца стрелки манёвра для мелкого масштаба.
fun setSmallScaleCrossroadsOffsetMeters(offset: Float, transportType: TransportType): Unit
Установить смещение от точки перекрестка до начала и конца стрелки маневра для мелкого масштаба. Позволяет задать размер стрелки маневра.
offset
Смещение в метрах.
transportType
Тип транспорта, для которого устанавливается смещение.
var largeScaleRingroadOffsetMeters
Смещение от точки съезда с кольца до начала и конца стрелки маневра для крупного масштаба. Позволяет задать размер стрелки маневра.
var smallScaleRingroadOffsetMeters
Смещение от точки съезда с кольца до начала и конца стрелки маневра для мелкого масштаба. Позволяет задать размер стрелки маневра.
var calloutVisualizationMode
Режим отображения баблов со временем и длиной маршрута.
RubricId
Идентификатор рубрики.
ScaleMapEvent
Событие изменения масштаба карты.
ScaleMapEvent(zoomDelta: Float, scalingCenter: ScreenPoint? = null)
Конструктор события изменения масштаба.
zoomDelta
Величина, на которую изменится текущее значение масштаба.
scalingCenter
Точка на экране, относительно которой масштабируется карта. Если точка не задана, то масштабирование происходит относительно точки позиции карты.
ScalingSettings
val scaleRatioThreshold
Порог коэффицента масштабирования, по достижению которого начнёт отправляться событие масштабирования. Используется, если вращение неактивно. Множитель должен выйти за пределы (1 / scale_ratio_threshold, scale_ratio_threshold).
val scaleRatioThresholdInRotation
Порог коэффицента масштабирования, по достижению которого начнёт отправляться сообщения масштабирования. Используется, если вращение активно. Множитель должен выйти за пределы (1 / scale_ratio_threshold_in_rotation, scale_ratio_threshold_in_rotation).
Schedule
Расписание действия дорожного события.
Schedule(
startTime: TimePoint?,
finishTime: TimePoint?,
weekTimeIntervals: List<WeekTimeInterval>
)
Расписание действия дорожного события.
ScooterBriefRouteInfo
Базовая информация о маршруте на самокате.
ScooterBriefRouteInfo(length: RouteDistance, landmark: String)
Базовая информация о маршруте на самокате.
ScooterInstructionCrossroad
Описание манёвров при проходе через перекрёсток или по пешеходному переходу.
ScooterInstructionCrossroad(landmark: ScooterInstructionCrossroadLandmark = ScooterInstructionCrossroadLandmark.NONE, maneuvers: List<ScooterInstructionCrossroadManeuver>)
Описание манёвров при проходе через перекрёсток или по пешеходному переходу.
ScooterInstructionCrossroadManeuver
ScooterInstructionCrossroadManeuver(direction: ScooterInstructionCrossroadManeuverDirection = ScooterInstructionCrossroadManeuverDirection.STRAIGHT, turnAngle: Int = 0)
ScooterInstructionFinish
Конец самокатной части маршрута.
ScooterInstructionFinish()
Конец самокатной части маршрута.
ScooterInstructionStart
Начало самокатной части маршрута.
ScooterInstructionStart()
Начало самокатной части маршрута.
ScooterRouteSearchOptions
Параметры поиска маршрута на самокате.
ScooterRouteSearchOptions(
avoidCarRoads: Boolean = true,
avoidStairways: Boolean = true,
avoidUnderpassesAndOverpasses: Boolean = true,
excludedAreas: List<ExcludedArea> = listOf()
)
Параметры поиска маршрута на самокате.
avoidCarRoads
avoidStairways
avoidUnderpassesAndOverpasses
excludedAreas
ScreenDistance
Расстояние между объектами на экране в миллиметрах.
не может быть отрицательным
ScreenDistance(value: Float = 0.0f)
Расстояние между объектами на экране в миллиметрах.
не может быть отрицательным
value
ScreenPoint
Точка в экранных координатах.
Направления осей: x - вправо, y - вниз. (0.0, 0.0) - левый верхний угол левого верхнего пикселя. Целая часть координаты - номер пикселя, дробная - относительное местоположение в пикселе.
ScreenShift
Смещение карты по горизонтали и вертикали в координатном пространстве экрана.
Положительное направление смещения: dx - вправо, dy - вниз.
ScreenSize
Размер в пикселях.
SearchLayout
UI-элемент, предоставлящий поисковую строку и отображение результатов поиска.
fun onAttachedToWindow(): Unit
fun onDetachedFromWindow(): Unit
fun addSearchViewCallback(callback: SearchViewCallback): Unit
Метод, позволящий добавить SearchViewCallback для реагирования на разные состояния и результаты работы поиска и подсказчика.
fun configureSearchEngine(block: Function1): Unit
Метод, позволящий настроить работу поиска и подсказчика. Внутри блока доступны методы интерфeйсы SearchViewConfigurator
fun hideResults(): Unit
Метод позволяет скрыть UI выдачи и оставить только поисковую строку. Работает только для текущего запроса, при его обновлении и появлении новых результатов, выдача снова отобразится.
SearchManager
Поисковик. Основная точка входа для справочного API.
fun suggest(query: SuggestQuery): Future<SuggestResult>
Получить подсказки, соответствующие данному запросу.
query
future, резолвящаяся в ненулевой указатель на результат подбора подсказок или exceptional future, если произошла ошибка при получении подсказок
fun search(query: SearchQuery): Future<SearchResult>
Получить объекты справочника, соответствующие данному запросу.
query
future, резолвящаяся в ненулевой указатель на результат поиска или exceptional future, если произошла ошибка при получении результатов поиска
fun searchById(id: String): Future<DirectoryObject?>
Получить объект справочника по строковому идентификатору.
id
future, резолвящаяся в указатель на объект справочника. Если объект не найден, то вернется пустой указатель
fun searchByDirectoryObjectId(objectId: DgisObjectId): Future<DirectoryObject?>
Получить объект справочника по идентификатору.
objectId
future, резолвящаяся в указатель на объект справочника. Если объект не найден, то вернется пустой указатель
@JvmStatic
fun createOnlineManager(context: Context): SearchManager
Создать поисковик, работающий онлайн.
@JvmStatic
fun createOfflineManager(context: Context): SearchManager
Создать поисковик, работающий с предзагруженными данными.
@JvmStatic
fun createSmartManager(context: Context): SearchManager
Создать поисковик, работающий онлайн или с предзагруженными данными в зависимости от наличия подключения к сети интернет.
SearchOptions
Опции для создания SearchLayout.
SearchOptions(
searchType: SearchType = SearchType.defaultSearchType,
pageSize: Int = defaultPageSize,
sortingType: SortingType = SortingType.BY_RELEVANCE,
suggestorType: SuggestorType = SuggestorType.GENERAL
)
Опции для создания SearchLayout.
val searchType
Тип поисковика. Возможные значения зависят от типа поставки SDK. Подробнее см. SearchType. Значение по умолчанию зависит от типа поставки SDK.
val pageSize
Лимит на количество подсказок в suggest'e и результатов в выдаче. Допустимы значения от 1 до 50. По умолчанию: 10.
val sortingType
Тип сортировки поисковой выдачи. По умолчанию: SortingType.BY_RELEVANCE.
val suggestorType
Тип подсказчика. По умолчанию: SuggestorType.GENERAL.
SearchQuery
Поисковый запрос.
SearchQueryBuilder
Построитель поисковых запросов. Поиск осуществляется по глобальному индексу, а также по локальным индексам сегментов, где сегмент - это некоторый кусок разбиения глобальной карты. Процедура выбора сегментов для поиска осуществляется следующими способами (по убыванию приоритета):
TODO: Данное условие пока не работает. Будет исправлено в ближайших релизах.
fun setSpatialRestriction(spatialRestriction: List?<GeoPoint>): SearchQueryBuilder
Задать ограничение области поиска в форме полигона. Первая и последняя точки полигона не обязаны совпадать.
по умолчанию ограничение отсутствует
fun setAreaOfInterest(rect: GeoRect?): SearchQueryBuilder
Задать прямоугольную область интереса в географических координатах. Типичным значением является visible_rect из ICamera - объемлющий прямоугольник области просмотра.
fun setAllowedResultTypes(allowedResultTypes: List<ObjectType>): SearchQueryBuilder
Задать типы объектов, разрешенные в результате запроса.
по умолчанию все, кроме Route
fun setPageSize(pageSize: Int): SearchQueryBuilder
Задать предпочитаемое количество элементов на странице результатов. Допустимы значения из диапазона 1;50
по умолчанию 10
fun setDirectoryFilter(filter: DirectoryFilter): SearchQueryBuilder
Задать фильтрацию для поискового запроса.
fun setSortingType(sortingType: SortingType): SearchQueryBuilder
Задать сортировку для поискового запроса.
@JvmStatic
fun fromQueryText(queryText: String): SearchQueryBuilder
Начать построение текстового поискового запроса c указанным текстом.
@JvmStatic
fun fromRubricIds(rubricIds: List<RubricId>): SearchQueryBuilder
Начать построение поискового запроса на основе идентификаторов рубрик.
@JvmStatic
fun fromQueryTextAndRubricIds(queryText: String, rubricIds: List<RubricId>): SearchQueryBuilder
Начать построение текстового поискового запроса с фильтрацией по идентификаторам рубрик.
@JvmStatic
fun fromQuery(query: SearchQuery): SearchQueryBuilder
Начать построение запроса на основе запроса #query для изменения части параметров.
Исходный запрос #query остается без изменений
SearchResult
Результат работы поисковика.
fun markerTitles(objectIds: List<DgisObjectId>): List<Future<List<UIMarkerInfo>>>
Получение текстов маркеров по их идентификаторам. Возвращается vector <future
, так как в облако за запрос можно отправить не более 50 идентификаторов.
val firstPage
Первая страница результатов поиска.
val representativeArea
Прямоугольная область, подходящая для отображения результатов поиска.
val itemMarkerInfos
Асинхронное получение маркеров.
val searchResultType
Тип поискового запроса.
val dynamicFilters
Динамические фильтры для этого запроса.
val actionWidgets
Виджеты быстрых фильтров.
Это так называемые "быстрые фильтры" - фильтры, наиболее интересные пользователю. Их не больше 5.
val mainWidgets
Виджеты фильтров.
val autoUseFirstResult
Признак того, что первый результат пригоден для непосредственного использования.
SegmentGeoPoint
Описывает географическую точку на сегменте и направление сегмента. Геометрия маршрута представляет собой последовательность точек, которые попарно образуют отрезки (сегменты). При этом во всех функциях, работающих с геометрией маршрута считается, что первая точка из образующей отрезок пары входит в этот отрезок, а вторая - нет: [point_1, point_2),[point_2, point_3),...,[point_n-1, point_n)point_last. Последняя точка образует сама с собой отрезок нулевой длины. Т.о. каждая точка маршрута принадлежит ровно одному отрезку. Направление точки point_last не определено.
SegmentGeoPoint(point: GeoPoint, bearing: Bearing)
Описывает географическую точку на сегменте и направление сегмента. Геометрия маршрута представляет собой последовательность точек, которые попарно образуют отрезки (сегменты). При этом во всех функциях, работающих с геометрией маршрута считается, что первая точка из образующей отрезок пары входит в этот отрезок, а вторая - нет: [point_1, point_2),[point_2, point_3),...,[point_n-1, point_n)point_last. Последняя точка образует сама с собой отрезок нулевой длины. Т.о. каждая точка маршрута принадлежит ровно одному отрезку. Направление точки point_last не определено.
SettlementRouteLongAttribute
Контейнер, который хранит протяженный атрибут маршрута. Каждый элемент хранится в виде пары, состоящей из точки и значения элемента атрибута. Действие атрибута начинается с данной точки и заканчивается в следущей точке, начиная с которой начинается действие атрибута следующего элемента.
fun entry(point: RoutePoint): SettlementRouteLongEntry?
Элемент, в который попадает заданная точка.
fun entries(begin: RoutePoint, end: RoutePoint): List<SettlementRouteLongEntry>
Элементы, частично или полностью покрываемые отрезком begin,end.
SettlementRouteLongEntry
Протяженный элемент маршрута - отрезок и значение на нем.
SettlementRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: Settlement
)
Протяженный элемент маршрута - отрезок и значение на нем.
ShowRouteControl
UI-элемент управления перелетом карты к маршруту.
SimpleCheckableItem
Простой отмечаемый элемент из CheckableItemsGroup.
SimpleClusterObject
Кластер простых (simple) объектов-маркеров.
val position
Получение позиции кластера на карте.
val objectCount
Получение количества маркеров в кластере.
val objects
Получение списка маркеров в кластере.
var anchor
Получение и установка точки привязки иконки кластера.
var iconOpacity
Получение и установка прозрачности иконки кластера.
var text
Получение и установка подписи кластера.
var textStyle
Получение и установка стиля подписи кластера.
var iconWidth
Получение и установка целевой ширины кластера, используемой для масштабирования.
var iconMapDirection
Получение и установка угла поворота кластера на карте относительно направления на север, по часовой стрелке.
var animatedAppearance
Получение и установка флага анимируемости появления кластера.
var zIndex
Получение и установка уровня отрисовки объекта.
SimpleClusterOptions
Параметры маркера кластера простых (simple) объектов-маркеров.
SimpleClusterOptions(
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),
iconWidth: LogicalPixel = LogicalPixel(value = 0.0f),
userData: Any? = null,
zIndex: ZIndex = ZIndex(value = 0),
animatedAppearance: Boolean = true,
iconAnimationMode: AnimationMode = AnimationMode.NORMAL
)
Параметры маркера кластера простых (simple) объектов-маркеров.
icon
iconMapDirection
anchor
text
textStyle
iconOpacity
iconWidth
userData
zIndex
animatedAppearance
iconAnimationMode
SimpleMapObject
Объект на карте, для которого можно задавать видимость.
SimulationAutoWithOverSpeed
Структура для задания режима движения с учетом максимальной скорости на ребре маршрута.
SimulationConstantSpeed
Структура для задания режима движения с постоянной скоростью.
SimulationSettings
Настройки симуляции ведения по маршруту.
var speedMode
Режим работы симулятора.
SimulationSpeedMode
SnapToMapLayout
Layout, позволяющий привязать View к точке на карте.
SnapToMapLayout(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Layout, позволяющий привязать View к точке на карте.
fun onAttachedToWindow(): Unit
fun onDetachedFromWindow(): Unit
fun onLayout(
changed: Boolean,
left: Int,
top: Int,
right: Int,
bottom: Int
): Unit
fun generateLayoutParams(attrs: AttributeSet?): LayoutParams?
fun generateLayoutParams(p: LayoutParams?): LayoutParams?
SortingFilter
Фильтр сортировки.
SoundNotificationSettings
Настройки звуковых оповещений в навигаторе По умолчанию все значения категорий звуков оповещений включены. Пользователь может менять значения во время работы с навигатором.
Source
Источник данных на карте.
Это может быть источник пробочных данных, маршрутов, маркеров, произвольных геометрических или других объектов карты. У любого объекта карты могут быть свои свойства. Свойства объекта влияют на то, какие к нему применяются правила и параметры отображения, описаные в стилях карты. Стиль - набор параметров и правил отображения объектов карты, получаемый через редактор стилей и использующийся для отрисовки карты.
Свойства объекта могут быть заданы:
- непосредственно для объекта;
- источнику данных (все объекты, добавленные в источник, получают эти свойства);
- карте (все объекты, добавленные на карту, получают эти свойства);
- стилю (все объекты, к которым применён стиль, получают эти свойства). Список приведён в порядке понижения приоритета применения свойств. Даже если на карту не добавлен ни один источник данных, свойства стиля и карты всё равно повлияют на карту, т.к. есть специальные отображаемые объекты, например - фон.
SpecialSpace
Особое место для парковки.
SpecialSpace(
type: SpecialSpaceType,
name: String,
count: String?
)
Особое место для парковки.
SpeedInfoControl
SpeedRange
Интервал скоростей. Скорости задаются в метрах в секунду.
SpeedRangeToStyleZoom
Соответствие интервала скоростей и стилевого уровня масштабирования.
val range
Интервал скоростей.
val minDistanceToManeuver
Минимальное расстояние до манёвра, при котором должна включаться логика плавного увеличения уровня зума.
val maxDistanceToManeuver
Максимальное расстояние после манёвра, при котором плавное уменьшение уровня зума должно завершиться.
val styleZoom
Стилевой уровень масштабирования.
StringRouteLongAttribute
Контейнер, который хранит протяженный атрибут маршрута. Каждый элемент хранится в виде пары, состоящей из точки и значения элемента атрибута. Действие атрибута начинается с данной точки и заканчивается в следущей точке, начиная с которой начинается действие атрибута следующего элемента.
fun entry(point: RoutePoint): StringRouteLongEntry?
Элемент, в который попадает заданная точка.
fun entries(begin: RoutePoint, end: RoutePoint): List<StringRouteLongEntry>
Элементы, частично или полностью покрываемые отрезком begin,end.
StringRouteLongEntry
Протяженный элемент маршрута - отрезок и значение на нем.
StringRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: String
)
Протяженный элемент маршрута - отрезок и значение на нем.
Style
Стиль с набором свойств объектов карты (cм. ISource).
val styleAttributes
Получение свойств по умолчанию для объектов, к которым применён указанный слой.
StyleBuilder
Конструктор стилей.
fun setStyleAttribute(name: String, value: AttributeValue): StyleBuilder
fun loadStyle(file: File): Future<Style>
Загрузка пользовательского стиля.
StyleLayerId
Идентификатор слоя стиля.
StyleZoom
Стилевой уровень масштабирования.
Задаётся в редакторе стилей и отличается от обычного уровня масштабирования тем, что для одного StyleZoom масштаб карты одинаков независимо от широты. Однако, при Zoom < 9 или при latitude > 60 градусов StyleZoom == Zoom и масштаб карты на разных широтах отличается.
StyleZoom не может быть отрицательным.
StyleZoom(value: Float = 0.0f)
Стилевой уровень масштабирования.
Задаётся в редакторе стилей и отличается от обычного уровня масштабирования тем, что для одного StyleZoom масштаб карты одинаков независимо от широты. Однако, при Zoom < 9 или при latitude > 60 градусов StyleZoom == Zoom и масштаб карты на разных широтах отличается.
StyleZoom не может быть отрицательным.
value
StyleZoomFollowController
Контроллер слежения за стилевым уровнем масштабирования карты.
StyleZoomFollowController(animationDuration: Duration = Duration.ofMilliseconds(300))
Создание контроллера слежения за стилевым уровнем масштабирования карты.
animationDuration
fun setStyleZoom(styleZoom: StyleZoom): Unit
Установка нового значения стилевого уровня масштабирования.
Suggest
Поисковая подсказка.
SuggestHandler
Обработчик выбора подсказки.
SuggestHandler(performSearchHandler: PerformSearchHandler?)
performSearchHandler
SuggestHandler(incompleteTextHandler: IncompleteTextHandler?)
incompleteTextHandler
fun match(
objectHandler: Function1,
performSearchHandler: Function1,
incompleteTextHandler: Function1
): T
objectHandler
performSearchHandler
incompleteTextHandler
fun toString(): String
fun hashCode(): Int
SuggestObjectHandler
Предложен конкретный объект справочника.
val item
Подсказанный объект.
SuggestQuery
Запрос поисковой подсказки.
SuggestQueryBuilder
Построитель запросов к подсказчику.
fun setSpatialRestriction(spatialRestriction: List?<GeoPoint>): SuggestQueryBuilder
Задать ограничение области поиска в форме полигона. Первая и последняя точки полигона не обязаны совпадать.
по умолчанию ограничение отсутствует
fun setAreaOfInterest(rect: GeoRect?): SuggestQueryBuilder
Задать прямоугольную область интереса в географических координатах. Типичным значением является visible_rect из ICamera - объемлющий прямоугольник области просмотра.
fun setAllowedResultTypes(allowedResultTypes: List<SuggestedType>): SuggestQueryBuilder
Задать типы объектов, разрешенные в результате запроса.
по умолчанию все, кроме Route
fun setSuggestorType(suggestorType: SuggestorType): SuggestQueryBuilder
Задать тип подсказчика.
по умолчанию #SuggestorType::General
fun setLimit(limit: Int): SuggestQueryBuilder
Задать желаемое количество подсказок. Допустимы значения из диапазона 1;50
по умолчанию 10
@JvmStatic
fun fromQueryText(queryText: String): SuggestQueryBuilder
Начать построение запроса подсказки для заданного текста и области интереса.
@JvmStatic
fun fromQuery(query: SuggestQuery): SuggestQueryBuilder
Начать построение запроса подсказки на основе запроса #query для изменения части параметров.
Исходный запрос #query остается без изменений
SuggestResult
Результат работы подсказчика.
val suggests
Набор предложенных вариантов подсказок.
набор пуст, если подходящие подсказки не найдены
SystemCertificate
Системный SSL-сертификат.
SystemCertificate()
Системный SSL-сертификат.
SystemMemoryManager
Интерфейс управления использованием системной памяти.
fun reduceMemoryUsage(): Unit
Уменьшение использования памяти путём очистки всевозможных кешей и буферов.
TaxiRouteSearchOptions
Параметры поиска маршрута на такси.
TaxiRouteSearchOptions(car: CarRouteSearchOptions)
Параметры поиска маршрута на такси.
val car
Параметры поиска маршрута, общие с прочими автомобильными.
TerritoriesAlongRouteProvider
Интерфейс для поиска маршрута с учетом пробочных данных.
fun getTerritories(route: Route): Future<List<Territory>>
Возвращает минимально необходимый список офлайн-территорий в порядке следования маршрута.
Territory
Территория. Данные в 2ГИС нарезаны на некоторые неделимые единицы, называемые сегментами. Но для более удобной и гибкой работы с данными для обновления используются не сами сегменты, а их наборы, называемые территориями. Наборы сегментов в двух территориях могут пересекаться, в том числе одна территория может быть целиком вложена в другую.
TerritoryManager
Интерфейс для взаимодействия со списком территорий: Подписки на изменения информации о территориях; Поиска территорий по координатам и геометриям; Подписки на изменения информации о всеобщем прогрессе установки/обновления территорий; Приостановки и возобновления процесса установки/обновления территорий.
fun pause(): Unit
Приостановка всех запущенных операций установки либо обновления территорий.
fun resume(): Unit
Возобновление всех приостановленных операций установки либо обновления территорий.
val territoriesChannel
Канал со списком всех известных территорий. Обновляется при изменении информации о хотя бы одной из территорий, либо при изменении состава списка. Содержимое канала является подмножеством общего списка пакетов, получаемого из IPackageManager::packages. Во избежание рассинхронизации описаний пакетов, не следует использовать данные, получаемые одновременно из нескольких каналов, содержащих подмножества общего списка пакетов.
val territories
Канал со списком всех известных территорий. Обновляется при изменении информации о хотя бы одной из территорий, либо при изменении состава списка. Содержимое канала является подмножеством общего списка пакетов, получаемого из IPackageManager::packages. Во избежание рассинхронизации описаний пакетов, не следует использовать данные, получаемые одновременно из нескольких каналов, содержащих подмножества общего списка пакетов.
TextStyle
Настройки внешнего вида текста.
TextStyle(
fontSize: LogicalPixel = LogicalPixel(value = 8.0f),
color: Color = Color(),
strokeWidth: LogicalPixel = LogicalPixel(value = 0.34999999f),
strokeColor: Color = Color(argb = 4294967295.toInt()),
textPlacement: TextPlacement = TextPlacement.BOTTOM_CENTER,
textOffset: LogicalPixel = LogicalPixel(value = 0.0f),
fontName: String? = null
)
Настройки внешнего вида текста.
fontSize
color
strokeWidth
strokeColor
textPlacement
textOffset
fontName
Tilt
Угол наклона в градусах, где 0 - надир (смотрим вертикально вниз), 90 - горизонт спереди.
Допустимыми считаются значения в интервале от 0 до 60 градусов. В случаях, когда точка позиции камеры расположена ближе к нижнему краю экрана, значение может быть дополнительно уменьшено.
Tilt(value: Float = 0.0f)
Угол наклона в градусах, где 0 - надир (смотрим вертикально вниз), 90 - горизонт спереди.
Допустимыми считаются значения в интервале от 0 до 60 градусов. В случаях, когда точка позиции камеры расположена ближе к нижнему краю экрана, значение может быть дополнительно уменьшено.
value
TiltFollowController
Контроллер слежения за углом наклона карты.
TiltFollowController(styleZoomToTilt: StyleZoomToTiltRelation)
Создание контроллера слежения за углом наклона карты.
styleZoomToTilt
зависимость угла наклона камеры от стилевого уровня масштабирования.
TiltSettings
val lenOnDegreeMm
Расстояние, в мм, на которое нужно сдвинуть пальцы по экрану, чтобы изменить угол наклона камеры на 1 градус. Отрицательное значение прведет к инверсии направления. значение 0 недопустимо.
val horizontalSwerveDeg
Максимальный допустимый угол отклонения линии постановки пальцев от горизонта для вертикального свайпа. В градусах.
val verticalSwerveDeg
Максимально допустимый угол отклонения направления свайпа от вертикальной линии. Измеряется в градусах
val thresholdMm
Порог сдвига взвешенного среднего точек в миллиметрах. Если сдвиг не превысит порог, то событие не отправляется.
val maxParallelsDeviationDeg
Максимально допустимый угол между векторами, до достижения которого они считаются сонаправленными во время распознавания жеста наклона.
TimePoint
Класс, представляющий момент времени.
TimePoint(timeFromEpoch: Duration)
Класс, представляющий момент времени.
timeFromEpoch
fun toString(): String
@JvmStatic
fun ofEpochMilliseconds(milliseconds: Long): TimePoint
@JvmStatic
fun now(): TimePoint
Время, прошедшее с 00:00:00 UTC 1 января 1970 года (Unix-время).
TradeLicense
Лицензия организации.
Traffic
Описание пробочных данных.
TrafficAndParkingControl
TrafficCollector
Интерфейс для управления сервисом сбора информации о транспортном трафике.
Этот интерфейс является потокобезопасным.
TrafficCollector(context: Context)
Функция создания сервиса сбора информации о транспортном трафике. Сервис сбора информации о транспортном трафике анализирует состояние трафика на дороге, по которой движется пользователь и отправляет результаты анализа в анонимизированном виде на сервер.
context
Контекст - окружение, необходимое для работы SDK.
TrafficControl
Контрол пробок. Представляет из себя кнопку, при нажатии на которую переключается видимость пробок на карте. На контроле в виде текста отображается пробочный бал, который так же влияет на цвет: зеленый - низкий уровень пробок, желтный - средний, красный - высокий. В зависимости от состояние меняется внешний вид контрола, подробнее см. TrafficControlStatus.
TrafficControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Контрол пробок. Представляет из себя кнопку, при нажатии на которую переключается видимость пробок на карте. На контроле в виде текста отображается пробочный бал, который так же влияет на цвет: зеленый - низкий уровень пробок, желтный - средний, красный - высокий. В зависимости от состояние меняется внешний вид контрола, подробнее см. TrafficControlStatus.
TrafficControl
Контрол пробок. Представляет из себя кнопку, при нажатии на которую переключается видимость пробок на карте. На контроле в виде текста отображается пробочный бал, который так же влияет на цвет: зеленый - низкий уровень пробок, желтный - средний, красный - высокий. В зависимости от состояние меняется внешний вид контрола, подробнее см. TrafficControlStatus.
TrafficControlModel
Модель контрола пробок.
Этот интерфейс является потокобезопасным.
TrafficControlModel(map: Map)
Функция создания модели элемента управления пробками.
map
карта.
fun onClicked(): Unit
Действие при нажатии на контрол. Переключает видимость пробок на карте.
TrafficControlState
Состояние элемента управления видимостью пробок.
TrafficControlState(status: TrafficControlStatus = TrafficControlStatus.HIDDEN, score: Int?)
Состояние элемента управления видимостью пробок.
TrafficLineControl
UI-элемент, отображающий уровень пробок вдоль маршрута.
var pointObjectsPosition
TrafficLinePointObject
TrafficLinePointObjectView
TrafficRoute
TrafficRouter
Интерфейс для поиска маршрута с учетом пробочных данных.
fun findRoute(
startPoint: RouteSearchPoint,
finishPoint: RouteSearchPoint,
routeSearchOptions: RouteSearchOptions,
intermediatePoints: List<RouteSearchPoint> = listOf()
): Future<List<TrafficRoute>>
Ищет маршрут по заданным параметрам.
startPoint
Начальная точка маршрута.
finishPoint
Конечная точка маршрута.
routeSearchOptions
Параметры поиска маршрута.
intermediatePoints
Промежуточные точки для проезда в том же порядке, в котором точки заданы в векторе.
Future с набором найденных маршрутов, либо исключением NativeException в случае ошибки.
Пустой набор маршрутов является валидным результатом - это означает, что маршрут, соответствующий указанным критериям поиска, не может быть найден.
При поиске маршрутов для грузового транспорта возможен возврат маршрутов, проходящих через пропускные зоны, для которых не были предоставлены пропуска, в случае, если не удалось проложить маршрут только через пропускные зоны, для которых пропуска были предоставлены. Для проверки того, достаточен ли список пропусков для проезда по маршруту, следует использовать функцию route_matches_truck_pass_zone_passes.
fun findBriefRouteInfos(searchPoints: List<BriefRouteInfoSearchPoints>, routeSearchOptions: RouteSearchOptions): Future<List<BriefRouteInfo?>>
Ищет базовую информацию о маршрутах для соответствующего набора поисковых точек.
searchPoints
Набор точек для поиска базовой информации о маршруте.
routeSearchOptions
Параметры поиска маршрута.
Future с базовой информацией о наборе маршрутов, соответствующему набору точек поиска, либо исключением NativeException в случае ошибки.
Если базовая информация для каких-либо из пар точек не будет найдена, элемент с соответствующим индексом в возвращённом результате будет иметь значение null.
val truckPassZonePasses
Возвращает список всех поддерживаемых пропусков, разрешающих движение грузового транспорта в пределах пропускных зон.
TrafficScore
Оценка пробок.
TrafficScore(state: TrafficScoreState = TrafficScoreState.PENDING, value: Int?)
Оценка пробок.
TrafficScoreProvider
Подписка на обновления информации о величине пробок.
Этот интерфейс является потокобезопасным.
TrafficScoreProvider(map: Map)
Функция создания объекта для слежения за баллом пробок в области видимости карты.
map
Карта, для которой будет отслеживаться область видимости.
TrafficSource
TrafficSpeedColorRouteLongAttribute
Контейнер, который хранит протяженный атрибут маршрута. Каждый элемент хранится в виде пары, состоящей из точки и значения элемента атрибута. Действие атрибута начинается с данной точки и заканчивается в следущей точке, начиная с которой начинается действие атрибута следующего элемента.
fun entry(point: RoutePoint): TrafficSpeedColorRouteLongEntry?
Элемент, в который попадает заданная точка.
fun entries(begin: RoutePoint, end: RoutePoint): List<TrafficSpeedColorRouteLongEntry>
Элементы, частично или полностью покрываемые отрезком begin,end.
TrafficSpeedColorRouteLongEntry
Протяженный элемент маршрута - отрезок и значение на нем.
TrafficSpeedColorRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: TrafficSpeedColor
)
Протяженный элемент маршрута - отрезок и значение на нем.
TransportTypeRouteLongAttribute
Контейнер, который хранит протяженный атрибут маршрута. Каждый элемент хранится в виде пары, состоящей из точки и значения элемента атрибута. Действие атрибута начинается с данной точки и заканчивается в следущей точке, начиная с которой начинается действие атрибута следующего элемента.
fun entry(point: RoutePoint): TransportTypeRouteLongEntry?
Элемент, в который попадает заданная точка.
fun entries(begin: RoutePoint, end: RoutePoint): List<TransportTypeRouteLongEntry>
Элементы, частично или полностью покрываемые отрезком begin,end.
TransportTypeRouteLongEntry
Протяженный элемент маршрута - отрезок и значение на нем.
TransportTypeRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: TransportType
)
Протяженный элемент маршрута - отрезок и значение на нем.
TruckPassZoneId
Идентификатор пропускной зоны для грузовиков. Значение 0 соответствует отсутствию пропускной зоны.
TruckPassZoneId(value: Int = 0)
Идентификатор пропускной зоны для грузовиков. Значение 0 соответствует отсутствию пропускной зоны.
value
TruckPassZoneIdRouteLongAttribute
Контейнер, который хранит протяженный атрибут маршрута. Каждый элемент хранится в виде пары, состоящей из точки и значения элемента атрибута. Действие атрибута начинается с данной точки и заканчивается в следущей точке, начиная с которой начинается действие атрибута следующего элемента.
fun entry(point: RoutePoint): TruckPassZoneIdRouteLongEntry?
Элемент, в который попадает заданная точка.
fun entries(begin: RoutePoint, end: RoutePoint): List<TruckPassZoneIdRouteLongEntry>
Элементы, частично или полностью покрываемые отрезком begin,end.
TruckPassZoneIdRouteLongEntry
Протяженный элемент маршрута - отрезок и значение на нем.
TruckPassZoneIdRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: TruckPassZoneId
)
Протяженный элемент маршрута - отрезок и значение на нем.
TruckPassZonePass
Пропуск, разрешающий движение грузового транспорта в пропускных зонах.
TruckPassZonePass(
id: TruckPassZonePassId,
name: String,
passZoneIds: Set<TruckPassZoneId>
)
Пропуск, разрешающий движение грузового транспорта в пропускных зонах.
TruckPassZonePassId
Идентификатор пропуска, разрешающего движение грузового транспорта в пропускных зонах.
TruckPassZonePassId(value: Int = 0)
Идентификатор пропуска, разрешающего движение грузового транспорта в пропускных зонах.
value
TruckRouteSearchOptions
Параметры поиска маршрута на грузовом транспорте. При поиске маршрута учитываются только заполненные параметры.
TruckRouteSearchOptions(
car: CarRouteSearchOptions,
truckLength: Int? = null,
truckHeight: Int? = null,
truckWidth: Int? = null,
actualMass: Int? = null,
maxPermittedMass: Int? = null,
axleLoad: Int? = null,
dangerousCargo: Boolean = false,
explosiveCargo: Boolean = false,
passIds: Set<TruckPassZonePassId> = setOf(),
fallbackOnCar: Boolean = false
)
Параметры поиска маршрута на грузовом транспорте. При поиске маршрута учитываются только заполненные параметры.
val car
Параметры поиска маршрута, общие с прочими автомобильными.
val truckLength
Длина грузового транспортного средства в миллиметрах.
val truckHeight
Высота грузового транспортного средства в миллиметрах.
val truckWidth
Ширина грузового транспортного средства в миллиметрах.
val actualMass
Фактическая масса грузового транспортного средства в килограммах.
val maxPermittedMass
Разрешённая максимальная масса грузового транспортного средства в килограммах.
val axleLoad
Нагрузка на ось в килограммах.
val dangerousCargo
Признак наличия опасного груза.
val explosiveCargo
Признак наличия взрывчатых веществ в грузе.
val passIds
Идентификаторы имеющихся у пользователя пропусков, требующихся для движения в пределах пропускных зон.
val fallbackOnCar
Использование автоматического фоллбека с поиска грузового маршрута на поиск автомобильного маршрута при невозможности найти грузовой маршрут, удовлетворяющий параметрам поиска.
UIMarkerInfo
Идентификатор объекта с подписью.
UIMarkerInfo(objectId: DgisObjectId, label: String?)
Идентификатор объекта с подписью.
UIntRouteLongAttribute
Контейнер, который хранит протяженный атрибут маршрута. Каждый элемент хранится в виде пары, состоящей из точки и значения элемента атрибута. Действие атрибута начинается с данной точки и заканчивается в следущей точке, начиная с которой начинается действие атрибута следующего элемента.
fun entry(point: RoutePoint): UIntRouteLongEntry?
Элемент, в который попадает заданная точка.
fun entries(begin: RoutePoint, end: RoutePoint): List<UIntRouteLongEntry>
Элементы, частично или полностью покрываемые отрезком begin,end.
UIntRouteLongEntry
Протяженный элемент маршрута - отрезок и значение на нем.
UIntRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: Int
)
Протяженный элемент маршрута - отрезок и значение на нем.
VendorConfig
Переопределение конфигурации SDK.
VendorConfig()
fun match(
none: Function0<T>,
fromAsset: Function1,
fromFile: Function1,
fromString: Function1
): T
none
fromAsset
fromFile
fromString
fun toString(): String
fun hashCode(): Int
VendorConfigFromAsset
Переопределение настроек SDK через указание пути к asset-у Android-приложения.
VendorConfigFromAsset(path: String)
Переопределение настроек SDK через указание пути к asset-у Android-приложения.
path
VendorConfigFromFile
Переопределение настроек SDK через указание пути к файлу в файловой системе устройства.
VendorConfigFromFile(path: String)
Переопределение настроек SDK через указание пути к файлу в файловой системе устройства.
path
VendorConfigFromString
Переопределение настроек SDK через указание содержимого файла.
VendorConfigFromString(contents: String)
Переопределение настроек SDK через указание содержимого файла.
contents
Voice
Голосовой пакет с озвучкой навигатора.
VoiceManager
Интерфейс для взаимодействия со списком голосовых пакетов навигатора.
val voicesChannel
Канал со списком всех известных голосовых пакетов. Обновляется в случае изменения информации о хотя бы об одном из голосов, либо об изменении состава списка. Содержимое канала является подмножеством общего списка пакетов. Во избежание рассинхронизации описаний пакетов, не следует использовать данные, получаемые одновременно из нескольких каналов, содержащих подмножества общего списка пакетов.
val voices
Канал со списком всех известных голосовых пакетов. Обновляется в случае изменения информации о хотя бы об одном из голосов, либо об изменении состава списка. Содержимое канала является подмножеством общего списка пакетов. Во избежание рассинхронизации описаний пакетов, не следует использовать данные, получаемые одновременно из нескольких каналов, содержащих подмножества общего списка пакетов.
VoiceSelector
Управляет голосовыми пакетами в текущей сессии навигатора.
var voice
Голосовой пакет, с помощью которого воспроизводятся голосовые оповещения в текущей сессии навигатора.
VoidRouteAttribute
Контейнер, который описывает точечный атрибут маршрута. Каждый элемент хранится в виде точки на маршруте, в которой этот элемент расположен и значения самого элемента.
fun entries(begin: RoutePoint, end: RoutePoint): List<RoutePoint>
Элементы, попадающие в отрезок [begin, end).
fun findNearBackward(point: RoutePoint): RoutePoint?
Найти ближайший элемент, позиция которого < = point.
Сложность операции log2(N), где N = size.
fun findNearForward(point: RoutePoint): RoutePoint?
Найти ближайший элемент, позиция которого >= point.
Сложность операции log2(N), где N = size.
WeekTime
Момент времени внутри недели.
WeekTimeInterval
Интервал времени в течение недели.
Widget
Базовый класс, представляющий виджет для фильтрации поисковой выдачи.
Виджеты возвращаются в результате поиска и предназначены для фильтрации или сортировки результата по определенным параметрам. Виджеты генерируются динамически для каждого результата поиска и могут отсутствовать для некоторых запросов. Виджет представляет один конкретный фильтр или их группу, объединённую общим признаком. Например, тип кухни в результатах поиска по запросу "Поесть".
WorkStatus
Статус работы.
WorkTimeFilter
Фильтр по времени работы объекта. Либо открыт сейчас, либо открыт на конкретные дата и время.
fun match(workTime: Function1, isOpenNow: Function1): T
fun toString(): String
fun hashCode(): Int
ZIndex
Индекс, задающий порядок отрисовки объектов в рамках слоя.
Zoom
Уровень масштабирования.
Zoom = 0 это такой масштаб, при котором весь мир вписан в квадрат 256x256 логических пикселей (см. LogicalPixel) Zoom = 1 это такой масштаб, при котором весь мир вписан в квадрат 512x512 логических пикселей Масштаб пропорционален величине 2^Zoom.
Zoom не может быть отрицательным.
Zoom(value: Float = 0.0f)
Уровень масштабирования.
Zoom = 0 это такой масштаб, при котором весь мир вписан в квадрат 256x256 логических пикселей (см. LogicalPixel) Zoom = 1 это такой масштаб, при котором весь мир вписан в квадрат 512x512 логических пикселей Масштаб пропорционален величине 2^Zoom.
Zoom не может быть отрицательным.
value
ZoomControl
Контейнер с UI-элементами управления уровнем масштабирования (увеличение/уменьшение).
ZoomControl
Контейнер с UI-элементами управления уровнем масштабирования (увеличение/уменьшение).
ZoomControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Контейнер с UI-элементами управления уровнем масштабирования (увеличение/уменьшение).
ZoomControlModel
Модель контрола зумирования. Контрол состоит из кнопок +/-, при нажатии на которые меняется масштаб карты. При достижении допустимой границы масштаба кнопка масштабирования в этом направлении становится неактивной. Методы объекта необходимо вызывать на одном потоке.
fun isEnabled(button: ZoomControlButton): StatefulChannel<Boolean>
fun setPressed(button: ZoomControlButton, value: Boolean): Unit
ZoomFollowSettings
Интерфейс, позволяющий управлять настройками масштабирования карты во время ведения.
Во время ведения масштаб зависит от скорости движения, от наличия манёвров впереди и позади на маршруте и от типа дороги.
При отсутствии манёвров впереди и позади, либо на дорогах низкого значения (неглавные улицы населённых пунктов, шоссе, междугородние или федеральные трассы) значение масштаба выбирается на основании значений SpeedRangeToStyleZoom, которые хранятся в последовательности speed_range_to_style_zoom_sequence. Последовательность speed_range_to_style_zoom_sequence должна содержать интервалы скоростей, отсортированные по возрастанию значений min_speed, при этом должны выполняться условия: max_speedi > min_speedi+1
max_speedi < max_speedi+1. То есть интервалы скоростей должны соприкасаться или даже пересекаться, но значение скорости не должно попадать более чем в два интервала. При этом минимальное значение скорости не считается попадающим в интервал, т.е. одно и то же значение скорости может находиться быть максимальной скоростью для одного интервала, минимальной скоростью для другого и находиться внутри интервала для третьего интервала. Исключение - первый интервал скоростей, который должен содержать значение min_speed == 0.
Масштаб карты выбирается из последовательности speed_range_to_style_zoom_sequence по алгоритму:
При приближении к маневру на текущей скорости масштаб будет плавно увеличиваться. Время увеличения зависит от скорости и расстояния до манёвра. При увеличении скорости время анимации увеличивается, при снижении скорости - уменьшается. Увеличение уровня зума завершается на некотором расстоянии до манёвра.
После проезда манёвра уровень зума плавно уменьшается.
var speedRangeToStyleZoomSequence
Последовательность интервалов скоростей и соответствующих им масштабов. Используется для автоматического изменения масштаба в навигаторе в зависимости от скорости.
var speedRangeToStyleZoomFreeRoamSequence
Последовательность интервалов скоростей и соответствующих им масштабов при ведении в режиме FreeRoam. Используется для автоматического изменения масштаба в навигаторе в зависимости от скорости.
var styleZoomSpeedRangesAnimationDuration
Длительность плавного изменения масштаба в режиме ведения при изменении скорости при отсутствии манёвров впереди/позади на достаточно близком расстоянии, либо на дорогах низкого значения.
var zoomInBeforeManeuverAnimationDuration
Длительность плавного увеличения уровня зума при приближении к манёвру. Используется только если скорость ниже, чем в get_min_speed_to_consider_in_zoom_in_before_maneuver_animation.
var zoomOutAfterManeuverAnimationDuration
Длительность плавного уменьшения уровня масштабирования после проезда манёвра.
var minSpeedToConsiderInZoomInBeforeManeuverAnimation
Минимальная скорость движения в м/с, при которой длительность плавного изменения уровня зума будет рассчитываться с учётом не только близости к манёвру, но и с учётом текущей скорости. Должна быть не меньше 0.1 м/с, значения меньше будут игнорироваться.
var zoomInBeforeManeuverAnimationAcceleration
Коэффициент ускорения анимации увеличения уровня зума при приближении к манёвру. Должен быть не меньше 1, значения меньше будут игнорироваться.
var distanceGapToManeuver
Расстояние до манёвра, при достижении которого анимация плавного увеличения уровня зума должна быть завершена, чтобы во время манёвра зум не менялся. Например, если до маневра 300 м, то анимация с плавным увеличением уровня зума должна быть завершена за 50 м до начала маневра. Должно быть не меньше 1 м, значения меньше будут игнорироваться.
var minAnimationDuration
Минимальное время анимации. Используется для предотвращения резких изменений уровня зума при анимации. Должно быть не меньше 200, значения меньше будут игнорироваться.