class
ActivityTracker
ActivityTracker(
platformContext: Context,
model: Model,
speedBound: Double = 4.2,
timeThreshold: Duration = Duration.ofMilliseconds(20000)
)
Navigator extension that monitors user activity and emits a signal when the user has stopped using the navigator and can be turned off.
Context.
Model of the navigator which status is being monitored.
Upper speed limit in m/s, above which in the Finished state of the navigator it is considered that the navigator is active, i.e. the movement continues.
The amount of time the navigator's Finished state monitors movement below the threshold to determine if the navigator is inactive. If during this time the movement rate is below the set threshold, or there is no location and speed data, the Navigator is considered inactive.
Active state of this flag indicates that the navigator needs to be stopped. If navigation stops in the Finished state, (the movement stops or its speed falls below the threshold) and this state persists for some time, the flag is set to true, otherwise it is set to false.
Active state of this flag indicates that the navigator needs to be stopped. If navigation stops in the Finished state, (the movement stops or its speed falls below the threshold) and this state persists for some time, the flag is set to true, otherwise it is set to false.
AddEventResult
Result of adding an event (event object or error).
fun match(event: Function1, error: Function1): T
fun toString(): String
fun hashCode(): Int
Address
Address as a set of separate components.
Address(
drillDown: List<AddressAdmDiv>,
components: List<AddressComponent>,
buildingName: String?,
postCode: String?,
buildingCode: String?,
fiasCode: String?,
addressComment: String?
)
Address as a set of separate components.
Set of administrative division objects where the described object is located.
Full address of an object may contain several separate address components.
Name of the building.
ZIP code.
Unique ZIP code of the building.
FIAS code of the building.
Comment on the address. Example: "office 301; 9th floor"
AddressAdmDiv
Object of administrative division.
AddressComponent
Address component: street, house number, or verbal description of location.
fun match(
streetAddress: Function1,
number: Function1,
location: Function1
): T
fun toString(): String
fun hashCode(): Int
AddressLocation
Used for components that are difficult to describe with a specific address.
AddressLocation(comment: String)
Used for components that are difficult to describe with a specific address.
Text description of the building location.
AddressNumber
House number used as a full address. In some settlements, only the house number is indicated, without the street (for example, Krasnoobsk).
AddressStreet
Regular address with a street name and a building number.
AddRoadEventButton
Button for adding a road event.
AddRoadEventButton(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Button for adding a road event.
fun attachToModel(model: AddRoadEventCardModel): Unit
AddRoadEventCard
Card for adding a road event.
AddRoadEventCard(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Card for adding a road event.
fun attachToModel(model: AddRoadEventCardModel): Unit
AddRoadEventCardModel
Model of the card for adding a road event.
AddRoadEventCardModel(roadEventManager: RoadEventManager, map: Map)
Model of the card for adding a road event.
fun onEventTypeClicked(type: RoadEventType): Unit
Action that occurs when the event type selection control is clicked.
fun onLaneClicked(lane: Lane): Unit
Action that occurs when the lane selection control is clicked.
fun onDescriptionEntered(description: String): Unit
Action that occurs when entering description.
fun close(): Unit
Selected event type.
Selected lanes.
Whether it is possible to set lanes.
Entered description.
Marker position on the screen.
Whether it is possible to send an event.
Result of sending the event.
AddRoadEventControl
Base class for controls for adding road events.
AddRoadEventControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Base class for controls for adding road events.
fun attachToModel(model: AddRoadEventCardModel): Unit
@CallSuper
fun detachFromModel(): Unit
fun onAttachedToWindow(): Unit
fun onDetachedFromWindow(): Unit
AddRoadEventControls
Set of controls for adding road events. Consists of a card with event parameters, a "Submit" button, and a marker indicating the location of adding an event on the map.
AddRoadEventControls(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Set of controls for adding road events. Consists of a card with event parameters, a "Submit" button, and a marker indicating the location of adding an event on the map.
fun show(): Unit
fun hide(): Unit
Height in pixels to which the card is expanded.
AddRoadEventMarker
Marker for adding a road event.
AddRoadEventMarker(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Marker for adding a road event.
fun attachToModel(model: AddRoadEventCardModel): Unit
fun detachFromModel(): Unit
AlternativeRouteSelector
Selects an alternative route.
fun selectAlternativeRoute(trafficRoute: TrafficRoute): Unit
Selects an alternative route. If the passed route does not match one of the current alternative routes, nothing happens. Otherwise, the appropriate alternative route becomes the current active route.
Alternative route which should be selected as a current active route.
AlternativeRoutesProviderSettings
Settings of searching for alternative routes and a better route.
Flag to enable/disable suggesting alternative routes. By default, this option is enabled.
Flag to enable/disable suggesting a better route. By default, this option is enabled.
Delay before searching for alternative routes when starting a trip on a route or after switching to another route. Must be not less than 5 seconds. The default value is 20 seconds.
Minimum travel time difference between the original route and the alternative route for which the alternative route is considered a better route.
Minimum total length of route edges that differ between the original route and the alternative route at which the alternative route is considered a better route.
Anchor
Image anchor point. (0, 0) - upper-left corner, (1, 1) - lower-right corner.
ApartmentRange
Range of apartments.
Beginning of the range/stored value. Currently, only numeric values are possible, while there are no apartments with suffixes in the data yet.
End of the range. If absent, the range consists of a single start value. Otherwise, it is an arithmetic progression from start to end in increments of 1.
Attribute
Additional attribute. Example: { tag: "hotel_room_internet", name: "Free internet in rooms" }
Attributes
Interface for managing map object properties.
Only map objects have properties, but you can set default properties for the entire map, the style, and the source (see ISource for details).
fun setAttributeValue(name: String, value: AttributeValue): Unit
Sets a property.
fun setAttributeValues(values: Map, attributesToRemove: List<String> = listOf()): Unit
Sets a property set.
Set of the "name":"value" pairs for the added property.
List of names of properties to be removed.
fun removeAttribute(name: String): Unit
Deletes a property.
fun getAttributeValue(name: String): AttributeValue
Gets a property.
Gets a list of properties.
Gets a channel that notifies about property changes.
AttributeValue
Properties of map objects.
AttributeValue()
fun match(
empty: Function0<T>,
boolean: Function1,
number: Function1,
integer: Function1,
string: Function1,
data: Function1,
array: Function1,
item: Function1
): T
fun toString(): String
fun hashCode(): Int
AuthorInfo
Information about the author of the event or the photo.
AuthorInfo(type: AuthorType, name: String)
Information about the author of the event or the photo.
Content author category.
String containing the name of the user who added the event or the photo.
- Username if the author is an authorized user and has agreed to have their name displayed.
- Empty string for an anonymous user or a user who has refused to have their name displayed.
BaseCamera
Camera.
Sets the parameters for projecting the map onto the screen.
fun changePosition(positionChange: CameraPositionChange): Unit
Changes only a part of the camera position parameters.
The call interrupts flyover and gesture processing, and also resets following of changed parameters, and when changing coordinates, also resets following the style zoom level and direction.
Projection.
Used to get a screen point from a map point and a map point from a screen point. Camera parameters are fixed at the time of the call.
Gets the current camera position.
Gets the current camera position.
Gets current zoom level limits.
Gets current zoom level limits.
Gets the DPI ratio to the device's base DPI.
Gets the DPI ratio to the device's base DPI.
Gets the size of the viewing area.
Gets the size of the viewing area.
Gets current paddings from the screen edges.
Gets current paddings from the screen edges.
Point on the screen to which the camera position is attached. The point is set based on paddings.
Point on the screen to which the camera position is attached. The point is set based on paddings.
Area of intersection of the camera visibility pyramid and the surface of the map.
Rectangle indicating the visible area of the map.
Rectangle indicating the visible area of the map.
Gets the current function of the maximum camera tilt angle dependency on the style zoom level.
Gets the current function of the maximum camera tilt angle dependency on the style zoom level.
Bearing
The angle between the directions of two objects or between the direction of the object and the north. The angle is measured clockwise. The range of values is 0°,360°.
BearingFollowController
Controller following the map bearing.
BearingFollowController(
bearingSource: BearingSource,
animationDuration: Duration = Duration.ofMilliseconds(1000),
valueThreshold: Bearing = Bearing(value = 1.0)
)
Creates a controller for following the map direction.
Source of information about direction.
Non-negative duration of change in real direction.
Non-negative threshold value of considered change in real direction.
BetterRouteInfo
Information about an available alternative route.
BetterRouteInfo(trafficRoute: TrafficRoute, startPoint: RoutePoint)
Information about an available alternative route.
Alternative route.
The point on the alternative route, from which the movement starts in case of switchingt to this route.
BetterRoutePromptControl
Dialog prompting you to switch to a route with a lower expected arrival time.
BetterRoutePromptControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Dialog prompting you to switch to a route with a lower expected arrival time.
BicycleBriefRouteInfo
Basic information about the cycling route.
BicycleBriefRouteInfo(length: RouteDistance, landmark: String)
Basic information about the cycling route.
BicycleInstructionCrossroad
Description of maneuvers when passing through an intersection or a pedestrian crossing.
BicycleInstructionCrossroad(landmark: BicycleInstructionCrossroadLandmark = BicycleInstructionCrossroadLandmark.NONE, maneuvers: List<BicycleInstructionCrossroadManeuver>)
Description of maneuvers when passing through an intersection or a pedestrian crossing.
Landmark.
A chain of consecutive maneuvers.
BicycleInstructionCrossroadManeuver
BicycleInstructionCrossroadManeuver(direction: BicycleInstructionCrossroadManeuverDirection = BicycleInstructionCrossroadManeuverDirection.STRAIGHT, turnAngle: Int = 0)
Direction of movement.
BicycleInstructionFinish
End of the cycling part of the route.
BicycleInstructionFinish()
End of the cycling part of the route.
BicycleInstructionStart
Beginning of the cycling part of the route.
BicycleInstructionStart()
Beginning of the cycling part of the route.
BicycleRouteSearchOptions
Bicycle route search options.
BicycleRouteSearchOptions(
avoidCarRoads: Boolean = false,
avoidStairways: Boolean = false,
avoidUnderpassesAndOverpasses: Boolean = false,
excludedAreas: List<ExcludedArea> = listOf()
)
Bicycle route search options.
Avoid highways.
Avoid stairways.
Avoid underground and elevated passages.
Excluded areas (not more than 25).
BoolRouteLongAttribute
A container that stores an extended route attribute. Each element is stored as a pair consisting of a point and an attribute element value. Attribute action starts at this point and ends at the next point, at which the next element's attribute action begins.
fun entry(point: RoutePoint): BoolRouteLongEntry?
Element that the specified point falls into.
fun entries(begin: RoutePoint, end: RoutePoint): List<BoolRouteLongEntry>
Elements partially or completely covered by the begin,end segment.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
BoolRouteLongEntry
Extended route element - segment and value on it.
BoolRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: Boolean
)
Extended route element - segment and value on it.
Borders
Sets the pull to a value that is a multiple of this number.
Indication of using a logarithmic scale.
Value by which the filtering occurs.
Lower bound of the set of values.
Upper bound of the set of values.
Currently set minimum value.
Currently set maximum value.
BriefExtraRouteInfo
Additional information about the route for a specific type of transport.
BriefExtraRouteInfo(pedestrian: PedestrianBriefRouteInfo)
BriefExtraRouteInfo(publicTransport: PublicBriefRouteInfo)
fun match(
bicycle: Function1,
car: Function1,
pedestrian: Function1,
publicTransport: Function1,
scooter: Function1
): T
fun toString(): String
fun hashCode(): Int
BriefPublicTransportCard
Card that displays brief information about a public transport route. Unlike a PublicTransportCard, it does not contain information about transfers.
BriefPublicTransportCard(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Card that displays brief information about a public transport route. Unlike a PublicTransportCard, it does not contain information about transfers.
fun onAttachedToWindow(): Unit
BriefPublicTransportCardModel
Model for BriefPublicTransportCard.
BriefPublicTransportCardModel(route: TrafficRoute, context: Context)
Model for BriefPublicTransportCard.
Title. Estimated travel time, for example, "1 hour 42 minutes".
Transport information.
Description. Number of transfers and walking time, e.g. 1transfer,15min walk.
BriefRoadEvent
BriefRoadEvent(
id: Long = 0,
eventType: RoadEventType = RoadEventType.OTHER,
lanes: EnumSet<Lane>
)
BriefRouteInfo
Basic route information.
BriefRouteInfo(duration: Duration, extraInfo: BriefExtraRouteInfo)
Basic route information.
Driving time along the route.
Additional information about the route for a specific type of transport.
BriefRouteInfoSearchPoints
Points used to request searching for the basic route information.
BriefRouteInfoSearchPoints(startPoint: RouteSearchPoint, finishPoint: RouteSearchPoint)
Points used to request searching for the basic route information.
Starting point of the route.
Finish point of the route.
BuildingId
BuildingInfo
Information about building.
BuildingInfo(
buildingName: String? = null,
purposeName: String? = null,
purposeCode: PurposeCode? = null,
buildingLevels: BuildingLevels? = null
)
Information about building.
Name of the building.
Description of the purpose of the building.
Code of the purpose of the building.
Information about floor plans of the building.
BuildingLevels
Information about the floor plans of the building.
BuildingLevels(defaultLevelId: LevelId, levels: List<LevelInfo>)
Information about the floor plans of the building.
ID of the default floor plan.
All floor plans of the building.
CalloutMapPosition
Route callout position.
CalloutMapPosition(
mapId: MapId,
calloutPosition: GeoPoint?,
routePoint: RoutePoint?
)
Route callout position.
ID of the map for which the position is given.
Position on the map.
Position of a lane callout on the route.
Camera
Camera to start moving the map and adjust tracking.
fun move(moveController: CameraMoveController): Future<CameraAnimatedMoveResult>
Animated camera movement controller.
fun move(
position: CameraPosition,
time: Duration = Duration.ofMilliseconds(300),
animationType: CameraAnimationType = CameraAnimationType.DEFAULT
): Future<CameraAnimatedMoveResult>
Final camera position.
Time allotted for moving the map
Camera animation type.
fun move(
point: GeoPoint,
zoom: Zoom,
tilt: Tilt?,
bearing: Bearing,
time: Duration = Duration.ofMilliseconds(300),
animationType: CameraAnimationType = CameraAnimationType.DEFAULT
): Future<CameraAnimatedMoveResult>
Starts the animated map movement using the built-in map movement controller.
Resets the current map tracking mode and interrupts gesture processing.
Point of the final camera position.
Zoom level in the final camera position.
Tilt in the final camera poition or an empty value if it is necessary to use the value from the follow controller or the current one depending on the active following mode.
Bearing in the final camera position.
Time allotted for moving the map
Camera animation type.
fun processMovementAndStop(): Unit
Sets the camera position according to the current time and stops animated movement.
Calling the method interrupts the flyover and gesture processing, and also resets the tracking mode.
fun addFollowController(followController: FollowController): Unit
Adds a tracking controller.
There can be several different ones, for example, a controller for tracking the scale, map tilt, geolocation, etc.
fun removeFollowController(followController: FollowController): Unit
Removes the tracking controller.
fun setCustomFollowController(followController: CustomFollowController): Unit
Adds a tracking controller implemented on the platform.
Only one such controller can be installed. If you install multiple controllers, only the last one installed is used.
fun removeCustomFollowController(): Unit
Removes the tracking controller implemented on the platform.
Gets the current state of the camera.
Gets the current state of the camera.
Camera tracking mode.
Camera tracking mode.
CameraBehaviour
Camera tracking mode.
Camera modes are degraded according to the following rules:
- Map shift sets to None the following events: DirectMapShiftEvent, MapShiftBeginEvent, DirectMapRotationEvent with the specified event center, DirectMapScalingEvent with the specified event center, ScaleMapEvent with the specified event center
- Rotation of the map relative to the position point blocks the publication of Bearing events: MapRotationBeginEvent, RotateMapToNorthEvent, DirectMapRotationEvent without event center
- Changing the scale relative to the position point blocks the publication of StyleZoom events: MapScalingBeginEvent, DirectMapScalingEvent without event center, ScaleMapEvent without event center
- Tilt locks the publication of Tilt events: DirectMapTiltEvent
CameraBehaviour(position: FollowPosition?, tilt: FollowTilt = FollowTilt.OFF)
Camera tracking mode.
Camera modes are degraded according to the following rules:
- Map shift sets to None the following events: DirectMapShiftEvent, MapShiftBeginEvent, DirectMapRotationEvent with the specified event center, DirectMapScalingEvent with the specified event center, ScaleMapEvent with the specified event center
- Rotation of the map relative to the position point blocks the publication of Bearing events: MapRotationBeginEvent, RotateMapToNorthEvent, DirectMapRotationEvent without event center
- Changing the scale relative to the position point blocks the publication of StyleZoom events: MapScalingBeginEvent, DirectMapScalingEvent without event center, ScaleMapEvent without event center
- Tilt locks the publication of Tilt events: DirectMapTiltEvent
CameraBehaviourChange
Change tracking mode.
CameraBehaviourChange(newBehaviour: CameraBehaviour, changeReason: CameraBehaviourChangeReason)
Change tracking mode.
New tracking mode.
Reason for changing tracking mode.
CameraNotifier
Warns you when you enter the traffic camera coverage area.
CameraNotifier(model: Model)
Navigator extension that warns you when you enter the traffic camera coverage area.
Model of the navigator which status is being monitored.
Progress of passing the traffic camera coverage area.
Progress of passing the traffic camera coverage area.
CameraPosition
Camera position.
Map point corresponding to the camera position (see ICamera::position_point()).
Zoom level. 0 is the entire world inscribed in a square of 256x256 logical pixels (see LogicalPixel).
Tilt angle of the direction of vertical view.
0 - nadir (look vertically down), the maximum value is 60 degrees.
Rotation angle of the direction of horizontal view relative to the north direction. Counted clockwise, in degrees.
CameraPositionChange
Description of changing some of the camera position parameters.
CameraPositionPoint
Relative screen position of the point to which the camera is attached.
Screen area is set by paddings. x - offset from the left edge of the screen area, y - offset from the top edge. Allowed range of padding values: (0.0f, 1.0f) 0,0 - the upper-left corner of the screen area, 1,1 - the lower-right corner.
CameraPositionPoint(x: Float = 0.5f, y: Float = 0.5f)
Relative screen position of the point to which the camera is attached.
Screen area is set by paddings. x - offset from the left edge of the screen area, y - offset from the top edge. Allowed range of padding values: (0.0f, 1.0f) 0,0 - the upper-left corner of the screen area, 1,1 - the lower-right corner.
CameraProgressInfo
Information about the progress of passing the camera zone.
CameraProgressInfo(
camera: RouteCamera,
position: RoutePoint,
progress: Float = 0.0f
)
Information about the progress of passing the camera zone.
Camera for which the passing progress is being monitored.
Position of the camera on the route.
CameraRouteAttribute
Container that describes a point attribute of a route. Each element is stored as a point on the route (at which the element is located) and the value of the element itself.
fun entries(begin: RoutePoint, end: RoutePoint): List<CameraRouteEntry>
Elements falling within the [begin, end) range.
fun findNearBackward(point: RoutePoint): CameraRouteEntry?
Finds the nearest element, the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
fun findNearForward(point: RoutePoint): CameraRouteEntry?
Finds the nearest element, the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
CameraRouteEntry
Route element - point and value in it.
CameraRouteEntry(point: RoutePoint, value: RouteCamera)
Route element - point and value in it.
CameraZoomRestrictions
Acceptable zoom range.
CancelEvent
Event of canceling the current action.
For example, can be called when a gesture is canceled, the window focus is lost, or when the mouse capture is lost. It can also be called from within the map when changing the zoom level restrictions, applying changes to the tracking mode, and setting the interactive mode of the map.
CancelEvent()
CarBriefRouteInfo
Basic car route information.
CarBriefRouteInfo(
length: RouteDistance,
landmark: String,
trafficSpeed: CarBriefRouteInfoTrafficSpeed
)
Basic car route information.
Route length.
Landmark.
Traffic speed.
CarInstructionCrossroad
Description of maneuvers at the crossroads.
CarInstructionCrossroad(
direction: CarInstructionCrossroadDirection = CarInstructionCrossroadDirection.STRAIGHT,
turnAngle: Int = 0,
landmark: CarInstructionCrossroadLandmark = CarInstructionCrossroadLandmark.NONE,
exitName: String
)
Description of maneuvers at the crossroads.
Direction of traffic at the intersection.
Landmark.
Name of the exit.
CarInstructionFinish
End of the car section of the route.
CarInstructionFinish()
End of the car section of the route.
CarInstructionRoundabout
Description of maneuvers at a roundabout.
CarInstructionRoundabout(
type: CarInstructionRoundaboutType = CarInstructionRoundaboutType.ENTRY,
turnAngle: Int = 0,
exitNumber: Int = 0,
exitName: String
)
Description of maneuvers at a roundabout.
CarInstructionStart
Beginning of the car section of the route.
CarInstructionStart()
Beginning of the car section of the route.
CarInstructionUTurn
U-turn on the road (not at the intersection).
U-turn at the intersection is described by the Crossroad instruction.
CarInstructionUTurn(exitName: String)
U-turn on the road (not at the intersection).
U-turn at the intersection is described by the Crossroad instruction.
Name of the exit.
CarRouteSearchOptions
Parameters for finding a car route.
CarRouteSearchOptions(
avoidTollRoads: Boolean = false,
avoidUnpavedRoads: Boolean = false,
avoidFerries: Boolean = true,
avoidLockedRoads: Boolean = true,
routeSearchType: RouteSearchType = RouteSearchType.JAM,
excludedAreas: List<ExcludedArea> = listOf()
)
Parameters for finding a car route.
Avoid toll roads.
Avoid dirt roads.
Avoid ferries.
Avoid closed roads. When set to true, the route search does not take into account road sections that are closed to traffic. If set to false, the route can be built through blocked sections of roads if it is impossible to build a route without passing through blocked sections.
Route search type.
Excluded areas (not more than 25).
Certificate
SSL certificate.
fun match(
system: Function1,
fromFile: Function1,
fromAsset: Function1
): T
fun toString(): String
fun hashCode(): Int
Certificates used by default. System + Russian, supplied with the SDK.
CertificateFromAsset
SSL certificate from the Android asset.
Path relative to the root directory of assets.
CertificateFromFile
SSL certificate from a file.
The path to the file.
CheckableGroupedItem
Single element from GroupCheckableItem.
Gets a text description of an element.
Gets a list of values by which filtering occurs. Usually one value.
Gets the state of an element.
CheckableItem
Base representation of a checkable item from a CheckableItemsGroup.
Gets the type of the checked element.
Gets a list of filters that describe the current state of the widget. Can be used when forming a search query.
CheckableItemsGroup
Widget for representing a group of checked items.
Gets a group of widget elements.
Checkbox
Checkbox widget.
Gets the filter type that the widget represents.
Gets the signature text for a “checked” checkbox.
Gets the signature text for a “non-checked” checkbox.
Gets a list of values by which filtering occurs. Usually one value.
Gets the state of the widget.
Circle
Circle.
Location of the circle center.
Circle radius.
Circle fill color.
Width of the circle outline.
Circle outline color.
CircleOptions
Parameters for creating a geometric map object of the "Circle" type.
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
)
Parameters for creating a geometric map object of the "Circle" type.
Geographical position.
Radius in meters.
Fill color.
Width of the circle outline.
Line color of the circle outline.
Visibility flag.
User data (not used inside the SDK, only needed for API users).
Object rendering level.
Link to the floor plan of the building.
ClusterObject
Cluster of objects.
Gets the position of the cluster on the map.
Gets the number of tokens in the cluster.
Gets a list of markers in the cluster.
Gets a cluster geometric object.
ClusterOptions
Cluster marker settings.
Color
Color
CompassControl
Compass control.
CompassControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0,
layout: Int = R.layout.dgis_compass_control
)
Compass control.
CompassControl
CompassControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
CompassControlModel
Compass control model. The control consists of a compass button. When the button is pressed, the map camera changes the angle in the north direction. If the map camera faces the north, the control must be hidden. Thread-safe.
fun onClicked(): Unit
ComplexGeometry
Compound geometry consisting of a set of simple or compound geometries.
An arbitrary level of nesting of compound geometries in a set is supported.
ContactInfo
Way to contact the organization.
Type of the contact. One of the following:
- website
- phone
- fax
- pobox - P.O. box
- icq
- jabber
- skype
- vkontakte
- odnoklassniki
- youtube
- googleplus
- viber
- telegram
Contact value to display.
Technical value of the contact. Depending on the contact type, it has the following semantics:
- email - email address
- website - full URL
- phone - phone number in international format, for example: "+73831234567"
- fax - phone number in international format, for example: "+73831234567"
- pobox - mailing address
- icq - user ID
- jabber - user ID
- skype - user ID
- vkontakte - full URL
- twitter - full URL
- odnoklassniki - full URL
- youtube - full URL
- linkedin - full URL
- googleplus - full URL
- pinterest - full URL
- whatsapp - full URL
- viber - full URL
- telegram - full URL
Clarifying information about the contact.
Context
Context - the environment required for the SDK to work.
CoordinatesFollowController
Controller for following the coordinates of the map position.
CoordinatesFollowController(animationDuration: Duration = Duration.ofMilliseconds(1000), valueThreshold: Meter = Meter(value = 0.1f))
Creates a controller for following the coordinates of the map position.
DashboardControl
DashboardControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
fun onAttachedToWindow(): Unit
fun toggleExpandedState(): Unit
DashedPolylineOptions
Dashed polyline options.
DashedPolylineOptions(dashLength: LogicalPixel = LogicalPixel(value = 5.0f), dashSpaceLength: LogicalPixel = LogicalPixel(value = 2.0f))
Dashed polyline options.
Length of the dashed line.
Length of the space between dashes.
DashedStrokeCircleOptions
DashedStrokeCircleOptions(dashLength: LogicalPixel = LogicalPixel(value = 5.0f), dashSpaceLength: LogicalPixel = LogicalPixel(value = 2.0f))
Dash length.
Length of the space between dashes.
DayTime
Time moment within a day.
DefaultLocationSource
Implementation of the default location source (recommended for use). If available, GMS is used, otherwise - LocationManager.
DefaultLocationSource(context: Context)
Implementation of the default location source (recommended for use). If available, GMS is used, otherwise - LocationManager.
@Synchronized
fun activate(listener: LocationChangeListener): Unit
@Synchronized
fun deactivate(): Unit
@Synchronized
fun setDesiredAccuracy(accuracy: DesiredAccuracy): Unit
fun onPermissionGranted(): Unit
The method must be called after receiving permissions to use the location.
@Synchronized
fun onProvidersChanged(): Unit
DefaultNavigationControls
Navigator UI controls suggested for default use: lane information, speed limit, indication of the next maneuver, etc. SDK users can also create their own UI controls and use the navigator UI model to get event notifications while navigating a route.
DefaultNavigationControls(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Navigator UI controls suggested for default use: lane information, speed limit, indication of the next maneuver, etc. SDK users can also create their own UI controls and use the navigator UI model to get event notifications while navigating a route.
fun onConfigurationChanged(newConfig: Configuration): Unit
fun onAttachedToWindow(): Unit
Default state of the navigator control. It is needed to set the correct initial state of controls. This property can be set only until the control is displayed.
DeviceDensity
Multiplier calculated as the ratio of DPI to the base DPI of the device.
For Android, it corresponds to resources.displayMetrics.density. For iOS, it corresponds to nativeScale.
Must be positive.
DeviceDensity(value: Float = 0.0f)
Multiplier calculated as the ratio of DPI to the base DPI of the device.
For Android, it corresponds to resources.displayMetrics.density. For iOS, it corresponds to nativeScale.
Must be positive.
DevicePpi
Device display resolution, in pixels per inch.
Must be positive.
DevicePpi(value: Float = 0.0f)
Device display resolution, in pixels per inch.
Must be positive.
DGis
Entry point to the 2GIS SDK. At the start of work, you must call 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
You must call this method before working with the SDK.
Android application context.
Network client settings.
Logging parameters.
Overrides the SDK configuration.
Key source.
Consent to data collection and data processing.
Network client to be used instead of the standard one.
Settings applied to all maps.
sdkContext required for SDK services to work.
@JvmStatic
fun context(): Context
DgisMapObject
2GIS map object.
Information about the object can be obtained via directory.
Stable numeric object identifier.
DgisObjectId
DgisSource
Main interface of 2GIS data sources.
fun setHighlighted(directoryObjectIds: List<DgisObjectId>, highlighted: Boolean): Unit
Sets or removes the highlight of objects.
Adds a "selected" attribute to an object, which can be used in styles.
Identifiers of modifiable objects.
Sets or removes the highlight.
@JvmStatic
fun createDgisSource(context: Context, workingMode: DgisSourceWorkingMode = DgisSourceWorkingMode.ONLINE): Source
Creats a source that retrieves data from 2GIS servers or uses pre-loaded data in operation.
Gets a list of identifiers of selected objects.
Gets a list of identifiers of selected objects.
DirectMapControlBeginEvent
Event of starting the direct map control. Tells the map to handle direct map control events. Direct control events only work from DirectMapControlBeginEvent to DirectMapControlEndEvent. After the direct control event sequence has ended, kinematics may start. Kinematics uses the time the event occurred, so using the time received from the system is better than filling in the value during processing. Kinematics works only for moving the map, not for rotation and scaling.
DirectMapControlBeginEvent()
DirectMapControlEndEvent
Event of ending the direct map control. Ends the direct map control started after getting the DirectMapControlBeginEvent. Direct map control events are described in DirectMapControlBeginEvent.
DirectMapRotationEvent
Event of the direct map rotation. Direct map control events are described in DirectMapControlBeginEvent.
DirectMapRotationEvent(
bearingDelta: Bearing,
timestamp: Duration,
rotationCenter: ScreenPoint? = null
)
Changes the angle of the map rotation, in degrees. Positive values correspond to the direction of counter-clockwise rotation.
Time of the system event generation.
Point on the screen around which the map rotates. If no point is specified, the rotation is done relatively to the map position point.
Change of the map rotation angle.
Point on the screen around which the map rotates.
DirectMapScalingEvent
Event of direct map scaling. Direct map control events are described in DirectMapControlBeginEvent.
DirectMapScalingEvent(
zoomDelta: Float,
timestamp: Duration,
scalingCenter: ScreenPoint? = null
)
Amount by which the current zoom value changes.
Time of the system event generation.
Point on the screen around which the map is scaled. If no point is given, scaling is done relatively to the map position point.
Amount by which the current zoom value changes.
Point on the screen around which the map is scaled.
DirectMapShiftEvent
Direct map shift event. Direct map control events are described in DirectMapControlBeginEvent.
DirectMapShiftEvent(
screenShift: ScreenShift,
shiftedPoint: ScreenPoint,
timestamp: Duration
)
Change of the screen position of the map relative to the previous one, in pixels.
Center point from which the map is shifted.
Time of the system event generation.
Change of the screen position of the map compared to the previous position, in pixels.
Center point from which the map is shifted.
DirectMapTiltEvent
Direct camera tilt event. Direct map control events are described in DirectMapControlBeginEvent.
Tilt change in degrees.
DirectoryFilter
Filters for the directory.
DirectoryFilter(workTime: WorkTimeFilter?, dynamic: List<DynamicFilter>)
Filters for the directory.
DirectoryObject
Directory object.
fun formattedAddress(type: FormattingType): FormattedAddress?
String representation of the address formatted according to the specified length requirement.
Object type. There can be several ones, for example, Sun City shopping center is a branch of the organization and a building at the same time. The first type in this list is the main one.
Object title.
Additional information for the title. Example: "(apt. 1-12)"
Object subtitle.
Can be an empty string if the value is missing.
Object description.
Stable numeric object identifier.
Feature point where the marker should be placed.
Object address as a set of components.
Additional object attributes.
Contextual additional object attributes.
Shift of the object's local time relative to UTC in seconds at the current moment.
Object opening hours.
Object contacts.
Reviews.
Additional information about parking.
Work status.
ID of the floor where the object is located.
Information about the floor plans of the building.
Information about the entrances.
Information about the organization license.
Information about building.
DoubleRouteAttribute
Container that describes a point attribute of a route. Each element is stored as the point on the route at which the element is located and the value of the element itself.
fun entries(begin: RoutePoint, end: RoutePoint): List<DoubleRouteEntry>
Elements falling within the [begin, end) range.
fun findNearBackward(point: RoutePoint): DoubleRouteEntry?
Finds the nearest element the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
fun findNearForward(point: RoutePoint): DoubleRouteEntry?
Finds the nearest element the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
DoubleRouteEntry
Route element - point and value in it.
DoubleRouteEntry(point: RoutePoint, value: Double)
Route element - point and value in it.
DragBeginData
Data on the beginning of dragging: drag start point and an object being dragged.
DragBeginData(point: ScreenPoint, item: RenderedObject)
Data on the beginning of dragging: drag start point and an object being dragged.
Duration
Class representing a period of time.
operator fun unaryMinus(): Duration
fun toString(): String
DynamicFilter
Dynamic filters for search results.
fun match(
flagFilter: Function1,
rangeFilter: Function1,
sortingFilter: Function1
): T
fun toString(): String
fun hashCode(): Int
DynamicRouteInfo
DynamicRouteInfo(roadEvents: RoadEventRouteAttribute, traffic: Traffic)
DynamicRouteInfoSettings
Settings for receiving dynamic route data.
Frequency at which dynamic route data should be updated.
Elevation
Non-negative elevation of the point above the surface in meters.
Elevation(value: Float = 0.0f)
Non-negative elevation of the point above the surface in meters.
EmptyFollowController
Base class for custom controllers. Can be used as the basis for implementing a controller on a platform.
EmptyFollowController()
Base class for custom controllers. Can be used as the basis for implementing a controller on a platform.
fun availableValues(): EnumSet<FollowValue>
St of value types that this controller can manage.
fun requestValues(values: EnumSet<FollowValue>): Unit
Tells the controller which values it provides are in use. This frees up resources associated with calculating unused values. The method can be called multiple times with different values, in which case the last one is considered relevant.
fun setNewValuesNotifier(notifier: NewValuesNotifier?): Unit
Installs a notifier that notifies about new values. The notifier must be stored in the implemented controller
fun bearing(): Bearing?
Bearing. Method is called only after calling request_values with appropriate parameters.
EntranceGeometry
Geometry for displaying the entrance on the map.
EntranceGeometry(entrancePoints: List<GeoPoint>, entrancePolylines: List<List<GeoPoint>>)
Geometry for displaying the entrance on the map.
Entrance location.
Geometry of arrows pointing to the entrance.
EntranceInfo
Information about the entrance to the building.
EntranceInfo(
id: DgisObjectId,
buildingNumber: String?,
porchName: String?,
porchNumber: String?,
apartmentRanges: List<ApartmentRange>,
geometry: EntranceGeometry?
)
Information about the entrance to the building.
Identifier of the entrance object.
Number of the house to which the entrance belongs.
Non-empty entrance name. Filled only for porches (entrances in residential buildings). Can take the values of the entrance name (eg "Entrance 1") or the building number if the entrance has its own address.
Non-empty entrance number. Filled only for porches (entrances in residential buildings). Can take values of the entrance number (eg "1") or the building number if the entrance has its own address.
Numbers of apartments related to the entrance.
Geometry for displaying the entrance on the map.
Event
Base class for all handled events.
EventsProcessingSettings
EventsProcessingSettings(rotationCenter: RotationCenter, scalingCenter: ScalingCenter)
Point around which the map is rotated.
Point relative to which the map is scaled.
ExceedSpeedLimitSettings
Settings for detection of exceeding the maximum allowed speed limit.
ExcludedArea
Excluded area to be avoided when building a route.
ExcludedArea(
type: ExcludedAreaType = ExcludedAreaType.POINT,
severity: ExcludedAreaSeverity = ExcludedAreaSeverity.SOFT,
extent: RouteDistance,
points: List<GeoPoint>
)
Excluded area to be avoided when building a route.
Type of the excluded area.
Priority of excluding the area.
Size of the excluded area (not more than 25 km).
Coordinates of the points of the excluded area (not more than 500).
ExtraInstructionInfo
ExtraInstructionInfo(bicycleStart: BicycleInstructionStart)
ExtraInstructionInfo(bicycleFinish: BicycleInstructionFinish)
ExtraInstructionInfo(bicycleCrossroad: BicycleInstructionCrossroad)
ExtraInstructionInfo(carCrossroad: CarInstructionCrossroad)
ExtraInstructionInfo(carRoundabout: CarInstructionRoundabout)
ExtraInstructionInfo(pedestrianStart: PedestrianInstructionStart)
ExtraInstructionInfo(pedestrianFinish: PedestrianInstructionFinish)
ExtraInstructionInfo(pedestrianCrossroad: PedestrianInstructionCrossroad)
ExtraInstructionInfo(pedestrianIndoorFloorChange: PedestrianInstructionIndoorFloorChange)
ExtraInstructionInfo(pedestrianIndoorEnter: PedestrianInstructionIndoorEnter)
ExtraInstructionInfo(pedestrianIndoorExit: PedestrianInstructionIndoorExit)
ExtraInstructionInfo(scooterStart: ScooterInstructionStart)
ExtraInstructionInfo(scooterFinish: ScooterInstructionFinish)
ExtraInstructionInfo(scooterCrossroad: ScooterInstructionCrossroad)
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
fun toString(): String
fun hashCode(): Int
File
File identifier.
Can be not only a file in the file system, but also an arbitrary data source.
@JvmStatic
fun fromString(contents: String): File
File with contents from the given string.
FinishRouteControl
FinishRouteControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
fun onAttachedToWindow(): Unit
fun expand(): Unit
FlagFilter
Filter of the flag type.
FloatRouteLongAttribute
Container that stores an extended route attribute. Each element is stored as a pair consisting of a point and an attribute element value. Attribute action starts at this point and ends at the next point, at which the next element's attribute action begins.
fun entry(point: RoutePoint): FloatRouteLongEntry?
Element that the specified point falls into.
fun entries(begin: RoutePoint, end: RoutePoint): List<FloatRouteLongEntry>
Elements partially or completely covered by the begin,end segment.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
FloatRouteLongEntry
Extended route element - segment and value on it.
FloatRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: Float
)
Extended route element - segment and value on it.
FloorInfo
Information about the floor plan for the marker - an element of search results.
FloorInfo(levelId: LevelId, buildingId: BuildingId)
Information about the floor plan for the marker - an element of search results.
FollowControl
Control to enable location marker tracking.
FollowControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Control to enable location marker tracking.
FollowController
Class that allows you to manage the camera position and the geolocation marker. All of its methods' implementations must be thread-safe. Most methods have trivial default implementations available (thus the FollowController responsible for scaling is not required to override coordinates() and similar methods).
FollowPosition
Settings for following the direction, tilt, and zoom level.
FollowPosition(bearing: FollowBearing = FollowBearing.OFF, styleZoom: FollowStyleZoom = FollowStyleZoom.OFF)
Settings for following the direction, tilt, and zoom level.
FormattedAddress
Human-readable representation of the address.
Address from the drilldown. Example: "Novosibirsk, Kirovsky district".
Address within the settlement. Example: "Nikolaeva, 11".
Comment on the address. Example: "301 office; 9th floor".
Postal code of the object with the building code, if any. Example: "630088", "630007/XBVJF8".
Fps
Frames per second, frame rate.
FreeRoamSettings
Road graph tiles are loaded into the HTTP cache during navigation if they correspond to a section of the route from the current position to the specified distance. The default value is 5 km.
Tiles are not loaded into the HTTP cache if the parameter matches zero or negative distance.
When caching road graph tiles during navigation, tiles are loaded into the HTTP cache if they are closer than the specified distance in meters from the route line. The default value is 1 km.
Tiles are not loaded into the HTTP cache, if the parameter corresponds to zero or negative distance.
Road graph tiles are loaded into the HTTP cache if they are closer than the specified distance in meters from the current position. The default value is 2 km.
Tiles are not loaded into the HTTP cache if the parameter corresponds to a zero or negative distance.< /p>
Geometry
Geometry object.
Minimum size of rectangle containing geometry.
Minimum point of the bounding box.
Maximum point of the bounding box.
GeometryMapObject
Geometric object of the map.
Methods are thread-safe.
The object is displayed on the map under the following conditions:
- the object is visible;
- the object is added to the data source;
- the data source containing the object is added to the map;
- the display parameters in the map styles are applicable to this object. For more information about displaying objects on the map, see ISource.
Object geometry.
Object geometry.
Gets the properties of the map object for reading and modifying.
Current object visibility flag.
Current object visibility flag.
Current object relocation flag.
Current object relocation flag.
Minimum size of rectangle containing geometry.
GeometryMapObjectBuilder
Class for setting properties and then creating geometric objects.
GeometryMapObjectBuilder()
fun setObjectAttribute(name: String, value: AttributeValue): GeometryMapObjectBuilder
fun setObjectAttributes(values: Map): GeometryMapObjectBuilder
Sets the properties of the map object.
Set of "name":"value" pairs for the added properties of a map object.
The method does not replace the entire set of object properties, i.e. if a property is absent in values, but has already been added to the object previously, it will not be changed.
fun setGeometry(geometry: Geometry): GeometryMapObjectBuilder
Sets the geometry of the map object.
fun setVisible(visible: Boolean): GeometryMapObjectBuilder
Sets the visibility of the map object.
fun setDraggable(draggable: Boolean): GeometryMapObjectBuilder
Sets the possibility of dragging a map object.
fun setUserData(userData: Any?): GeometryMapObjectBuilder
Installing user data.
User data is not used in any way in the SDK and is only returned it to the user.
fun createObject(): GeometryMapObject
Constructs a map object.
The object must have geometry
After calling this function, GeometryMapObjectBuilder becomes unsuitable for setting the parameters of a map object or for creating an object.
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
Source of geometric map objects.
fun clusteringObjects(position: CameraPosition): List<MapObject>
Gets a list of objects participating in clustering given a camera position. The list contains both clusters and geometric objects.
fun addObject(item: GeometryMapObject): Unit
Adds an object to the source.
Adding objects by group is more efficient than adding one by one, especially when the source has already been added to one or more maps.
Adding is asynchronous, thread-safe, the method can be used from any thread.
For a source with clustering, addition is not yet implemented, an exception will be thrown.
fun addObjects(objects: List<GeometryMapObject>): Unit
Adds multiple objects to the source.
Adding objects by group is more efficient than adding one by one, especially when the source has already been added to one or more maps.
Adding is asynchronous, thread-safe, the method can be use from any thread.
For a source with clustering, addition is not yet implemented, an exception will be thrown.
fun removeObject(item: GeometryMapObject): Unit
Deletes an object from the source.
The deletion is asynchronous, thread-safe, the method can be used from any thread.
fun removeObjects(objects: List<GeometryMapObject>): Unit
Removes objects from the source.
fun removeAndAddObjects(objectsToRemove: List<GeometryMapObject>, objectsToAdd: List<GeometryMapObject>): Unit
Removes and adds objects to the source.
Gets all objects added to the source.
Gets default property values for all objects added to the source (see IAttributes).
GeometryMapObjectSourceBuilder
fun setSourceAttribute(name: String, value: AttributeValue): GeometryMapObjectSourceBuilder
Sets the property of map objects common to the entire source (see ISource).
fun setSourceAttributes(values: Map): GeometryMapObjectSourceBuilder
Sets properties of map objects common to the entire source.
fun addObject(item: GeometryMapObject): GeometryMapObjectSourceBuilder
Adds a map geometry object to the source.
fun addObjects(objects: List<GeometryMapObject>): GeometryMapObjectSourceBuilder
Adds several geometric map objects to the source.
fun createSource(): GeometryMapObjectSource
Creates a source of geometric objects.
After calling this function, you cannot use the GeometryMapObjectSourceBuilder to create a data source or set data source parameters.
GeoPoint
Point in a spherical coordinate system that, together with a geodetic coordinate system (e.g. WGS84), indicates a point on the Earth's surface. This structure is not tied to a specific geodetic coordinate system. However, this module contains free functions that operate on this structure in a specific coordinate system (to determine the coordinate system used, see the documentation for the functions).
GeoPoint(latitude: Latitude, longitude: Longitude)
Point in a spherical coordinate system that, together with a geodetic coordinate system (e.g. WGS84), indicates a point on the Earth's surface. This structure is not tied to a specific geodetic coordinate system. However, this module contains free functions that operate on this structure in a specific coordinate system (to determine the coordinate system used, see the documentation for the functions).
fun move(bearing: Bearing, meter: Meter): GeoPoint
Calculates the point obtained by moving the original point in the specified direction by the specified distance.
fun withElevation(elevation: Elevation = Elevation(0.0f)): GeoPointWithElevation
fun bearing(point: GeoPoint): Bearing
Calculates the direction (bearing, i.e. the angle between true north and the direction of travel, counted clockwise) between two points.
GeoPointRouteAttribute
Container that describes a point attribute of a route. Each element is stored as the point on the route (where the element is located) and the value of the element itself.
fun entries(begin: RoutePoint, end: RoutePoint): List<GeoPointRouteEntry>
Elements falling within the [begin, end) range.
fun findNearBackward(point: RoutePoint): GeoPointRouteEntry?
Finds the nearest element the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
fun findNearForward(point: RoutePoint): GeoPointRouteEntry?
Finds the nearest element the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
fun calculateGeoPoint(routePoint: RoutePoint): SegmentGeoPoint?
Calculates a GeoPoint from a known RoutePoint.
Calculated geographical coordinates and the direction of the segment pointed to by the route_point parameter. If the route is empty or the route_point goes beyond the route, null is returned.
The complexity of the operation is O(log2(N)), where N = route_geometry .size()
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
Route length.
GeoPointRouteEntry
Route element - point and value in it.
GeoPointRouteEntry(point: RoutePoint, value: GeoPoint)
Route element - point and value in it.
GeoPointWithElevation
Pint in a geographic coordinates system (latitude, longitude, elevation).
Elevation is calculated in meters above the surface, not above the sea level.
GeoPointWithElevation(
latitude: Latitude,
longitude: Longitude,
elevation: Elevation = Elevation(value = 0.0f)
)
Pint in a geographic coordinates system (latitude, longitude, elevation).
Elevation is calculated in meters above the surface, not above the sea level.
fun bearing(point: GeoPoint): Bearing
Calculates the direction (bearing, i.e. the angle between the north direction and the direction of travel, counted clockwise ) for projecting a point onto the map and a given point.
fun distance(point: GeoPoint): Meter
Calculates the minimum (by great circle) distance between the projection of a point on the map and a given point.
fun move(bearing: Bearing, meter: Meter): GeoPointWithElevation
Calculates the point obtained by moving the projection of the origin point in the specified direction by the specified distance.
GeoRect
Rectangular area in a spherical coordinate system (for example, WGS84). This structure is not tied to a specific geodesic coordinate system.
fun contains(point: GeoPoint): Boolean
Whether the rectangle contains a point. Points located on the boundary are also considered to belong to the rectangle.
fun expand(point: GeoPoint): GeoRect
Expands the rectangle. Returns the minimum rectangle containing the original rectangle and point.
Checks the rectangle for validity.
Checks the rectangle for degeneracy. If the points in the rectangle are equal, then it degenerates to a point. A degenerate rectangle is a valid rectangle. An invalid rectangle is not degenerate.
Southwest point, lower-left border of the rectangle.
Northeast point, upper-right border of the rectangle.
GestureManager
Class for managing gesture processing.
fun setSettingsAboutMapPositionPoint(settings: EventsProcessingSettings): Unit
Sets the point relative to which the scaling and rotation take place.
Event handling settings.
When the function is called, gesture recognition tools are recreated.
fun setMutuallyExclusiveGestures(rules: List<EnumSet<Gesture>>): Unit
Sets a list of rules for excluding simultaneous triggering of multiple gestures.
The passed list is extended with default rules, which do not allow the tilt management gesture to be triggered simultaneously with other gestures. Each rule contains a list of gestures that cannot be triggered simultaneously. For example, if the Scaling and Rotation gestures are specified in the rule, these gestures will not work simultaneously. If multiple gestures from the rule are called simultaneously, the gesture with higher priority will be triggered. The order of gesture priorities (in descending order): (Shift ->) Tilt -> Scaling -> Rotation -> MultiTouchShift
GlobalMapOptions
Global map settings. They are specified during the SDK initialization and used for all maps.
GlobalMapOptions(graphicsApi: GraphicsApi = GraphicsApi.OPEN_GL)
Global map settings. They are specified during the SDK initialization and used for all maps.
Graphics API.
GradientPolylineOptions
Gradient polyline options.
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
)
Gradient polyline options.
Line border width.
Width of the second line border.
Gradient line length.
Border color.
Second border color.
Gradient polyline color picker.
Color indices of the gradient polyline. The number of indices must be 1 less than the number of polyline points.
GroupCheckableItem
Set of elements that works as a radio group.
Gets a set of group elements.
HttpCacheManager
HttpHeader
HttpOptions
HTTP client options.
HttpOptions(
certificates: List?<Certificate> = null,
timeout: Duration = Duration.ofMilliseconds(15000),
useCache: Boolean = true,
cacheStoragePath: String? = null,
cacheMaxSize: Long? = null,
proxy: HttpProxyOptions? = null
)
HTTP client options.
Certificates in PEM format. If not specified, system certificates + supplied with the SDK are used.
Timeout for HTTP requests.
Use HTTP cache.
Path to the top-level directory for the main HTTP cache file store. The file store will be located in the http_cache subdirectory in this directory. If no path is specified, the directory returned by context.getCacheDir() will be used.
Maximum HTTP cache size in bytes. If not specified, the default maximum HTTP cache size is 300 MB.
Proxy settings.
HttpProxyOptions
Proxy settings.
HttpRequest
Structure for presenting an HTTP request.
HttpRequest(
url: String,
method: HttpMethod = HttpMethod.GET,
headers: List<HttpHeader> = listOf(),
body: ByteArray? = null
)
Structure for presenting an HTTP request.
String representation of a URL request.
HTTP request method. Default is GET.
Request header. Empty by default.
Request body. Missing by default.
HttpResponse
Structure for presenting a response for an HTTP request.
The reponse body is stored and handled separately.
HttpResponse(statusCode: HttpStatusCode, headers: List<HttpHeader>)
Structure for presenting a response for an HTTP request.
The reponse body is stored and handled separately.
HttpResponseCallback
Object with callbacks for handling the sending and receiving of data.
fun onResponse(response: HttpResponse): Boolean
Method that handles receiving a response from the server.
Server response.
Returns false if the SDK has cancelled sending/handling a request.
fun onReceive(body: ByteArray, size: Int): Boolean
Method that handles receiving a response body. Handling can be done in parts.
fun onFinished(): Unit
HttpStatusCode
Image
Image.
ImageData
Image data: size, format, and binary data.
ImageData(
size: ScreenSize,
format: ImageFormat,
data: ByteArray
)
Image data: size, format, and binary data.
fun toBitmap(): Bitmap
IncompleteTextHandler
Autocomplete is suggested for the text entered by the user.
You need to substitute this text in the search bar and let the user continue typing the query.
IndoorBuilding
Building with floor plans.
Building ID with floor plans.
Index of the default floor.
Information about all floors.
Serial infex of the active floor in levels.
Serial infex of the active floor in levels.
IndoorControl
Floor control.
It is a column with the names of floors with the active one highlighted. When you click a name, the floor plan switches. No more than 5 names are displayed at the same time, those that do not fit can be scrolled to.
IndoorControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Floor control.
It is a column with the names of floors with the active one highlighted. When you click a name, the floor plan switches. No more than 5 names are displayed at the same time, those that do not fit can be scrolled to.
Floors on which marks are displayed.
IndoorControlModel
Floor control model.
Active floor index.
Active floor index.
Floors on which marks are displayed.
Names of floors. Empty if the map does not display a building with floor plans or if the building has only one floor.
Names of floors. Empty if the map does not display a building with floor plans or if the building has only one floor.
IndoorDetector
Detector that determines if a user is infoors.
Channel that notifies when the user is indoors.
Channel that notifies when the user is indoors.
IndoorManager
Class for getting the current building with floor plans.
fun setIndoorState(newState: IndoorManagerState): Unit
Switching the floor plan manager on/off.
Gets the current building with floor plans.
Gets the current building with floor plans.
IndoorRouteLevelsGetter
Allows you to get the set of floors through which the routes displayed on the map pass.
InputEvent
User input event.
Gets the time of the input event registration.
InstructionRouteAttribute
Container that describes a point attribute of a route. Each element is stored as the point on the route (where the element is located) and the value of the element itself.
fun entries(begin: RoutePoint, end: RoutePoint): List<InstructionRouteEntry>
Elements falling within the [begin, end) range.
fun findNearBackward(point: RoutePoint): InstructionRouteEntry?
Finds the nearest element the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
fun findNearForward(point: RoutePoint): InstructionRouteEntry?
Finds the nearest element the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
InstructionRouteEntry
Route element - point and value in it.
InstructionRouteEntry(point: RoutePoint, value: RouteInstruction)
Route element - point and value in it.
IntRouteAttribute
Container that describes a point attribute of a route. Each element is stored as the point on the route (where the element is located) and the value of the element itself.
fun entries(begin: RoutePoint, end: RoutePoint): List<IntRouteEntry>
Elements falling within the [begin, end) range.
fun findNearBackward(point: RoutePoint): IntRouteEntry?
Finds the nearest element the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
fun findNearForward(point: RoutePoint): IntRouteEntry?
Finds the nearest element the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
IntRouteEntry
Route element - point and value in it.
IntRouteEntry(point: RoutePoint, value: Int)
Route element - point and value in it.
IsOpenNow
Open now.
IsOpenNow()
Open now.
ItemMarkerInfo
KeyFromAsset
Key from an asset.
Path relative to the asset's root directory.
KeyFromFile
Key from a file.
Path to the file.
KeyFromString
Key from a string.
Contents.
KeySource
Source of the key.
fun match(
fromAsset: Function1,
fromFile: Function1,
fromString: Function1
): T
fun toString(): String
fun hashCode(): Int
LanesCalloutMapPosition
Position of the lane callout for the route.
LanesCalloutMapPosition(
mapId: MapId,
routePoint: RoutePoint,
geoPoint: GeoPoint
)
Position of the lane callout for the route.
ID of the map for which the position is given.
Position of the lane callouts on the route.
Position of the lane callout on the map.
LaneSignRouteLongAttribute
Container that stores an extended route attribute. Each element is stored as a pair consisting of a point and an attribute element value. Attribute action starts at this point and ends at the next point, at which the next element's attribute action begins.
fun entry(point: RoutePoint): LaneSignRouteLongEntry?
Element that the specified point falls into.
fun entries(begin: RoutePoint, end: RoutePoint): List<LaneSignRouteLongEntry>
Elements partially or completely covered by the begin,end range.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
LaneSignRouteLongEntry
Extended route element - segment and value on it.
LaneSignRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: RouteLaneSign
)
Extended route element - segment and value on it.
Latitude
Geographical latitude.
LevelId
Floor plan identifier.
LevelInfo
Information about the floor of the building.
Locale
Locale.
fun toLocalePosix(): String
LocaleManager
Manager of application regional settings.
fun overrideLocales(locales: List<Locale>): Unit
Setting the list of application locales.
Application locales, if specified, otherwise - locales specified by the user in the OS.
Application locales, if specified, otherwise - locales specified by the user in the OS.
Gets locales provided by the OS.
OS locales are ordered in the way specified by the user (in order of highest priority to a lower priority).
Gets locales provided by the OS.
OS locales are ordered in the way specified by the user (in order of highest priority to a lower priority).
Location
Geoposition.
Location(
coordinates: LocationCoordinates,
altitude: LocationFuzzyDouble?,
course: LocationCourse?,
groundSpeed: LocationFuzzyDouble?,
source: String,
timestamp: Duration
)
Geoposition.
coordinates::value - coordinates of the geoposition. coordinates::accuracy - horizontal accuracy of the geoposition coordinates (DRMS), m. https://en.wikipedia.org/wiki/Circular_error_probable Value range: >= 0.
altitude::value - height above the WGS84 reference ellipsoid, m. altitude::accuracy - standard deviation of the measurement error of the height, m. null means that the platform does not provide this field. https://en.wikipedia.org/wiki/Standard_deviation Value range: (null, > 0).
course::value - bearing (direction of movement along the Earth's surface. The angle is measured relative to geographic north). course::accuracy - standard deviation of the measurement error of the angle. null means that the platform does not provide this field. https://en.wikipedia.org/wiki/Standard_deviation Value range: (null, > 0).
ground_speed - speed of movement along the Earth's surface, m/s. Value range: >= 0. ground_speed::accuracy - mean square deviation of the measurement error of the speed, m/s. null means that the platform does not provide this field. https://en.wikipedia.org/wiki/Rayleigh_distribution Value range: (null, > 0).
Name of the location source.
Timestamps between different location sources are not synchronized, so you cannot compare timestamps for locations that are obtained from different sources.
Time point at which the geolocation was determined. This point is not tied to any specific date and is used solely to calculate the time between two location measurements obtained from the same location source in the same session. This field must increase monotonically (even when the system is in sleep mode).
LocationCoordinates
LocationCourse
LocationFuzzyDouble
LogicalPixel
Pixel which size does not depend on screen density.
1 logical pixel equals 1/(base ppi) of an inch. The base PPI is device-specific and is calculated from the DevicePpi/DeviceDensity ratio. DevicePpi and DeviceDensity are set with the OS via the map interface. For Android, LogicalPixel corresponds to dp, for iOS - to point.
LogicalPixel(value: Float = 0.0f)
Pixel which size does not depend on screen density.
1 logical pixel equals 1/(base ppi) of an inch. The base PPI is device-specific and is calculated from the DevicePpi/DeviceDensity ratio. DevicePpi and DeviceDensity are set with the OS via the map interface. For Android, LogicalPixel corresponds to dp, for iOS - to point.
LogMessage
Message to be logged.
LogOptions
Logging settings.
Longitude
Geographical longitude.
MagneticChangeListener
Class that keeps track of compass direction changes and compass availability.
ManeuverControl
ManeuverControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Map
Map.
fun addSource(source: Source): Unit
Adds a data source to the map.
Occurs asynchronously. The method can be called from any thread, it is thread-safe.
fun removeSource(source: Source): Unit
Removes a data source from the map.
Occurs asynchronously. The method can be called from any thread, it is thread safe.
fun getRenderedObjects(centerPoint: ScreenPoint, radius: ScreenDistance = ScreenDistance(value = 1.0f)): Future<List<RenderedObjectInfo>>
Gets displayable map objects projected onto a circle on the screen.
Circle center.
Radius of the circle.
The list of objects is formed in the order of rendering from the latest to the earliest.
fun setAttribute(name: String, value: AttributeValue): Unit
Map instance ID, unique within the process.
Gets a camera.
Gets a floor plan manager.
Notification about the state of data loading to the map.
When tracking the camera position, the map state is always MapDataLoadingState::Loading.
Notification about the state of data loading to the map.
When tracking the camera position, the map state is always MapDataLoadingState::Loading.
Gets current map styles.
Gets current map styles.
Icon and font size multiplier received from the application.
The size of icons and fonts is specified in logical pixels (see LogicalPixel) and multiplied by the font and icon size multiplier.
Icon and font size multiplier received from the application.
The size of icons and fonts is specified in logical pixels (see LogicalPixel) and multiplied by the font and icon size multiplier.
Gets map data sources.
Occurs asynchronously. The method can be called from any thread, it is thread safe.
Gets attributes.
The following properties must be specified: "theme"="day|night" "navigatorOn"="true|false"
Map interactivity. Interactivity means that the user has the ability to interact with the map. If interactivity is disabled, the map stops responding to input events obtained from the user. Controls for working with the map (zooming in and moving to the current position) also stop working. It remains possible to work with the map via set_position/move. Unfinished gestures are reset upon transition to the non-interactive state. By default, the map is interactive (interactive == true).
The function can be called from any thread.
Map interactivity. Interactivity means that the user has the ability to interact with the map. If interactivity is disabled, the map stops responding to input events obtained from the user. Controls for working with the map (zooming in and moving to the current position) also stop working. It remains possible to work with the map via set_position/move. Unfinished gestures are reset upon transition to the non-interactive state. By default, the map is interactive (interactive == true).
The function can be called from any thread.
MapControl
Base class for map UI controls.
MapControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Base class for map UI controls.
MapControls
Controls to wotk with the map during navigation.
MapControls(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Controls to wotk with the map during navigation.
fun onLayout(
changed: Boolean,
left: Int,
top: Int,
right: Int,
bottom: Int
): Unit
MapDirection
Angle of the object rotation relative to the north direction, in degrees, counted clockwise.
MapDirection(value: Double = 0.0)
Angle of the object rotation relative to the north direction, in degrees, counted clockwise.
MapId
Map instance ID, unique within the process.
MapLocationController
Controller for map positioning in navigator.
Geolocation marker controller.
Whether forced map orientation to north is enabled.
MapManager
Interface that allows you to add maps to the navigator and remove them.
MapObject
Object on the map.
Arbitrary user data attached to the object.
MapObjectManager
MapObjectManager(map: Map, layerId: String? = null)
Creates an IMapObjectManager.
fun removeObject(item: SimpleMapObject): Unit
Deletes an object.
fun addObjects(objects: List<SimpleMapObject>): Unit
Adds objects.
fun removeObjects(objects: List<SimpleMapObject>): Unit
Deletes objects.
fun removeAndAddObjects(objectsToRemove: List<SimpleMapObject>, objectsToAdd: List<SimpleMapObject>): Unit
Removes and adds objects.
fun removeAll(): Unit
fun clusteringObjects(position: CameraPosition): List<MapObject>
Gets a list of objects participating in clustering given the camera position. The list contains both clusters and markers.
@JvmStatic
fun withClustering(
map: Map,
logicalPixel: LogicalPixel,
maxZoom: Zoom,
clusterRenderer: SimpleClusterRenderer,
minZoom: Zoom = Zoom(value = 0.0f),
layerId: String? = null
): MapObjectManager
Creates an IMapObjectManager with data clustering. Only IMarker objects are clustered.
Minimum possible distance on the screen between anchor points of markers on levels where clustering works.
Level starting from which all markers are visible.
Interface for setting cluster display parameters.
Level starting from which clusters are formed.
Layer ID in the "Dynamic Object" type style. Created objects are placed on this layer, this allows you to set their order relative to other layers. If not specified, objects are placed on top of other layers.
@JvmStatic
fun withGeneralization(
map: Map,
logicalPixel: LogicalPixel,
maxZoom: Zoom,
minZoom: Zoom = Zoom(value = 0.0f),
layerId: String? = null
): MapObjectManager
Creates an IMapObjectManager with data generalization. Only IMarker objects are generalized.
Minimum distance on the screen between marker anchor points on levels where generalization works.
Level starting from which all markers are visible.
Level starting from which generalization works.
Layer ID in the "Dynamic Object" type style. Created objects are placed on this layer, this allows you to set their order relative to other layers. If not specified, objects are placed on top of other layers.
Overrides the visibility of all objects added to the manager instance. Setting false here takes precedence over the visibility of a single object.
MapOptions
Map options.
MapOptions()
Map options.
@JvmStatic
fun fromAttributes(context: Context, attrs: AttributeSet): MapOptions
MapPaddingControl
Control that sets the padding of the map.
MapPaddingControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Control that sets the padding of the map.
MapRotationBeginEvent
MapRotationEndEvent
Event of ending the map rotation around the point.
MapRotationEndEvent()
MapScalingBeginEvent
MapScalingEndEvent
MapShiftBeginEvent
MapShiftEndEvent
MapTheme
Theme to use in the map.
Code of the style from the Style Editor.
The background color used before styles are loaded and the map background is displayed. In default themes, this matches the default map background color.
Standard light theme for base styles.
Standard dark theme for base styles.
MapView
Container of the map and additional controls.
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
Sets the theme to be used in the map.
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 useCustomGestureRecognitionEngine(customGestureRecognitionEngine: MapGestureRecognitionEngine): Unit
Use custom gesture recognizer.
Maximum allowed map refresh rate. If not set, it is equal to the screen refresh rate.
Maximum allowed map refresh rate in power saving mode. If not set, it is equal to maxFps.
Map update frequency. To get the correct value, you must keep a subscription to the channel. Before calling the method, the map must be initialized (getMapAsync is completed).
Returns the View used for rendering OpenGL.
Theme that is used by the map. To change during the lifecycle MapView, use setTheme.
MarkedByRouteIndoorControl
Floor control, which marks the floors through which routes pass on the map.
MarkedByRouteIndoorControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Floor control, which marks the floors through which routes pass on the map.
MarkedUpText
Marked text.
MarkedUpText(text: String, matchedParts: List<MarkedUpTextSpan>)
Marked text.
Text.
Set of non-overlapping Spans, in the order of them appearing in the text string, describing the parts that match the user's query.
MarkedUpTextSpan
Describes a subset of bytes of the text string.
Marker
Point on the map that is of interest to the user.
Gets a marker location.
Gets a marker icon.
Gets an anchor point of a marker icon.
Gets the transparency of the marker icon.
Gets the marker caption.
Gets the marker caption style.
Gets the marker dragability flag.
Gets the target marker width used for scaling.
Rotation angle of the marker on the map relative to the north direction, clockwise.
Whether to animate the appearance.
Gets the animation mode for an animated marker.
MarkerOptions
Marker options.
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
)
Marker options.
Target width used for scaling.
Object rendering level.
Whether to animate the appearance.
Link to the floor plan of the building.
Animation mode.
MessageControl
MessageControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Meter
Length/distance in meters.
MillisecondsRouteAttribute
Container that describes a point attribute of a route. Each element is stored as the point on the route (where the element is located) and the value of the element itself.
fun entries(begin: RoutePoint, end: RoutePoint): List<MillisecondsRouteEntry>
Elements falling within the [begin, end) range.
fun findNearBackward(point: RoutePoint): MillisecondsRouteEntry?
Finds the nearest element the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
fun findNearForward(point: RoutePoint): MillisecondsRouteEntry?
Finds the nearest element the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
fun calculateDuration(routePoint: RoutePoint): Duration
Calculates the expected travel time to the end of the route.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
MillisecondsRouteEntry
Route element - point and value in it.
MillisecondsRouteEntry(point: RoutePoint, value: Duration)
Route element - point and value in it.
Model
Navigator model intended to be displayed in the UI.
fun betterRouteResponse(response: BetterRouteResponse): Unit
User response about applying the suggested better route.
Navigator state.
Navigator state.
Current location that the navigator is working with.
See location_available_channel.
Current location that the navigator is working with.
See location_available_channel.
Flag that indicates whether the current location is used for navigation. After receiving the location, the navigator decides whether it can be used for navigation (for example, if the location has too large error margins, the navigator may decide that it is not suitable for navigation). If the location is navigable, the navigator sets the value to true in this channel. If not, it sets the value to false.
Even if the value in this channel is false, the location_channel can be updated in the location_channel.
See location_channel.
Flag that indicates whether the current location is used for navigation. After receiving the location, the navigator decides whether it can be used for navigation (for example, if the location has too large error margins, the navigator may decide that it is not suitable for navigation). If the location is navigable, the navigator sets the value to true in this channel. If not, it sets the value to false.
Even if the value in this channel is false, the location_channel can be updated in the location_channel.
See location_channel.
Route with maneuvers.
In the free roam mode (StateChannel::FreeRoam), there is no route on which a user is traveling. Therefore, the section of the road on which the user is currently moving is represented by the navigator as a route and returned as the current route. This type of road definition is not a complete route as it lacks a finish point and maneuvers.
Route with maneuvers.
In the free roam mode (StateChannel::FreeRoam), there is no route on which a user is traveling. Therefore, the section of the road on which the user is currently moving is represented by the navigator as a route and returned as the current route. This type of road definition is not a complete route as it lacks a finish point and maneuvers.
Traffic events and traffic jam data on the route or on the predicted part of the route for FreeRoam mode.
Traffic events and traffic jam data on the route or on the predicted part of the route for FreeRoam mode.
Current user position on the route.
Current user position on the route.
Flag of exceeding the maximum allowed speed limit.
Flag of exceeding the maximum allowed speed limit.
Signal indicating an alternative route with shorter expected travel time. The null value means that an alternative route cannot be found or has become outdated.
Signal indicating an alternative route with shorter expected travel time. The null value means that an alternative route cannot be found or has become outdated.
MultiTouchShiftSettings
Settings for handling shift when touching with multiple fingers.
MultiTouchShiftSettings(thresholdMm: Float)
Settings for handling shift when touching with multiple fingers.
Shift threshold of the weighted average of finger placement points, in millimeters, upon reaching which the generation of multi-finger shift events starts.
MyLocationControl
Control of the flyover to the user's current location.
MyLocationControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Control of the flyover to the user's current location.
MyLocationController
Class that controls the display of the current position marker.
MyLocationController(
bearingSource: BearingSource?,
animationDuration: Duration = Duration.ofMilliseconds(1000),
coordinatesThreshold: Meter = Meter(value = 0.1f),
bearingThreshold: Bearing = Bearing(value = 1.0)
)
Creating a location marker movement controller. One controller can only be added to the sources of one context.
Source of direction. If missing, a marker without direction will be displayed.
Non-negative duration of change in real direction.
Non-negative threshold value of considered change in real position and its accuracy.
Non-negative threshold value of considered change in real direction.
MyLocationControlModel
Model for the control to manage the flyover to the user's location. The control consists of a button that, when clicked, triggers the camera flyover to the user location. If the location is not specified, nothing happens. Object methods must be called on the same thread.
fun onClicked(): Unit
MyLocationMapObject
Geolocation marker.
MyLocationMapObjectSource
Source containing a geolocation marker.
MyLocationMapObjectSource(
context: Context,
controller: MyLocationController,
markerType: MyLocationMapObjectMarkerType = MyLocationMapObjectMarkerType.MODEL
)
Creates a location marker source.
fun setController(controller: MyLocationController): Unit
Sets up a new controller responsible for marker parameters.
Gets the geolocation marker.
NativeException
Exception converted from an exception thrown in native code.
NativeObject
Base class for objects that wrap objects in native code.
NativeProxy
Technical class that encapsulates a weak pointer to an object in native code.
fun finalize(): Unit
NavigationControl
Container with controls for the zoom level and flyover to the user's current location.
NavigationControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Container with controls for the zoom level and flyover to the user's current location.
NavigationControl
Base class for navigator UI controls.
NavigationControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Base class for navigator UI controls.
fun onAttachedToWindow(): Unit
fun onDetachedFromWindow(): Unit
fun detachFromManager(): Unit
NavigationFollowController
Interface for managing the map following a geolocation marker in the navigator.
Timeout after which the map automatically returns to the mode of following the geolocation marker after the user moved it. 0 - automatic return to the following mode is disabled.
Camera tracking mode for geoposition marker in the navigator.
NavigationManager
Root public interface of the navigator.
NavigationManager(platformContext: Context)
Navigator API entry point used in the SDK by default.
fun start(): Unit
fun start(routeBuildOptions: RouteBuildOptions, trafficRoute: TrafficRoute? = null): Unit
Starts route guidance.
Parameters with which the navigator rebuilds the route.
Route to start navigating. If the value is not specified, the navigator builds a route from the current location.
fun startSimulation(routeBuildOptions: RouteBuildOptions, trafficRoute: TrafficRoute): Unit
Starts a simulation route navigation.
Parameters with which the navigator rebuilds the route.
Route on which to run the simulation.
Navigator model intended to be displayed in the UI.
Indoor navigation.
Management of automatic return of the map to following a geolocation marker.
Controller for map positioning in navigator.
Navigator map manager.
Map scaling settings during the follow mode.
Settings for displaying the route on the map.
Settings for the source used to display the route on the map.
Settings for simulation of navigating the route.
Managing voice packages in the current navigator session.
Settings for detection of exceeding the speed limit.
Settings for receiving and updating dynamic route data.
Settings for sound alerts in the current navigator session.
Settings for navigating without a route in free roam mode.
Alternative route search settings in the navigation mode.
Selects an alternative route.
NavigationView
UI element that displays the state of navigation on the map.
Adding it to a MapView results in the display of a route, a geolocation marker, transport events, and camera tracking. Navigation controls can be placed inside NavigationView - inheritors of NavigationControl, in particular, the ready-to-use set of controls DefaultNavigationControls.
NavigationView(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
UI element that displays the state of navigation on the map.
Adding it to a MapView results in the display of a route, a geolocation marker, transport events, and camera tracking. Navigation controls can be placed inside NavigationView - inheritors of NavigationControl, in particular, the ready-to-use set of controls DefaultNavigationControls.
NavigationVoice
Voice to use in the navigator.
NewValuesNotifier
Interface of an object that reports that there are changes in any of the parameters.
ObstacleInfo
Information about the obstacle on the route.
ObstacleInfo(type: Obstacle = Obstacle.OTHER, limitation: ObstaclePassLimitation = ObstaclePassLimitation.UNLIMITED)
Information about the obstacle on the route.
ObstacleInfoRouteAttribute
Container that describes a point attribute of a route. Each element is stored as the point on the route (where the element is located) and the value of the element itself.
fun entries(begin: RoutePoint, end: RoutePoint): List<ObstacleInfoRouteEntry>
Elements falling within the [begin, end) range.
fun findNearBackward(point: RoutePoint): ObstacleInfoRouteEntry?
Finds the nearest element the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
fun findNearForward(point: RoutePoint): ObstacleInfoRouteEntry?
Finds the nearest element the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
ObstacleInfoRouteEntry
Route element - point and value in it.
ObstacleInfoRouteEntry(point: RoutePoint, value: ObstacleInfo)
Route element - point and value in it.
ObstacleInfoRouteLongAttribute
Container that stores an extended route attribute. Each element is stored as a pair consisting of a point and an attribute element value. Attribute action starts at this point and ends at the next point, at which the next element's attribute action begins.
fun entry(point: RoutePoint): ObstacleInfoRouteLongEntry?
Element that the specified point falls into.
fun entries(begin: RoutePoint, end: RoutePoint): List<ObstacleInfoRouteLongEntry>
Elements partially or completely covered by the begin,end range.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
ObstacleInfoRouteLongEntry
Extended route element - segment and value on it.
ObstacleInfoRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: ObstacleInfo
)
Extended route element - segment and value on it.
Opacity
Opacity - from 0.0 (fully transparent) to 1.0 (fully opaque).
Opacity(value: Float = 0.0f)
Opacity - from 0.0 (fully transparent) to 1.0 (fully opaque).
OpeningHours
Opening hours of the organization.
OpeningHours(weekOpeningHours: List<List<WeekTimeInterval>>, isOpen24x7: Boolean)
Opening hours of the organization.
Opening hours for each day of the week, starting from Monday.
OrderedValue
Describes one value from a set.
OrderedValues
Describes a set of discrete ordered values.
OrderedValues(
values: List<OrderedValue>,
currentMinIndex: Long? = null,
currentMaxIndex: Long? = null
)
Describes a set of discrete ordered values.
Set of values. Sorted in ascending order.
Index of the currently set minimum value.
Index of the currently set maximum value.
Package
Package. For the convenience of working with data (installation, updating, deletion), data in the 2GIS SDK are grouped into sets according to functional-logical purpose. A set of grouped data is called a package. The functional purpose of data is unique within one package. However, sets data of packages with the same functionality may overlap, that is, it is possible that the data of several packages have common files. In operations with a group of such packages, the common data will be processed (downloaded, unpacked, deleted) only once.
Stable technical package identifier.
Package information.
Package information.
Package installation or update operation progress as a percentage. If the package is not installed locally, the channel contains the value 0. If the package is installed locally, regardless of the date and compatibility with the current SDK version, the channel contains the value 100. If the package is located during the install or update phase, the channel contains the update value in the range 0.100.
Package installation or update operation progress as a percentage. If the package is not installed locally, the channel contains the value 0. If the package is installed locally, regardless of the date and compatibility with the current SDK version, the channel contains the value 100. If the package is located during the install or update phase, the channel contains the update value in the range 0.100.
PackageInfo
Package information. See 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
)
Package information. See IPackage.
Localized package name.
Installation flag - true, if the package was selected for installation.
Installation pending flag - true, if there is no fully loaded version of the package (possibly incompatible with the current SDK version).
Flag for pre-installed packages. Pre-installed packages are always installed and fully loaded, and cannot be removed.
Compatibility flag - true, if the downloaded package is compatible with the current SDK version.
Indicator of an update availability - true, if there is an update for the downloaded package. It is possible, that during the process of updating to a new version, an even newer version of the package became available on the server. In this case, the value is true both during the update and upon completion.
Error occurred while trying to load and/or install a package, or null if there is no error.
Package update status.
PackageManager
Interface for centralized package management:
- Managing auto-update and obtaining its status;
- Forced updates checking;
- Starting and stopping the installation/update of all available packages.
- Subscription to changes in information about packages;
- Subscription to changes in information about the overall installation progress of packages.
Auto-update status (enabled/disabled).
Channel with a list of all known packages. Updated if information about at least one of the packages or the list composition changes.
Channel with a list of all known packages. Updated if information about at least one of the packages or the list composition changes.
PackedMapState
Serialized map state.
@JvmStatic
fun of(
position: CameraPosition,
showTraffic: Boolean,
behaviour: CameraBehaviour
): PackedMapState
Gets the map state.
Camera position.
Status of displaying traffic score on the map.
Camera tracking mode.
Serialized map state.
@JvmStatic
fun fromBytes(data: ByteArray): PackedMapState
Gets the map state.
@JvmStatic
fun fromMap(map: Map): PackedMapState
Gets the map state.
Gets the display status of traffic score on the map.
Gets the camera position.
Gets a camera tracking mode.
PackedNavigationState
Auxiliary object for serializing and deserializing the navigation state.
@JvmStatic
fun of(
trafficRoute: TrafficRoute,
routeSearchOptions: RouteSearchOptions? = null,
finishPoint: RouteSearchPoint? = null,
routePosition: RoutePoint? = null,
state: State = State.DISABLED
): PackedNavigationState
Creates an object from the listed elements.
@JvmStatic
fun fromBytes(data: ByteArray): PackedNavigationState
Deserialization of the navigation state. Invalid elements in the saved state are either ignored or replaced with default values.
@JvmStatic
fun fromModel(model: Model): PackedNavigationState
Creates an object from a navigator model.
Route.
Finish point of the route.
Route building options.
Position on route.
Current navigation state.
PackedSearchQuery
Auxiliary object for serializing and deserializing a search query.
fun toBytes(): ByteArray
fun toSearchQuery(): SearchQuery
@JvmStatic
fun fromBytes(data: ByteArray): PackedSearchQuery
Deserialization of a search query.
@JvmStatic
fun fromSearchQuery(searchQuery: SearchQuery): PackedSearchQuery
Query text. For some queries (for example, expanding a category from a suggest), there is no text, because identifiers are stored in the query, and the behavior is different from searching the text of the suggest element.
Geometry limiting the search area.
Rectangular area of interest.
Restriction on object types returned by search.
Issue page size.
Information about active filters.
Type of sorting of results.
Padding
Camera padding.
Specified as an inward offset from the edges, in physical pixels. The paddings affect:
- the position point;
- animated map movement;
- the placement of dynamic map objects (such as route callouts).
Padding(
left: Int = 0,
top: Int = 0,
right: Int = 0,
bottom: Int = 0
)
Camera padding.
Specified as an inward offset from the edges, in physical pixels. The paddings affect:
- the position point;
- animated map movement;
- the placement of dynamic map objects (such as route callouts).
Page
Search results page.
fun fetchPrevPage(): Future<Page?>
Gets the previous page of results.
Future that resolves into a non-null pointer to the previous page if the page is retrieved successfully. Future that resolves to a null pointer if there is no previous page. Exceptional future if an error occurred while fetching the page.
fun fetchNextPage(): Future<Page?>
Gets the next page of results.
Future that resolves to a non-null pointer to the next page if the page is retrieved successfully. Future that resolves to a null pointer if there is no next page. Exceptional future if an error occurred while fetching the page.
Non-empty set of reference objects for this page.
ParkingCapacity
Parking capacity.
ParkingCapacity(total: String?, specialSpaces: List<SpecialSpace>)
Parking capacity.
Total parking capacity, amount of parking lots.
Description of special parking lots.
ParkingInfo
General parking information.
ParkingInfo(
type: ParkingType?,
purpose: ParkingPurpose,
access: ParkingAccess,
pavingType: ParkingPavingType?,
isPaid: Boolean,
isIncentive: Boolean,
forTrucks: Boolean,
levelCount: Short?,
capacity: ParkingCapacity?
)
General parking information.
Type.
Parking purpose.
Access type.
Paving type.
Whether the parking is chargeable.
Whether the parking is incentive.
There are places for trucks.
Number of levels.
Capacity.
PedestrianBriefRouteInfo
Basic information about the pedestrian route.
PedestrianBriefRouteInfo(length: RouteDistance, landmark: String)
Basic information about the pedestrian route.
PedestrianInstructionCrossroad
Description of maneuvers when passing through an intersection or a pedestrian crossing.
PedestrianInstructionCrossroad(landmark: PedestrianInstructionCrossroadLandmark = PedestrianInstructionCrossroadLandmark.NONE, maneuvers: List<PedestrianInstructionCrossroadManeuver>)
Description of maneuvers when passing through an intersection or a pedestrian crossing.
Chain of consecutive maneuvers.
PedestrianInstructionCrossroadManeuver
PedestrianInstructionCrossroadManeuver(direction: PedestrianInstructionCrossroadManeuverDirection = PedestrianInstructionCrossroadManeuverDirection.STRAIGHT, turnAngle: Int = 0)
Direction of movement.
PedestrianInstructionFinish
End of the pedestrian part of the route.
PedestrianInstructionFinish()
End of the pedestrian part of the route.
PedestrianInstructionIndoorEnter
Entrance to the building.
PedestrianInstructionIndoorEnter(levelId: LevelId = LevelId())
Entrance to the building.
Floor ID after entering the building.
PedestrianInstructionIndoorExit
Exit of the building.
PedestrianInstructionIndoorExit()
Exit of the building.
PedestrianInstructionIndoorFloorChange
Change of floors in the building.
PedestrianInstructionIndoorFloorChange(
type: PedestrianInstructionIndoorFloorChangeType = PedestrianInstructionIndoorFloorChangeType.UNDEFINED,
beginId: LevelId = LevelId(),
endId: LevelId = LevelId()
)
Change of floors in the building.
Type of the floor change.
Floor ID before change.
Floor ID after change.
PedestrianInstructionStart
Beginning of the pedestrian part of the route.
PedestrianInstructionStart()
Beginning of the pedestrian part of the route.
PedestrianRouteSearchOptions
Pedestrian route search options.
PedestrianRouteSearchOptions(
avoidStairways: Boolean = false,
avoidUnderpassesAndOverpasses: Boolean = false,
useIndoor: Boolean = true,
excludedAreas: List<ExcludedArea> = listOf()
)
Pedestrian route search options.
Avoid stairways.
Avoid underpasses and overpasses.
Build indoor routes.
Excluded areas (not more than 25).
PerformSearchHandler
Suggested to search for a specific set of objects.
Query to run through the search engine.
PointGeometry
PointGeometryData
Geometry data of the point object.
PointGeometryData(geoPointWithElevation: GeoPointWithElevation)
fun match(geoPoint: Function1, geoPointWithElevation: Function1): T
fun toString(): String
fun hashCode(): Int
Polygon
Polygon on the map.
Polygon(options: PolygonOptions)
Creates a polygon based on the parameters.
PolygonGeometry
PolygonOptions
Polygon settings.
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
)
Polygon settings.
Object rendering level.
Link to the floor plan of the building.
Polyline
Polyline on the map.
Gets parameters of a dashed polyline.
Gets gradient polyline parameters.
PolylineGeometry
PolylineOptions
Polyline options.
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
)
Polyline options.
Points of a polyline.
Polyline width.
Primary color of the polyline.
Dashed polyline options.
Dashed gradient line options are not currently supported, so if both dashed_polyline_options and gradient_polyline_options are present in PolylineOptions, then dashed_polyline_options is ignored when creating the polyline.
Gradient polyline options.
Dashed gradient line is currently not supported, so if both dashed_polyline_options and gradient_polyline_options are present in PolylineOptions, dashed_polyline_options is ignored when creating the polyline.
Polyline visibility.
User data.
Object rendering level.
Link to the floor plan of the building.
Projection
Projection.
Uses the Mercator spherical projection (EPSG:3857), looped in longitude. Displayed data is limited in latitude from -85.06° to 85.06°.
fun screenToMap(point: ScreenPoint): GeoPoint?
Calculates a map point at the specified screen point.
The function returns an empty value if the specified screen point is outside the map projection.
fun mapToScreen(point: GeoPointWithElevation): ScreenPoint?
Calculates the screen point corresponding to the specified map point.
The function returns an empty value:
fun screenToMapClipped(point: ScreenPoint): GeoPoint
Calculates the nearest map point to the projection of the specified screen point.
PublicBriefRouteInfo
Basic information about rotes by public transport.
PublicBriefRouteInfo(publicTransportInfos: List<PublicBriefRouteTransportInfo>)
Basic information about rotes by public transport.
Description of ways to travel by public transport.
PublicBriefRouteTransportInfo
Description of the public transport vehicle.
PublicBriefRouteTransportInfo(
type: PublicTransportType = PublicTransportType.BUS,
names: List<String>,
color: Int?,
routeLogo: String
)
Description of the public transport vehicle.
Public transport type.
Names of public transport routes on which travel takes place.
ARGB representation of the color associated with this type of public transport, for example, the color of a subway line. If there is no color information, the field is null.
Identifier of the icon for route stops. Empty string if information is not available. Technical field.
PublicRoutePart
Description of the section of the route by public transport.
PublicRoutePart(transports: List<PublicTransportInfo>, intermediateStops: List<PublicTransportStop>)
Description of the section of the route by public transport.
Types of public transport that can be used to travel this section of the route.
If the list is empty, this section of the route is suggested to be overcome by personal or rented transport or on foot.
Intermediate stops that the transport will pass before reaching the transfer point.
Stops are sorted in the order they appear on the route.
You do not need to get off at these stops.
Start and end stops are not included in this list.
PublicTransportCard
Card that displays information about a public transport route.
PublicTransportCard(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Card that displays information about a public transport route.
fun onAttachedToWindow(): Unit
PublicTransportCardModel
Model for PublicTransportCard.
PublicTransportCardModel(
route: TrafficRoute,
context: Context,
startName: String? = null,
finishName: String? = null
)
Model for PublicTransportCard.
Brief information (displayed in the "header" of the card).
Transfer points.
PublicTransportInfo
Description of the public transport vehicle.
PublicTransportInfo(
type: PublicTransportType = PublicTransportType.BUS,
names: List<String>,
suggestedCarNumbers: List<Int>,
boardingSuggest: String,
color: Int?,
routeLogo: String
)
Description of the public transport vehicle.
Public transport type.
Names of public transport routes on which travel takes place.
Numbers of wagons where boarding is recommended.
If the vehicle consists of one wagon or you can board any wagon, this list is empty.
Text description of wagons recommended for boarding.
ARGB representation of the color associated with this type of public transport, for example, the color of a subway line. If there is no color information, the field is null.
Identifier of the icon for route stops. Empty string if information is not available. Technical field.
PublicTransportRouteSearchOptions
Search options for a public transport route.
PublicTransportRouteSearchOptions(
startTime: TimePoint? = null,
useSchedule: Boolean = false,
transportTypes: EnumSet<PublicTransportType> = EnumSet.noneOf(PublicTransportType::class.java)
)
Search options for a public transport route.
Time in UTC for which the route should be built. If not set, the current time is used.
Whether to refer to the public transport schedule when building a route.
Types of public transport. If not filled, routes are built for all supported types of public transport.
PublicTransportStop
Description of the public transport stop.
PublicTransportTransfer
Description of how to get to the next transfer point by public transport.
PublicTransportTransfer(
startPointName: String,
finishPointName: String,
routeParts: List<PublicRoutePart>
)
Description of how to get to the next transfer point by public transport.
Name of the point from which the movement for this section of the route begins.
Destination point name for this route segment.
Description of the route segment on public transport, which can be used to get to the next transfer point.
All route segments from this list follow the same geometry line.
If the list is empty, then this route segment it is suggested to be passed by personal or rented transport or on foot.
PublicTransportTransferRouteLongAttribute
Container that stores an extended route attribute. Each element is stored as a pair consisting of a point and an attribute element value. Attribute action starts at this point and ends at the next point, at which the next element's attribute action begins.
fun entry(point: RoutePoint): PublicTransportTransferRouteLongEntry?
Element that the specified point falls into.
fun entries(begin: RoutePoint, end: RoutePoint): List<PublicTransportTransferRouteLongEntry>
Elements partially or completely covered by the begin,end range.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
PublicTransportTransferRouteLongEntry
Extended route element - segment and value on it.
PublicTransportTransferRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: PublicTransportTransfer
)
Extended route element - segment and value on it.
PurposeCode
Code of the purpose of the building.
Range
Describes a set of discrete ordered values.
fun match(borders: Function1, orderedValues: Function1): T
fun toString(): String
fun hashCode(): Int
RangeFilter
Filter for the value ranges.
RangeWidget
Widget for representing a continuous or a discrete set of ordered values.
Gets a set of ordered values.
RemainingRouteInfoControl
Navigator UI control that displays information about the remaining distance to the route finish and the remaining travel time.
RemainingRouteInfoControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Navigator UI control that displays information about the remaining distance to the route finish and the remaining travel time.
fun detachFromManager(): Unit
Remover
Object to remove user content.
fun remove(): Future<ActionResult>
Deletes content.
Action is available for content authored by the user.
RenderedObject
Displayable map object.
RenderedObjectInfo
Detailed information about the displayable map object.
RenderedObjectInfo(
closestViewportPoint: ScreenPoint,
closestMapPoint: GeoPointWithElevation,
item: RenderedObject
)
Detailed information about the displayable map object.
Nearest point of the object in screen coordinates.
Nearest point of the object in map coordinates.
Displayable map object.
Reviews
Reviews.
RoadCameraInfo
Camera information.
RoadCameraInfo(purposes: EnumSet<CameraPurpose>, speedLimit: Short?)
Camera information.
Camera purposes.
May be missing if there is no information, or if the camera was added by the user.
Speed limit in km/h.
Currently available for speed and average speed cameras only.
May not be available for speed cameras if the value is unknown.
RoadEvent
Traffic event.
Event type.
Localized event name.
Information about the user who added the event.
Timestamp of event creation.
Event coordinates.
Custom description of the traffic event.
Information about the camera.
Available for events of the "Camera" type only.
Schedule.
Currently available for road blockings only, and may not even exist.
Affected lanes.
Currently, can be set for custom events only.
List of available actions with the event.
Gets the object to delete the event.
RoadEventAction
Event action.
fun set(): Future<ActionResult>
Applies an action (for example, adds a "like", confirms an event).
There are opposite actions, such as "like" and "dislike". If both actions are available for an event, the method call resets the application of the opposite - it is impossible to put "like" and "dislike" at the same time.
fun reset(): Future<ActionResult>
Cancels an action (for example, restores the "like", resets confirmation of an event).
There are actions that are opposite of each other, for example "like" and "dislike". If both are available for an event action, calling the method does not cause the opposite action to be applied.
Action type.
Localized action name.
Information about the action.
Information about the action.
RoadEventActionButton
Action button for the traffic event (confirm, like, etc.).
RoadEventActionButton(model: RoadEventActionButtonModel, context: Context)
Action button for the traffic event (confirm, like, etc.).
RoadEventActionInfo
Information about the action.
RoadEventActionInfo(state: RoadEventActionState, count: Int?)
Information about the action.
Action state.
Number of actions applied to the event by all users (only for custom events).
RoadEventCard
Card that displays information about a traffic event.
RoadEventCard(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Card that displays information about a traffic event.
Notification about the event deletion completion.
Notification about action completion.
RoadEventCardModel
Traffic event card model.
RoadEventCardModel(
event: RoadEvent,
photoSize: StatefulChannel<ScreenSize>,
context: Context
)
Traffic event card model.
fun close(): Unit
Name, e.g. "Closure".
Description, e.g. "Road works".
Affected lanes, e.g. "Left lane, middle lane".
Schedule, for example, "October 10th 08:00 - October 15th 23:30".
Creation time, e.g. "5 hours ago", "August 5", "December 10, 2020".
Author, for example, "2GIS".
Photo.
Notification about action completion.
Notification about event deletion completion.
Actions.
RoadEventManager
Object for creating traffic events.
RoadEventManager(context: Context)
Gets an object for creating traffic events.
fun createAccident(
location: GeoPoint,
lanes: EnumSet<Lane>,
description: String
): Future<AddEventResult>
Creates an "Accident" event.
Event location.
Lanes of the road affected by the event.
Custom event description.
fun createCamera(location: GeoPoint, description: String): Future<AddEventResult>
Creates a "Camera" event.
Event location.
Custom event description.
fun createRoadRestriction(location: GeoPoint, description: String): Future<AddEventResult>
Creates a "Road closure" event.
Event location.
Custom event description.
fun createComment(location: GeoPoint, description: String): Future<AddEventResult>
Creates a "Comment" event.
Event location.
Custom event description.
fun createOther(
location: GeoPoint,
lanes: EnumSet<Lane>,
description: String
): Future<AddEventResult>
Creates an "Other" event.
Event location.
Lanes of the road affected by the event.
Custom event description.
fun createRoadWorks(
location: GeoPoint,
lanes: EnumSet<Lane>,
description: String
): Future<AddEventResult>
Creates a "Road works" event.
Event location.
Lanes of the road affected by the event.
Custom event description.
RoadEventMapObject
RoadEventPhoto
Photograph of a traffic event.
fun previewUrl(desiredSize: ScreenSize): String
Photo preview URL.
fun report(): Future<ActionResult>
Submits a complaint about a photo.
Complaining your photo will not be processed.
URL of a full-sized photo.
Information about the user who added the photo.
Timestamp.
Gets an object for deleting a photo.
RoadEventRouteAttribute
Container that describes a point attribute of a route. Each element is stored as the point on the route (where the element is located) and the value of the element itself.
fun entries(begin: RoutePoint, end: RoutePoint): List<RoadEventRouteEntry>
Elements falling within the [begin, end) range.
fun findNearBackward(point: RoutePoint): RoadEventRouteEntry?
Finds the nearest element the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
fun findNearForward(point: RoutePoint): RoadEventRouteEntry?
Finds the nearest element the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
RoadEventRouteEntry
Route element - point and value in it.
RoadEventRouteEntry(point: RoutePoint, value: BriefRoadEvent)
Route element - point and value in it.
RoadEventSource
Interface of the class that controls the display of traffic events (tUGC) on the map.
RoadEventSource(context: Context)
Creates a source that displays traffic events on the map.
fun setHighlighted(directoryObjectIds: List<DgisObjectId>, highlighted: Boolean): Unit
IDs of changeable events. Can be obtained from RoadEventMapObject.
Gets the current categories of events provided by this source.
RoadMacroGraph
Global road graph package, used to build a passage between two loaded offline territories.
RoadRuleRouteLongAttribute
Container that stores an extended route attribute. Each element is stored as a pair consisting of a point and an attribute element value. Attribute action starts at this point and ends at the next point, at which the next element's attribute action begins.
fun entry(point: RoutePoint): RoadRuleRouteLongEntry?
Element that the specified point falls into.
fun entries(begin: RoutePoint, end: RoutePoint): List<RoadRuleRouteLongEntry>
Elements partially or completely covered by the begin,end range.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
RoadRuleRouteLongEntry
Extended route element - segment and value on it.
RoadRuleRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: RoadRule
)
Extended route element - segment and value on it.
RoadSubtypeRouteLongAttribute
Container that stores an extended route attribute. Each element is stored as a pair consisting of a point and an attribute element value. Attribute action starts at this point and ends at the next point, at which the next element's attribute action begins.
fun entry(point: RoutePoint): RoadSubtypeRouteLongEntry?
Element that the specified point falls into.
fun entries(begin: RoutePoint, end: RoutePoint): List<RoadSubtypeRouteLongEntry>
Elements partially or completely covered by the begin,end range.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
RoadSubtypeRouteLongEntry
Extended route element - segment and value on it.
RoadSubtypeRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: RoadSubtype
)
Extended route element - segment and value on it.
RoadSurfaceRouteLongAttribute
Container that stores an extended route attribute. Each element is stored as a pair consisting of a point and an attribute element value. Attribute action starts at this point and ends at the next point, at which the next element's attribute action begins.
fun entry(point: RoutePoint): RoadSurfaceRouteLongEntry?
Element that the specified point falls into.
fun entries(begin: RoutePoint, end: RoutePoint): List<RoadSurfaceRouteLongEntry>
Elements partially or completely covered by the begin,end range.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
RoadSurfaceRouteLongEntry
Extended route element - segment and value on it.
RoadSurfaceRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: RoadSurface
)
Extended route element - segment and value on it.
RoadTypeRouteLongAttribute
Container that stores an extended route attribute. Each element is stored as a pair consisting of a point and an attribute element value. Attribute action starts at this point and ends at the next point, at which the next element's attribute action begins.
fun entry(point: RoutePoint): RoadTypeRouteLongEntry?
Element that the specified point falls into.
fun entries(begin: RoutePoint, end: RoutePoint): List<RoadTypeRouteLongEntry>
Elements partially or completely covered by the begin,end range.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
RoadTypeRouteLongEntry
Extended route element - segment and value on it.
RoadTypeRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: RoadType
)
Extended route element - segment and value on it.
RotateMapToNorthEvent
RotationSettings
Settings for handling map rotation.
Angle change threshold, in degrees, after which it starts sending rotation messages. Used if scaling is inactive.
Threshold of mean radial shift of points, in millimeters, after which it starts sending rotation messages. Used if scaling is inactive.
Angle change threshold, in degrees, after which it starts sending rotation messages. Used if scaling is active.
Threshold of mean radial shift of points, in millimeters, after which it starts sending rotation messages. Used if scaling is active.
Route
Class that describes a route. A route is a set of attributes, each of which is a container of the RouteAttribute or the RouteLongAttribute type, which stores elements of route attributes. Route attributes are divided into point and length attributes. Point attributes (for example, geometry points or speed bumps) are specified as a pair of a RoutePoint and an attribute value. Long attributes (such as the width of a roadway or a speed limit) are specified as a pair of a RoutePoint specifying the beginning of the attribute's action and the attribute's value. A terminator is placed at the end of the route. For example, let the width of the roadway be given as a set of pairs {{0m, 3m}, {10m, 7m}, {20m, 5m}, {30m, 0m}}, then the first 10 meters of the route the carriageway has a width of 3 meters, at the interval [10m., 20m.) - 7m., from 20m. to the end of the route - 5m.
Route geometry.
It is not guaranteed that the RoutePoint of geometry points will match the RoutePoint of other attribute elements, so to calculate the geographic coordinate of an attribute element, you do not need to search the geometry for an element RoutePoint of which matches the RoutePoint attribute element, calculate_geo_point should be used instead.
Instructions to be followed on the route.
Intermediate points through which the route passes. The route may not pass directly through the intermediate point, but near it. The attribute value stores the coordinate at which the intermediate point was set, the key contains the coordinate of the projection of the intermediate point onto the route.
Altitudes on the route.
Bad road (there are bumps and potholes on the road that impede the passage).
Obstacles on the route.
Road/street names.
Sign that the route section passes through the settlement.
Type of transport for which the route section is built.
Road cameras.
Width of the roadway in meters. 0 - width is unknown.
Exit signs.
Speed bumps.
Traffic lanes.
Floors of buildings.
Maximum allowed speed limits.
0 - speed limit is unknown.
Side of traffic.
Additional description for the road type where the route is built.
Road paving.
Type of road along which the route passes.
Segments of the route that run along toll roads.
Sign of the presence or absence of data for cargo navigation.
Checkpoints for trucks.
Indication of the validity of the sign prohibiting of the trucks passage.
Indication of the validity of the sign prohibiting the passage of any vehicles (overlapping).
Indication of the presence of a dedicated cycle lane.
Indication of the presence of traffic lights.
Description of ways to travel between transfer points by public transport.
RouteBuildOptions
Structure that describes parameters for building a route in the navigator.
RouteBuildOptions(finishPoint: RouteSearchPoint, routeSearchOptions: RouteSearchOptions)
Structure that describes parameters for building a route in the navigator.
Point to which the route is built.
Route search options.
RouteCamera
Structure describing a traffic camera.
RouteCamera(
purposes: EnumSet<RouteCameraPurpose>,
rangeAgainst: RouteDistance,
rangeAlong: RouteDistance,
direction: RouteCameraDirection = RouteCameraDirection.AGAINST
)
Structure describing a traffic camera.
Camera purpose.
Camera operation range against the direction of movement.
Camera operation range along the direction of movement.
Camera operation direction.
RouteDistance
Distance along the route.
fun absoluteValue(): RouteDistance
operator fun plus(other: RouteDistance): RouteDistance
operator fun minus(other: RouteDistance): RouteDistance
RouteEditor
Interface for the route editor. The route editor obtains the starting and the finish points of the route, builds routes, and notifies about their updates and rebuilds via channels.
All methods of this interface are called from a single thread.
fun setRouteParams(routeParams: RouteEditorRouteParams): Unit
Sets route editor parameters. Starts searching for a new route according to the given parameters.
fun setActiveRouteIndex(index: RouteIndex): Unit
Sets the active route index.
Channel through which you can monitor updates about the routes operated by the editor.
Channel through which you can monitor updates about the routes operated by the editor.
Channel through which you can monitor the active route index updates. If there are no routes, null is placed in this channel.
Channel through which you can monitor the active route index updates. If there are no routes, null is placed in this channel.
RouteEditorRouteParams
Information about route parameters.
RouteEditorRouteParams(
startPoint: RouteSearchPoint,
finishPoint: RouteSearchPoint,
routeSearchOptions: RouteSearchOptions,
intermediatePoints: List<RouteSearchPoint> = listOf()
)
Information about route parameters.
RouteEditorRoutesInfo
Information about routes operated by the editor.
RouteEditorRoutesInfo(routes: List<TrafficRoute>, routeParams: RouteEditorRouteParams)
Information about routes operated by the editor.
When updating the list of routes, the first route is active, if the list is not empty.
Parameters of the route that were searched for. May differ from the parameters passed to the editor if the routes were already found after the parameters were changed in the editor.
RouteEditorSource
Interface of the class that controls the display of routes on the map.
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
)
Function to create IRouteEditorSource.
fun setRoutesVisible(visible: Boolean): Unit
Enables or disables the routes display on the map.
fun setShowOnlyActiveRoute(showOnlyActiveRoute: Boolean): Unit
Shows all routes on the map (false) or only the current active route (true).
fun setPassedDistanceVisualization(passedDistanceVisualization: RouteMapObjectPassedDistanceVisualization): Unit
Changes the method of visualizing the distance traveled along a route.
Route objects on the map.
Settings for displaying maneuvers on the route.
Display flags for the active route. See IRouteMapObject::display_flags.
Display flags for inactive routes. See IRouteMapObject::display_flags.
Flags enabling the display of content in callouts for active routes. See IRouteMapObject::callout_label_flags.
Flags enabling the display of content in callouts for inactive routes. See IRouteMapObject::callout_label_flags.
Display mode for values in route callouts. See IRouteMapObject::callout_label_display_mode.
Flags excluding the hiding of components of the active route from the map. See IRouteMapObject::permanent_display_flags.
Flags excluding the hiding of components of inactive routes from the map. See IRouteMapObject::permanent_display_flags.
RouteExitSign
Information about the exit sign.
RouteExitSign(
type: RouteExitSignType = RouteExitSignType.UNDEFINED,
roadNameTable: RouteExitSignTable,
roadNumberTable: RouteExitSignTable?
)
Information about the exit sign.
Exit type.
Exit sign with the road name.
Exit sign with the road number.
RouteExitSignRouteAttribute
Container that describes a point attribute of a route. Each element is stored as the point on the route (where the element is located) and the value of the element itself.
fun entries(begin: RoutePoint, end: RoutePoint): List<RouteExitSignRouteEntry>
Elements falling within the [begin, end) range.
fun findNearBackward(point: RoutePoint): RouteExitSignRouteEntry?
Finds the nearest element the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
fun findNearForward(point: RoutePoint): RouteExitSignRouteEntry?
Finds the nearest element the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
RouteExitSignRouteEntry
Route element - point and value in it.
RouteExitSignRouteEntry(point: RoutePoint, value: RouteExitSign)
Route element - point and value in it.
RouteExitSignTable
Information about the exit plate.
RouteExitSignTable(backgroundColor: RouteExitSignTableColor = RouteExitSignTableColor.UNDEFINED, text: String)
Information about the exit plate.
Exit plate background color.
Text on the exit plate.
RouteIndex
Active route index.
RouteInfo
Route description with maneuvers.
RouteInfo(route: Route, routeBuildOptions: RouteBuildOptions?)
Route description with maneuvers.
Route.
Route building parameters in the navigator. A null value means that the route has no finish point. In this case, based on the road graph and user movement parameters, a section of the road on which the user is likely to move is calculated and returned as a route in the route field. Therefore, such a "route" cannot contain instructions, and the last point in this "route" is not a destination where the user is moving to, but just a point where the navigator managed to predict the user's movement. Where they will go next is unknown. This navigation mode is called free roam.
RouteInfoCalloutMapObject
Callout object with information about the length and/or duration of the route on the map.
Route, part of which is represented by the given callout object.
Route index.
Position on the route where the callout is located.
RouteInstruction
Instruction to follow while moving along the route.
RouteInstruction(
roadName: String,
range: RouteDistance,
extraInstructionInfo: ExtraInstructionInfo
)
Instruction to follow while moving along the route.
Name of the road where the user appears after the maneuver.
Distance after the instruction point during which it is considered that the user is in the instruction's operation zone.
Information specific for the certain type of instruction.
RouteLane
Structure describing one traffic lane.
RouteLane(
routeManeuver: RouteLaneManeuver = RouteLaneManeuver.UNDEFINED,
maneuvers: EnumSet<RouteLaneManeuver>,
speedLimit: Float = 0.0f,
prohibited: Boolean = false,
onlyPublicTransport: Boolean = false
)
Structure describing one traffic lane.
Maneuver that must be performed to move along the route.
Permissible maneuvers on the lane.
Maximum allowed speed on the lane m/s. 0 - speed limit unknown.
Traveling on the lane is prohibited.
Public transport lane.
RouteLaneSign
Description of traffic lanes.
RouteLaneSign(
lanes: List<RouteLane>,
signStartPoint: RoutePoint?,
signPoint: RoutePoint?,
signEndPoint: RoutePoint?
)
Description of traffic lanes.
Car lanes on a road section. Ordered from the edge to middle of roadgeway.
If the number of lanes is unknown, or there is one lane on the road in the direction of the route, this array is empty.
Point on the route where the operation of the sign regulating lane traffic begins. null if the position of the sign operation start is unknown.
Point on the route where the sign regulating lane traffic is placed. null if the position of the sign is unknown.
Point on the route where the operation of the sign regulating lane traffic ends. null if the position the sign operation end is unknown.
RouteLevelInfo
Information about the floor of the building corresponding to the route section.
Identifier of the floor plan at the starting point of the route segment. None if the point is not in a building.
Identifier of the floor plan at the finish point of the route segment. None if the point is not in a building.
Name of the floor. Empty if the route segment connects different floors.
RouteLevelInfoRouteLongAttribute
Container that stores an extended route attribute. Each element is stored as a pair consisting of a point and an attribute element value. Attribute action starts at this point and ends at the next point, at which the next element's attribute action begins.
fun entry(point: RoutePoint): RouteLevelInfoRouteLongEntry?
Element that the specified point falls into.
fun entries(begin: RoutePoint, end: RoutePoint): List<RouteLevelInfoRouteLongEntry>
Elements partially or completely covered by the begin,end range.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
RouteLevelInfoRouteLongEntry
Extended route element - segment and value on it.
RouteLevelInfoRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: RouteLevelInfo
)
Extended route element - segment and value on it.
RouteMapObject
Route object on the map.
RouteMapObject(
trafficRoute: TrafficRoute,
isActive: Boolean,
index: RouteIndex,
displayFlags: EnumSet?<RouteMapObjectDisplayFlag> = null,
calloutLabelFlags: EnumSet?<RouteMapObjectCalloutLabelFlag> = null,
calloutLabelDisplayMode: RouteMapObjectCalloutLabelDisplayMode = RouteMapObjectCalloutLabelDisplayMode.ABSOLUTE_VALUES,
permanentDisplayFlags: EnumSet?<RouteMapObjectPermanentDisplayFlag> = null
)
Set of flags to display various parts of the route. If not specified, display logic based on the activity status of the route is used.
Set of flags to display various parts of the route. If not specified, display logic based on the activity status of the route is used.
Set of flags to prevent various parts of the route from being hidden from the map when updating the distance traveled along the route. If not specified, then when updating the distance traveled along the route, all route elements that fall into the undisplayed part of the route are hidden from the map.
Set of flags to prevent various parts of the route from being hidden from the map when updating the distance traveled along the route. If not specified, then when updating the distance traveled along the route, all route elements that fall into the undisplayed part of the route are hidden from the map.
Route activity status.
Route activity status.
Route.
Route index in the route editor.
Distance traveled along the route.
Distance traveled along the route.
Route callout position.
Route callout position.
Set of flags for displaying the contents of the route callouts. If not specified, both the time of movement along the route and its length are displayed for the active route, and only the time of movement for inactive routes.
Set of flags for displaying the contents of the route callouts. If not specified, both the time of movement along the route and its length are displayed for the active route, and only the time of movement for inactive routes.
Mode for displaying values in route callouts. By default, values are displayed as absolute values.
Mode for displaying values in route callouts. By default, values are displayed as absolute values.
Lane callout positions. Only relevant positions are returned for the current distance traveled along the route, and only if the source where the object is placed is in navigation mode.
Lane callout positions. Only relevant positions are returned for the current distance traveled along the route, and only if the source where the object is placed is in navigation mode.
RouteMapObjectSource
Source of route objects on the map.
RouteMapObjectSource(context: Context, routeVisualizationType: RouteVisualizationType = RouteVisualizationType.NORMAL)
Function to create IRouteMapObjectSource.
fun addObject(item: RouteMapObject): Unit
Adds a route object to the source.
fun removeObject(item: RouteMapObject): Unit
Removes the route object from the source.
fun replaceObject(oldObject: RouteMapObject, newObject: RouteMapObject): Unit
Replacing one route object in the source with another. Unlike deleting and adding route objects through successive calls to remove_object and add_object, replacing one route to another is executed atomically - the old route is deleted and a new one appears on the map at the same time.
If the old route is not found in the source, then the call is equivalent to calling add_object.
fun replaceAllObjects(objects: List<RouteMapObject>): Unit
Replaces all objects previously added to the source with the passed list of objects. In contrast to deleting and adding objects one at a time, the replacement is performed atomically - old routes are deleted, and new routes appear on the map at the same time.
Route objects.
Sets the display of objects in the source.
RouteMapSettings
Settings for displaying the route on the map.
Flags for displaying the route on the map for the route navigation mode. By default, all flags are enabled except for the InactiveFloors flag.
Flags for displaying the route on the map for the free roam mode. The flags Cameras, Humps, Accidents, RoadWorks, Comments, RoadRestrictions, OtherEvents are enabled by default.
Flags to prevent hiding various parts of the route from the map when updating the distance traveled along the route for route navigation mode. By default, all route elements are hidden.
Flags that prevent hiding various parts of the route from the map when updating the distance traveled along the route for free roam mode. By default, all route elements are hidden.
RouteOverviewControl
Control displayed in route view.
RouteOverviewControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Control displayed in route view.
RoutePoint
Point on the route, specified as the distance along the route relatively to the beginning of the route.
RoutePoint(distance: RouteDistance)
Point on the route, specified as the distance along the route relatively to the beginning of the route.
operator fun plus(distance: RouteDistance): RoutePoint
operator fun minus(distance: RouteDistance): RoutePoint
RoutePointMapObject
Feature that is part of a route on the map (for example, the starting or the finish point of a route).
Route, the part of which the given feature represents.
Route index.
Route feature type.
Position on the route corresponding to the given feature.
Geographic coordinates at which this feature is located.
Geographic coordinates at which this feature is located.
RouteSearchOptions
Route search options.
RouteSearchOptions(pedestrian: PedestrianRouteSearchOptions)
RouteSearchOptions(publicTransport: PublicTransportRouteSearchOptions)
fun match(
bicycle: Function1,
car: Function1,
pedestrian: Function1,
publicTransport: Function1,
scooter: Function1,
taxi: Function1,
truck: Function1
): T
fun toString(): String
fun hashCode(): Int
RouteSearchPoint
Description of the points by which the route is built.
RouteSearchPoint(
coordinates: GeoPoint,
course: Bearing? = null,
objectId: DgisObjectId = DgisObjectId(objectId = 0, entranceId = 0),
levelId: LevelId? = null
)
Description of the points by which the route is built.
Coordinates to build a route through.
Direction in which the point should be passed.
ID of the object to which the pedestrian part of the route is built.
Floor plan identifier (for pedestrian routes).
RouteSourceSettings
Route source settings.
fun getLargeScaleMergeDistanceMeters(transportType: TransportType): Float
Minimum allowable distance in meters between successive maneuver arrows for a large scale. If the distance is less than the specified one, then the arrows are merged.
fun setLargeScaleMergeDistanceMeters(distance: Float, transportType: TransportType): Unit
Sets the minimum allowed distance in meters between successive maneuver arrows for large scale.
Distance in meters.
Type of transport for which the distance is set.
fun getSmallScaleMergeDistanceMeters(transportType: TransportType): Float
Minimum allowable distance in meters between successive maneuver arrows for a small scaling. If the distance is less than the specified one, the arrows are merged.
fun setSmallScaleMergeDistanceMeters(distance: Float, transportType: TransportType): Unit
Sets the minimum allowable distance in meters between successive maneuver arrows for small scaling.
Distance in meters.
Type of transport for which the distance is set.
fun getLargeScaleCrossroadsOffsetMeters(transportType: TransportType): Float
Offset in meters from the intersection point to the start and end of the large scale maneuver arrow.
fun setLargeScaleCrossroadsOffsetMeters(offset: Float, transportType: TransportType): Unit
Sets the offset in meters from the intersection point to the start and end of the maneuver arrow for the large scale. Allows you to set the size of the maneuver arrow.
Offset in meters.
Transport type for which the offset is set.
fun getSmallScaleCrossroadsOffsetMeters(transportType: TransportType): Float
Offset from the intersection point to the start and end of the maneuver arrow for the small scale.
fun setSmallScaleCrossroadsOffsetMeters(offset: Float, transportType: TransportType): Unit
Sets the offset from the intersection point to the start and end of the maneuver arrow for the small scale. Allows you to set the size of the maneuver arrow.
Offset in meters.
Transport type for which the offset is set.
Offset from the roundabout exit point to the start and end of the maneuver arrow for large scale. Allows you to set the size of the maneuver arrow.
Offset from the roundabout exit point to the beginning and end of the maneuver arrow for small scale. Allows you to set the size of the maneuver arrow.
Mode for displaying callouts with time and route length.
RubricId
Identifier of the rubric.
ScaleMapEvent
Map scale change event.
ScaleMapEvent(zoomDelta: Float, scalingCenter: ScreenPoint? = null)
Zoom event constructor.
Value by which the current zoom value changes.
Point on the screen around which the map is scaled. If no point is given, then scaling is relative to the map's position point.
Value by which the current zoom value changes.
Point on the screen around which the map is scaled.
ScalingSettings
Scaling factor threshold at which a scaling event is sent. Used if rotation is inactive. The multiplier must be out of bounds (1 / scale_ratio_threshold, scale_ratio_threshold).
Scaling factor threshold at which scaling messages is sent. Used if rotation is active. The multiplier must be out of bounds (1 / scale_ratio_threshold_in_rotation, scale_ratio_threshold_in_rotation).
Schedule
Traffic event schedule.
Schedule(
startTime: TimePoint?,
finishTime: TimePoint?,
weekTimeIntervals: List<WeekTimeInterval>
)
Traffic event schedule.
Action start time. Missing if unknown.
Action start time. Missing if unknown.
Work intervals within a week.
Intervals are ordered by time.
The first interval can start from last week.
ScooterBriefRouteInfo
Basic information about the scooter route.
ScooterBriefRouteInfo(length: RouteDistance, landmark: String)
Basic information about the scooter route.
ScooterInstructionCrossroad
Description of maneuvers when passing through an intersection or a pedestrian crossing.
ScooterInstructionCrossroad(landmark: ScooterInstructionCrossroadLandmark = ScooterInstructionCrossroadLandmark.NONE, maneuvers: List<ScooterInstructionCrossroadManeuver>)
Description of maneuvers when passing through an intersection or a pedestrian crossing.
Landmark.
Chain of consecutive maneuvers.
ScooterInstructionCrossroadManeuver
ScooterInstructionCrossroadManeuver(direction: ScooterInstructionCrossroadManeuverDirection = ScooterInstructionCrossroadManeuverDirection.STRAIGHT, turnAngle: Int = 0)
Direction of movement.
ScooterInstructionFinish
End of the scooter part of the route.
ScooterInstructionFinish()
End of the scooter part of the route.
ScooterInstructionStart
Beginning of the scooter part of the route.
ScooterInstructionStart()
Beginning of the scooter part of the route.
ScooterRouteSearchOptions
Scooter route search options.
ScooterRouteSearchOptions(
avoidCarRoads: Boolean = true,
avoidStairways: Boolean = true,
avoidUnderpassesAndOverpasses: Boolean = true,
excludedAreas: List<ExcludedArea> = listOf()
)
Scooter route search options.
Avoid highways.
Avoid stairways.
Avoid underpasses and overpasses.
Excluded areas (not more than 25).
ScreenDistance
Distance between objects on the screen in millimeters.
Cannot be negative.
ScreenDistance(value: Float = 0.0f)
Distance between objects on the screen in millimeters.
Cannot be negative.
ScreenPoint
Point in screen coordinates.
Directions of axes: x - rightwards, y - downwards. (0.0, 0.0) - the upper-left corner of the upper-left pixel. The integer part of the coordinate is the pixel number, the fractional part is the relative position within the pixel.
ScreenPoint(x: Float = 0.0f, y: Float = 0.0f)
Point in screen coordinates.
Directions of axes: x - rightwards, y - downwards. (0.0, 0.0) - the upper-left corner of the upper-left pixel. The integer part of the coordinate is the pixel number, the fractional part is the relative position within the pixel.
ScreenShift
Horizontal and vertical shift of the map in the coordinate space of the screen.
Positive shift direction: dx - to the right, dy - down.
ScreenSize
Size in pixels.
SearchLayout
UI control that provides a search bar and displays search results.
fun onAttachedToWindow(): Unit
fun onDetachedFromWindow(): Unit
fun addSearchViewCallback(callback: SearchViewCallback): Unit
Adds SearchViewCallback to respond to different states and work results of the search and the suggester.
fun configureSearchEngine(block: Function1): Unit
Configures the work of the search and the suggester. Methods of the SearchViewConfigurator interface are available inside the block.
fun hideResults(): Unit
Hides the UI of the search results and leaves only the search string. Method works only for the current query, when it is updated and new results appear, the output will be displayed again.
SearchManager
Search engine. Main entry point for the directory API.
fun suggest(query: SuggestQuery): Future<SuggestResult>
Gets suggestions matching the given query.
Future that resolves to a non-null pointer to the result of suggestion or exceptional future if an error occurred while getting suggestions.
fun search(query: SearchQuery): Future<SearchResult>
Gets directory objects matching the given query.
Future that resolves to a non-null pointer to the search result or exceptional future if an error occurred while getting the search results.
fun searchById(id: String): Future<DirectoryObject?>
Gets the directory object by string identifier.
Future that resolves to a pointer to a reference object. If the object is not found, a null pointer is returned.
fun searchByDirectoryObjectId(objectId: DgisObjectId): Future<DirectoryObject?>
Gets the directory object by identifier.
Future that resolves to a pointer to a reference object. If the object is not found, a null pointer is returned.
@JvmStatic
fun createOnlineManager(context: Context): SearchManager
Creates an online search engine.
@JvmStatic
fun createOfflineManager(context: Context): SearchManager
Creates a search engine that works with preloaded data.
@JvmStatic
fun createSmartManager(context: Context): SearchManager
Creates a search engine that works online or with preloaded data depending on the presence of Internet connection.
SearchOptions
Options for creating SearchLayout.
SearchOptions(
searchType: SearchType = SearchType.defaultSearchType,
pageSize: Int = defaultPageSize,
sortingType: SortingType = SortingType.BY_RELEVANCE,
suggestorType: SuggestorType = SuggestorType.GENERAL
)
Options for creating SearchLayout.
Search engine type. Possible values depend on the SDK delivery type. See SearchType for details. The default value depends on the SDK delivery type.
Limit on the number of hints in suggest and of search results. Valid values range from 1 to 50. Default: 10.
Search results sorting type. Default: SortingType.BY_RELEVANCE.
Suggester type. Default: SuggestorType.GENERAL
SearchQuery
Search query.
SearchQueryBuilder
Search query builder. The search is performed on the global index and local segment indexes, where a segment is a subdivision of the global map. The process of selecting segments for search is done as follows (in descending priority order):
This condition is not working yet.
fun setSpatialRestriction(spatialRestriction: List?<GeoPoint>): SearchQueryBuilder
Sets the search area limit in the form of a polygon. The first and the last points of the polygon do not have to match.
No limit by default.
fun setAreaOfInterest(rect: GeoRect?): SearchQueryBuilder
Sets a rectangular region of interest in geographic coordinates. A typical value is visible_rect from ICamera - the enclosing rectangle of the viewport.
fun setAllowedResultTypes(allowedResultTypes: List<ObjectType>): SearchQueryBuilder
Sets the object types allowed in the query result.
By default, all types except Route are allowed.
fun setPageSize(pageSize: Int): SearchQueryBuilder
Sets the preferred number of elements on the results page. Valid values are 1;50
. The default value is 10.
fun setDirectoryFilter(filter: DirectoryFilter): SearchQueryBuilder
Sets filtering for the search query.
fun setSortingType(sortingType: SortingType): SearchQueryBuilder
Sets sorting for the search query.
@JvmStatic
fun fromQueryText(queryText: String): SearchQueryBuilder
Starts building a text search query with the specified text.
@JvmStatic
fun fromRubricIds(rubricIds: List<RubricId>): SearchQueryBuilder
Starts building a search query based on the rubric identifiers.
@JvmStatic
fun fromQueryTextAndRubricIds(queryText: String, rubricIds: List<RubricId>): SearchQueryBuilder
Starts building a text search query with filtering by rubric identifiers.
@JvmStatic
fun fromQuery(query: SearchQuery): SearchQueryBuilder
Starts building a query based on #query to change some of the parameters.
The original #query remains unchanged.
SearchResult
Result of the search engine work.
fun markerTitles(objectIds: List<DgisObjectId>): List<Future<List<UIMarkerInfo>>>
Gets texts of markers by their IDs.
A vector
First page of search results.
Rectangular area suitable for displaying search results.
Asynchronous receiving of markers.
Search query type.
Dynamic filters for this query.
Quick filter widgets.
These are the so-called “quick filters” - filters that are most interesting to the user. There are no more than 5.
Filter widgets.
Indicates that the first result is suitable for direct use.
SegmentGeoPoint
Describes a geographic point on a segment and the direction of the segment. The geometry of the route is a sequence of points that form segments pairwise. In all functions that work with the geometry of the route, it is assumed that the first point from the pair forming the segment belongs to this segment, and the second one does not: [point_1, point_2),[point_2, point_3),...,[point_n-1, point_n)point_last. The last point forms a zero-length segment with itself. Thus, each point on the route belongs to exactly one segment. The direction of the point_last is not defined.
SegmentGeoPoint(point: GeoPoint, bearing: Bearing)
Describes a geographic point on a segment and the direction of the segment. The geometry of the route is a sequence of points that form segments pairwise. In all functions that work with the geometry of the route, it is assumed that the first point from the pair forming the segment belongs to this segment, and the second one does not: [point_1, point_2),[point_2, point_3),...,[point_n-1, point_n)point_last. The last point forms a zero-length segment with itself. Thus, each point on the route belongs to exactly one segment. The direction of the point_last is not defined.
SettlementRouteLongAttribute
Container that stores an extended route attribute. Each element is stored as a pair consisting of a point and an attribute element value. Attribute action starts at this point and ends at the next point, at which the next element's attribute action begins.
fun entry(point: RoutePoint): SettlementRouteLongEntry?
Element that the specified point falls into.
fun entries(begin: RoutePoint, end: RoutePoint): List<SettlementRouteLongEntry>
Elements partially or completely covered by the begin,end range.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
SettlementRouteLongEntry
Extended route element - segment and value on it.
SettlementRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: Settlement
)
Extended route element - segment and value on it.
ShowRouteControl
A control that controls the map flyover to the route.
ShowRouteControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
A control that controls the map flyover to the route.
fun showRoute(geometry: Geometry, styleZoomToTiltRelation: StyleZoomToTiltRelation?): Unit
fun cancelRouteOverview(): Unit
SimpleCheckableItem
Simple checkable element from CheckableItemsGroup.
Gets a text description of an element.
Gets a list of values by which filtering occurs. Usually one value.
Gets the state of an element.
SimpleClusterObject
Cluster of simple marker objects.
Gets the position of the cluster on the map.
Gets the number of markers in the cluster.
Gets a list of markers in the cluster.
Gets and sets the anchor point of the cluster icon.
Gets and sets the transparency of the cluster icon.
Gets and sets cluster caption.
Gets and sets the cluster caption style.
Gets and sets the target cluster width used for scaling.
Gets and sets the rotation angle of the cluster on the map relative to the north direction, clockwise.
Gets and sets the cluster appearance animation flag.
Gets and sets the rendering level of an object.
SimpleClusterOptions
Marker settings for a cluster of simple marker objects.
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
)
Marker settings for a cluster of simple marker objects.
Target width used for scaling.
Object rendering level.
Whether to animate appearance.
Animation mode.
SimpleMapObject
Object on the map for which visibility can be set.
SimulationAutoWithOverSpeed
Structure for setting the motion mode, taking into account the maximum speed on the edge of the route.
SimulationAutoWithOverSpeed(overSpeed: Double = 0.0)
Structure for setting the motion mode, taking into account the maximum speed on the edge of the route.
Used speed in m/s. Only values >= 0 are valid.
SimulationConstantSpeed
Structure for setting the motion mode at a constant speed
SimulationConstantSpeed(speed: Double = 0.0)
Structure for setting the motion mode at a constant speed
Speed in m/s. Only values >= 0 are valid.
SimulationSettings
Settings for simulation of navigating the route.
Simulator operation mode.
SimulationSpeedMode
SimulationSpeedMode(overSpeed: SimulationAutoWithOverSpeed)
fun match(speed: Function1, overSpeed: Function1): T
fun toString(): String
fun hashCode(): Int
SnapToMapLayout
Layout that allows you to bind the View to a point on the map.
SnapToMapLayout(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Layout that allows you to bind the View to a point on the map.
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
Sorting filter.
SoundNotificationSettings
Settings for sound alerts in the navigator. By default, all values of the alert sound categories are enabled. The user can change the values while working with the navigator.
Set of flags for sound notifications.
Source
Data source for the map.
This can be a source of traffic data, routes, markers, arbitrary geometric or other map objects. Any map object can have its own properties. The object properties affect which rules and display parameters, described in map styles, are applied to it. Style is a set of parameters and rules for displaying map objects, obtained through the style editor and used for rendering the map.
The object properties can be set:
- directly for the object;
- for the data source (all objects added to the source obtain these properties);
- for the map (all objects added to the map obtain these properties);
- for the style (all objects to which the style is applied obtain these properties). The list is presented in descending order of priority for applying properties. Even if no data sources are added to the map, the style and map properties still affect the map, since there are special displayable objects such as background.
SpecialSpace
Special parking spot.
SpecialSpace(
type: SpecialSpaceType,
name: String,
count: String?
)
Special parking spot.
Type.
Localized name of a special place.
Number of places of this type in the parking lot.
SpeedInfoControl
SpeedInfoControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
SpeedRange
Speed interval. Speed is specified in meters per second.
SpeedRangeToStyleZoom
Mapping of a speed interval to a style zoom.
SpeedRangeToStyleZoom(
range: SpeedRange,
minDistanceToManeuver: RouteDistance,
maxDistanceToManeuver: RouteDistance,
styleZoom: StyleZoom
)
Mapping of a speed interval to a style zoom.
Speed interval.
Minimum distance before a maneuver at which the logic of smooth increase of the zoom level must be enabled.
Maximum distance after a maneuver at which smooth decrease of the zoom level must end.
Style zoom.
StringRouteLongAttribute
Container that stores an extended route attribute. Each element is stored as a pair consisting of a point and an attribute element value. Attribute action starts at this point and ends at the next point, at which the next element's attribute action begins.
fun entry(point: RoutePoint): StringRouteLongEntry?
Element that the specified point falls into.
fun entries(begin: RoutePoint, end: RoutePoint): List<StringRouteLongEntry>
Elements partially or completely covered by the begin,end range.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
StringRouteLongEntry
Extended route element - segment and value on it.
StringRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: String
)
Extended route element - segment and value on it.
Style
Style with a set of map object properties (see ISource).
Gets default properties for objects that have the specified layer applied to them.
StyleBuilder
Style builder.
fun setStyleAttribute(name: String, value: AttributeValue): StyleBuilder
StyleLayerId
ID of the style layer.
StyleZoom
Style zoom level.
It is set in the style editor and differs from the usual zoom level in that for one StyleZoom the map scale is the same regardless of latitude. However, with Zoom < 9 or with latitude > 60 degrees StyleZoom == Zoom and map scale is different at different latitudes.
StyleZoom cannot be negative.
StyleZoom(value: Float = 0.0f)
Style zoom level.
It is set in the style editor and differs from the usual zoom level in that for one StyleZoom the map scale is the same regardless of latitude. However, with Zoom < 9 or with latitude > 60 degrees StyleZoom == Zoom and map scale is different at different latitudes.
StyleZoom cannot be negative.
StyleZoomFollowController
Controller for following the style zoom level of the map.
StyleZoomFollowController(animationDuration: Duration = Duration.ofMilliseconds(300))
Creates a controller for following the style zoom level of the map.
fun setStyleZoom(styleZoom: StyleZoom): Unit
Sets a new value for the style zoom level.
Suggest
Search suggestion.
Suggestion selection handler.
Suggestion type.
Suggestion title.
Suggestion subtitle.
SuggestHandler
Suggestion selection handler.
SuggestHandler(performSearchHandler: PerformSearchHandler?)
SuggestHandler(incompleteTextHandler: IncompleteTextHandler?)
fun match(
objectHandler: Function1,
performSearchHandler: Function1,
incompleteTextHandler: Function1
): T
fun toString(): String
fun hashCode(): Int
SuggestObjectHandler
Specific object from a directory is suggested.
Suggested object.
SuggestQuery
Request a search suggestion.
SuggestQueryBuilder
Builder of queries to the suggestor.
fun setSpatialRestriction(spatialRestriction: List?<GeoPoint>): SuggestQueryBuilder
Sets the search area limit in the form of a polygon. The first and the last points of the polygon do not have to match.
No limit by default
fun setAreaOfInterest(rect: GeoRect?): SuggestQueryBuilder
Sets a rectangular region of interest in geographic coordinates. A typical value is visible_rect from ICamera - the enclosing rectangle of the viewport.
fun setAllowedResultTypes(allowedResultTypes: List<SuggestedType>): SuggestQueryBuilder
Sets the object types allowed in the query result.
By default, all types except Route are allowed.
fun setSuggestorType(suggestorType: SuggestorType): SuggestQueryBuilder
Sets the type of suggester.
The default value is #SuggestorType::General.
fun setLimit(limit: Int): SuggestQueryBuilder
Sets the desired number of suggestions. Valid values are from the range 1;50.
The default value is 10.
@JvmStatic
fun fromQueryText(queryText: String): SuggestQueryBuilder
Starts building a suggestion query for the given text and the area of interest.
@JvmStatic
fun fromQuery(query: SuggestQuery): SuggestQueryBuilder
Starts building a suggestion query based on #query to change some of the parameters.
The original #query remains unchanged.
SuggestResult
Result of the suggester work.
Set of suggestions.
The set is empty if no matching suggestions are found.
SystemCertificate
System SSL certificate.
SystemCertificate()
System SSL certificate.
SystemMemoryManager
Interface of the system memory management.
fun reduceMemoryUsage(): Unit
Memory usage decrease by clearing various caches and buffers.
TaxiRouteSearchOptions
Taxi route search options.
TaxiRouteSearchOptions(car: CarRouteSearchOptions)
Taxi route search options.
Route search options common to other car routes.
TerritoriesAlongRouteProvider
Interface for finding a route based on traffic data.
fun getTerritories(route: Route): Future<List<Territory>>
Returns the minimum required list of offline territories in route order.
Territory
Territory. Data in 2GIS is divided into some indivisible units called segments. For more convenient and flexible work with data, not segments themselves are used for updating, but their sets, called territories. Sets of segments in two territories can intersect, including that one territory may be entirely nested within another.
TerritoryManager
Interface for interacting with the list of territories: Subscriptions to changes in information about territories; Search for territories by coordinates and geometries; Subscriptions to changes in information about the overall progress of installing/updating territories; Pausing and resuming the process of installing/updating territories.
Channel with a list of all known territories. Updated when information about at least one of the territories or the list composition changes. The channel's contents is a subset of the general package list obtained from IPackageManager::packages. To avoid desynchronization of package descriptions, do not use data obtained simultaneously from multiple channels containing subsets of the general package list.
Channel with a list of all known territories. Updated when information about at least one of the territories or the list composition changes. The channel's contents is a subset of the general package list obtained from IPackageManager::packages. To avoid desynchronization of package descriptions, do not use data obtained simultaneously from multiple channels containing subsets of the general package list.
TextStyle
Text appearance settings.
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
)
Text appearance settings.
Tilt
Tilt angle in degrees, where 0 is nadir (looking vertically down), 90 is horizon in front.
Values in the range of 0 to 60 degrees are allowed. In cases where the camera position point is closer to the bottom of the screen, the value may be additionally reduced.
Tilt(value: Float = 0.0f)
Tilt angle in degrees, where 0 is nadir (looking vertically down), 90 is horizon in front.
Values in the range of 0 to 60 degrees are allowed. In cases where the camera position point is closer to the bottom of the screen, the value may be additionally reduced.
TiltFollowController
Controller for following the tilt angle of the map.
TiltFollowController(styleZoomToTilt: StyleZoomToTiltRelation)
Creating a map angle tracking controller.
Dependence of the camera tilt angle on the style zoom level.
TiltSettings
Distance, in mm, that you need to slide your fingers across the screen to change the camera angle by 1 degree. A negative value will invert the direction. A value of 0 is invalid.
Maximum allowable deviation of the finger line from the horizon for a vertical swipe. In degrees.
Maximum allowable angle of deviation of the swipe direction from the vertical line. In degrees.
Weighted average point shift threshold, in millimeters, if the shift does not exceed the threshold, then the event is not sent.
TimePoint
Class representing a point in time.
TimePoint(timeFromEpoch: Duration)
Class representing a point in time.
fun toString(): String
@JvmStatic
fun ofEpochMilliseconds(milliseconds: Long): TimePoint
@JvmStatic
fun now(): TimePoint
Time elapsed since 00:00:00 UTC, January 1, 1970 (Unix time).
TradeLicense
Organization license.
Traffic
Description of the traffic data.
Duration of movement on route sections. 0 - duration of movement on a route section is unknown.
Color representation of vehicle speeds on the route (extended attribute).
TrafficAndParkingControl
Container with controls for displaying parking lots and traffic jams.
TrafficAndParkingControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Container with controls for displaying parking lots and traffic jams.
TrafficCollector
Interface for managing traffic information collection service.
This interface is thread-safe.
TrafficCollector(context: Context)
Function of creating a service for collecting information about traffic. The service for collecting information about traffic analyzes the state of traffic on the road where the user is moving and sends the results of the analysis to the server in anonymized form .
Context - the environment required for the SDK to work.
Function of determining the state of allowing / prohibiting sending information about transport traffic to the server.
TrafficControl
Traffic jam visibility control. It is a button that switches the visibility of traffic jams on the map. The control visually displays the traffic jam score, which also affects color: green - low level of traffic, yellow - medium, red - high. The appearance of the control changes depending on the state, see TrafficControlStatus for details.
TrafficControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Traffic jam visibility control. It is a button that switches the visibility of traffic jams on the map. The control visually displays the traffic jam score, which also affects color: green - low level of traffic, yellow - medium, red - high. The appearance of the control changes depending on the state, see TrafficControlStatus for details.
TrafficControl
Traffic jam visibility control. It is a button that switches the visibility of traffic jams on the map. The control visually displays the traffic jam score, which also affects color: green - low level of traffic, yellow - medium, red - high. The appearance of the control changes depending on the state, see TrafficControlStatus for details.
TrafficControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Traffic jam visibility control. It is a button that switches the visibility of traffic jams on the map. The control visually displays the traffic jam score, which also affects color: green - low level of traffic, yellow - medium, red - high. The appearance of the control changes depending on the state, see TrafficControlStatus for details.
TrafficControlModel
Model of a traffic jam visibility control.
This interface is thread-safe.
TrafficControlModel(map: Map)
Function of creating a model of a traffic jam visibility control.
Map.
fun onClicked(): Unit
Action when clicking on the control. Toggles the visibility of traffic jams on the map.
Control status.
Control status.
TrafficControlState
Traffic control status.
TrafficControlState(status: TrafficControlStatus = TrafficControlStatus.HIDDEN, score: Int?)
Traffic control status.
Status, depending on which the appearance of the control changes.
Traffic jam score. Displayed as an inscription on the control. If absent, a stub icon is displayed.
TrafficLineControl
Control that displays the level of traffic jams along the route.
TrafficLineControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Control that displays the level of traffic jams along the route.
TrafficLinePointObject
TrafficLinePointObjectView
TrafficLinePointObjectView(
context: Context,
pointObject: TrafficLinePointObject,
position: PointObjectsPosition
)
fun removeWithAnimation(): Unit
TrafficRoute
TrafficRouter
Interface for finding a route based on traffic jam data.
fun findRoute(
startPoint: RouteSearchPoint,
finishPoint: RouteSearchPoint,
routeSearchOptions: RouteSearchOptions,
intermediatePoints: List<RouteSearchPoint> = listOf()
): Future<List<TrafficRoute>>
Searches for a route with the given parameters.
Starting point of the route.
Finish point of the route.
Route search options.
Intermediate points to pass in the same order in which the points are given in the vector.
Future with a set of found routes, or throw a NativeException on failure.
An empty route set is a valid result, meaning that a route matching the specified search criteria cannot be found.
When searching for routes for freight transport, it is possible to return routes passing through the access zones for which passes were not provided, if it was not possible to route only through the access zones for which the passes were provided. To check if the list of passes is sufficient to pass a route, use the route_matches_truck_pass_zone_passes function.
fun findBriefRouteInfos(searchPoints: List<BriefRouteInfoSearchPoints>, routeSearchOptions: RouteSearchOptions): Future<List<BriefRouteInfo?>>
Searches for basic route information for a matching set of search points.
Set of points for finding basic information about the route.
Route search options.
Future with basic information about the set of routes corresponding to the set of search points, or throwing a NativeException on failure.
If the basic information for any of the pairs of points is not found, the element at the corresponding index in the returned result is null.
Returns a list of all supported passes that allow truck traffic within the pass zones.
TrafficScore
Traffic score.
TrafficScore(state: TrafficScoreState = TrafficScoreState.PENDING, value: Int?)
Traffic score.
Value relevance.
Value of the traffic score. Typically, values range from 1 to 10. An empty value if the information has not yet been received, is out of date, or is not available for the given location.
TrafficScoreProvider
Subscribtion to updates of the traffic jam score.
This interface is thread-safe.
Current status and value of traffic jam score.
Current status and value of traffic jam score.
TrafficSource
Interface of the class that controls the display of traffic jams on the map.
TrafficSpeedColorRouteLongAttribute
Container that stores an extended route attribute. Each element is stored as a pair consisting of a point and an attribute element value. Attribute action starts at this point and ends at the next point, at which the next element's attribute action begins.
fun entry(point: RoutePoint): TrafficSpeedColorRouteLongEntry?
Element that the specified point falls into.
fun entries(begin: RoutePoint, end: RoutePoint): List<TrafficSpeedColorRouteLongEntry>
Elements partially or completely covered by the begin,end range.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
TrafficSpeedColorRouteLongEntry
Extended route element - segment and value on it.
TrafficSpeedColorRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: TrafficSpeedColor
)
Extended route element - segment and value on it.
TransportTypeRouteLongAttribute
Container that stores an extended route attribute. Each element is stored as a pair consisting of a point and an attribute element value. Attribute action starts at this point and ends at the next point, at which the next element's attribute action begins.
fun entry(point: RoutePoint): TransportTypeRouteLongEntry?
Element that the specified point falls into.
fun entries(begin: RoutePoint, end: RoutePoint): List<TransportTypeRouteLongEntry>
Elements partially or completely covered by the begin,end range.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
TransportTypeRouteLongEntry
Extended route element - segment and value on it.
TransportTypeRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: TransportType
)
Extended route element - segment and value on it.
TruckPassZoneId
Identifier of the pass zone for trucks. Value 0 means no pass zone.
TruckPassZoneId(value: Int = 0)
Identifier of the pass zone for trucks. Value 0 means no pass zone.
TruckPassZoneIdRouteLongAttribute
Container that stores an extended route attribute. Each element is stored as a pair consisting of a point and an attribute element value. Attribute action starts at this point and ends at the next point, at which the next element's attribute action begins.
fun entry(point: RoutePoint): TruckPassZoneIdRouteLongEntry?
Element that the specified point falls into.
fun entries(begin: RoutePoint, end: RoutePoint): List<TruckPassZoneIdRouteLongEntry>
Elements partially or completely covered by the begin,end range.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
TruckPassZoneIdRouteLongEntry
Extended route element - segment and value on it.
TruckPassZoneIdRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: TruckPassZoneId
)
Extended route element - segment and value on it.
TruckPassZonePass
Pass allowing the movement of trucks in pass zones.
TruckPassZonePass(
id: TruckPassZonePassId,
name: String,
passZoneIds: Set<TruckPassZoneId>
)
Pass allowing the movement of trucks in pass zones.
Pass ID.
Pass name.
Identifiers of the pass zones on which this pass allows movement.
TruckPassZonePassId
Identifier of the pass that allows the movement of trucks in pass zones.
TruckPassZonePassId(value: Int = 0)
Identifier of the pass that allows the movement of trucks in pass zones.
TruckRouteSearchOptions
Parameters for finding a truck route . When searching for a route, only filled-in parameters are taken into account.
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
)
Parameters for finding a truck route . When searching for a route, only filled-in parameters are taken into account.
Route search options common to other car routes.
Length of the truck in millimeters.
Height of the truck in millimeters.
Width of the truck in millimeters.
Actual weight of the truck in kilograms.
Maximum authorized mass of a truck in kilograms.
Axle load in kilograms.
Sign of the presence of dangerous cargo.
Sign of the presence of explosive cargo.
Identifiers of the user passes required for moving within the pass zones.
Use automatic fallback from truck route search to car route search, if you cannot find a truck route that matches the search parameters.
UIMarkerInfo
Object ID with a caption.
UIMarkerInfo(objectId: DgisObjectId, label: String?)
Object ID with a caption.
UIntRouteLongAttribute
Container that stores an extended route attribute. Each element is stored as a pair consisting of a point and an attribute element value. Attribute action starts at this point and ends at the next point, at which the next element's attribute action begins.
fun entry(point: RoutePoint): UIntRouteLongEntry?
Element that the specified point falls into.
fun entries(begin: RoutePoint, end: RoutePoint): List<UIntRouteLongEntry>
Elements partially or completely covered by the begin,end range.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
UIntRouteLongEntry
Extended route element - segment and value on it.
UIntRouteLongEntry(
point: RoutePoint,
length: RouteDistance,
value: Int
)
Extended route element - segment and value on it.
VendorConfig
Overrides SDK configuration.
VendorConfig()
fun match(
none: Function0<T>,
fromAsset: Function1,
fromFile: Function1,
fromString: Function1
): T
fun toString(): String
fun hashCode(): Int
VendorConfigFromAsset
Overrides SDK settings by specifying the path to an Android app asset.
VendorConfigFromAsset(path: String)
Overrides SDK settings by specifying the path to an Android app asset.
Path relative to the asset root directory.
VendorConfigFromFile
Overrides SDK settings by specifying a path to a file in the device file system.
VendorConfigFromFile(path: String)
Overrides SDK settings by specifying a path to a file in the device file system.
Path to the file.
VendorConfigFromString
Overrides SDK settings by specifying the file contents.
VendorConfigFromString(contents: String)
Overrides SDK settings by specifying the file contents.
Contents of the settings override file.
Voice
Voice package for the navigator.
fun playWelcome(): Future<Unit>
Plays the voice sample.
future, that becomes ready, when sample playing is finished.
Gets a voice to use in the navigator.
Voice language in ISO 639-1 format.
VoiceManager
Interface for interacting with the list of navigator voice packages.
Channel with a list of all known voice packages. Updated if information about at least one of the voices or the list composition changes. The content of the channel is a subset of the total list of packages. To avoid desynchronization of package descriptions, you should not use data that are obtained simultaneously from multiple channels containing subsets of a common package list.
Channel with a list of all known voice packages. Updated if information about at least one of the voices or the list composition changes. The content of the channel is a subset of the total list of packages. To avoid desynchronization of package descriptions, you should not use data that are obtained simultaneously from multiple channels containing subsets of a common package list.
VoiceSelector
Manages voice packages in the current navigator session.
Voice package that plays voice notifications in the current navigator session.
VoidRouteAttribute
Container that describes a point attribute of a route. Each element is stored as the point on the route (where the element is located) and the value of the element itself.
fun entries(begin: RoutePoint, end: RoutePoint): List<RoutePoint>
Elements falling within the [begin, end) range.
fun findNearBackward(point: RoutePoint): RoutePoint?
Finds the nearest element the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
fun findNearForward(point: RoutePoint): RoutePoint?
Finds the nearest element the position of which is < = point.
The complexity of the operation is log2(N), where N = size.
Amount of elements.
Elements are missing.
First element.
Last element.
All elements.
WeekTime
Time point within a week.
WeekTimeInterval
Time interval within a week.
Widget
Base class representing a widget for filtering search results.
Widgets are returned as a result of a search and are designed to filter or sort the result by certain parameters. Widgets are generated dynamically for each search result and may not be available for some requests. The widget represents one specific filter or a group of them, united by a common feature. For example, the type of cuisine in search results for the "Eat" query.
Gets the widget type.
Gets the name of the widget. May be missing.
Gets a list of filters that describe the current state of the widget. Can be used when forming a search query.
WorkStatus
Work status.
WorkTimeFilter
Filter by the object's opening hours. Either open now or open for a specific date and time.
fun match(workTime: Function1, isOpenNow: Function1): T
fun toString(): String
fun hashCode(): Int
ZIndex
Index specifying the rendering order of objects within a layer.
ZIndex(value: Int = 0)
Index specifying the rendering order of objects within a layer.
Zoom
Zoom level.
Zoom = 0 is the scale at which the entire world is inscribed in a square of 256x256 logical pixels (see LogicalPixel). Zoom = 1 is the scale at which the entire world is inscribed in a square of 512x512 logical pixels. The scale is proportional value of 2^Zoom.
Zoom cannot be negative.
Zoom(value: Float = 0.0f)
Zoom level.
Zoom = 0 is the scale at which the entire world is inscribed in a square of 256x256 logical pixels (see LogicalPixel). Zoom = 1 is the scale at which the entire world is inscribed in a square of 512x512 logical pixels. The scale is proportional value of 2^Zoom.
Zoom cannot be negative.
ZoomControl
Container with controls to increase and decrease the zoom level.
ZoomControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Container with controls to increase and decrease the zoom level.
ZoomControl
Container with controls to increase and decrease the zoom level.
ZoomControl(
context: Context,
attrs: AttributeSet? = null,
defStyle: Int = 0
)
Container with controls to increase and decrease the zoom level.
ZoomControlModel
Zoom control model. The control consists of +/- buttons, which, when pressed, change the map scale. When the allowable scale limit is reached, the zoom button in this direction becomes inactive. Object methods must be called on one thread.
fun isEnabled(button: ZoomControlButton): StatefulChannel<Boolean>
fun setPressed(button: ZoomControlButton, value: Boolean): Unit
ZoomFollowSettings
Interface that allows you to manage map scaling settings during navigation.
During navigation, the scale depends on the speed of movement, the presence of maneuvers ahead and behind on the route, and the type of road.
If there are no maneuvers ahead and behind, or on roads with low value (minor streets in settlements, highways, intercity or federal highways), the scale value is selected based on the values SpeedRangeToStyleZoom, which are stored in the speed_range_to_style_zoom_sequence. The sequence speed_range_to_style_zoom_sequence must contain speed intervals sorted in ascending order of min_speed values, and the conditions below must be met: max_speedi > min_speedi+1
max_speedi < max_speedi+1. That is, speed intervals should touch or even intersect, but the speed value should not fall into more than two intervals. However, the minimum speed value is not considered to fall within the interval, i.e. the same speed value may be the maximum speed for one interval, the minimum speed for another, and be inside the interval for a third interval. An exception is the first speed interval, which must contain min_speed == 0.
The map scale is selected from the speed_range_to_style_zoom_sequence using the algorithm:
When approaching a maneuver at the current speed, the scale will increase smoothly. The duration of the increase depends on the speed and distance to the maneuver. When the speed is increased, the animation time increases, and when the speed is decreased, it decreases. The increase in zoom level is completed at some distance from the maneuver.
After passing the maneuver, the zoom level smoothly decreases.
Sequence of speed intervals and their corresponding scales. Used for automatic map scaling in the navigator based on speed.
Sequence of speed intervals and corresponding scales when driving in FreeRoam mode. Used to automatically change the scale in the navigator depending on speed.
Duration of smooth zoom in the navigation mode as speed changes when there are no maneuvers ahead/behind at a sufficiently close distance, or on roads with low value.
Duration of smooth zoom increase when approaching a maneuver. Used only if the speed is lower than get_min_speed_to_consider_in_zoom_in_before_maneuver_animation.
Duration of smooth decrease of the zoom level after completing the maneuver.
Minimum movement speed in m/s at which the duration of the smooth zoom level change is calculated taking into account not only the proximity to the maneuver, but also the current speed. Must be at least 0.1 m/s, values less than are ignored.
Acceleration factor for the zoom increase animation when approaching a maneuver. Must be at least 1, values less than this are ignored.
Distance to the maneuver at which the zoom-in animation must be completed so that the zoom does not change during the maneuver. For example, if there is 300 m before the maneuver, then the zoom-in animation must be completed 50 m before start of the maneuver. Must be at least 1 m, values less than are ignored.
Minimum animation time. Used to prevent abrupt changes in the zoom level during animation. Must be at least 200, values below are ignored.