method
AttributeValue(value)
calcPosition(camera,geometry,screenArea,tilt,bearing,size)
fun calcPosition(
camera: BaseCamera,
geometry: Geometry,
screenArea: Padding? = null,
tilt: Tilt? = null,
bearing: Bearing? = null,
size: ScreenSize? = null
): CameraPosition
Вычисление позиции камеры такой, что геометрический объект, расположенный на карте, полностью вписан в область экрана, заданную параметром screen_area.
Если не нужно изменять настройки оригинальной камеры, то можно настраивать скопированную через IBaseCamera::clone() камеру.
камера, используемая для вычисления позиции.
геометрический объект, который необходимо вписать в область экрана, заданную параметром screen_area.
область экрана, в которую нужно вписать геометрию. Если не задана, то для расчёта используется padding камеры.
наклон карты. Если не задан, то используется текущий наклон камеры.
поворот карты. Если не задан, то используется текущий поворот камеры.
Размер области просмотра. В случае, если не указано, используется значение ICamera::size().
calcPosition(camera,objects,screenArea,tilt,bearing,size)
fun calcPosition(
camera: BaseCamera,
objects: List<SimpleMapObject>,
screenArea: Padding? = null,
tilt: Tilt? = null,
bearing: Bearing? = null,
size: ScreenSize? = null
): CameraPosition
Вычисление позиции камеры такой, что объекты карты полностью вписаны в область экрана, заданную параметром screen_area.
камера, используемая для вычисления позиции.
объекты карты, которые необходимо вписать в область экрана, заданную параметром screen_area.
область экрана, в которую нужно вписать геометрию. Если не задана, то для расчёта используется padding камеры.
наклон карты. Если не задан, то используется текущий наклон камеры.
поворот карты. Если не задан, то используется текущий поворот камеры.
Размер области просмотра. В случае, если не указано, используется значение ICamera::size().
Color(red,green,blue,alpha)
fun Color(
red: Int,
green: Int,
blue: Int,
alpha: Int = 255
): Color
createRasterTileDataSource(context,sublayerName,urlTemplate)
fun createRasterTileDataSource(
context: Context,
sublayerName: String,
urlTemplate: String
): Source
Создание источника, получающего растровые тайлы.
контекст.
имя, которое будет использовано при генерации объектов. Это имя должно быть указано в стилях в условии filter слоя типа raster для атрибута db_sublayer. Пример: ["match", get,db_sublayer, NAME, true, false] Подробнее см. спецификацию: https://docs.2gis.com/ru/mapgl/stylespecification
Шаблон url для запроса тайлов, должен содержать подстроки {x}, {y} и {z}, которые при подстановке вместо них числовых значений формируют валидный URL, на который будет отправлен запрос за данными тайла.
createRawMyLocationController()
fun createRawMyLocationController(): MyLocationController
Использует данные платформы. Координаты и ориентация маркера геопозиции изменяются моментально при получении данных.
createSmoothMyLocationController()
fun createSmoothMyLocationController(): MyLocationController
Использует данные карты. Координаты и ориентация маркера геопозиции изменяются плавно. При использовании режима слежения, изменения маркера синхронизованы с изменениями позиции камеры.
createStyleZoomToTiltRelation(points)
fun createStyleZoomToTiltRelation(points: Map): StyleZoomToTiltRelation
Создаем зависимость угла наклона камеры от стилевого zoom-уровня.
точки, по которым строится зависимость.
зависимость угла наклона камеры от стилевого zoom-уровня, если создать зависимость не удалось - бросаем исключение.
Зависимость должна представлять собой монотонную непрерывную функцию. Если точками задана зависимость, не удовлетворяющая условиям, то функция бросает исключение. Зависимость, примерно как в 2гис, можно задать последовательностью точек 17,0,19,15,20,25 в режиме карты и 15,0,16,34,17,48 в режиме навигатора. Пусть нужно получить значение угла наклона камеры T для стилевого zoom-уровня Z, такого что Z0 < = Z < Z1 и зависимость задана точками Z0,T0,Z1,T1. Тогда искомое значение рассчитывается по формуле T = T0 + k * (T1 - T0), где k = (Z - Z0) / (Z1 - Z0). Если Z < Z0, то T = T0. Если Z >= Z1, то T = T1.
GeoPoint(latitude,longitude)
fun GeoPoint(latitude: Double, longitude: Double): GeoPoint
GeoPointWithElevation(latitude,longitude,elevation)
fun GeoPointWithElevation(
latitude: Double,
longitude: Double,
elevation: Elevation = Elevation(0.0f)
): GeoPointWithElevation
GeoPointWithElevation(point,elevation)
fun GeoPointWithElevation(point: GeoPoint, elevation: Elevation = Elevation(0.0f)): GeoPointWithElevation
getHttpCacheManager(context)
fun getHttpCacheManager(context: Context): HttpCacheManager?
Интерфейс управления HTTP кэшом. Null, если HTTP кэш не используется.
getInstructionManeuver(extraInstructionInfo)
fun getInstructionManeuver(extraInstructionInfo: ExtraInstructionInfo): InstructionManeuver
Получить манёвр, который необходимо совершить для движения по маршруту.
getLanesControlImages(laneSign,maxCount,ignoreActiveManeuver)
fun getLanesControlImages(
laneSign: RouteLaneSign,
maxCount: Int,
ignoreActiveManeuver: Boolean
): List<LanesControlImage>
Получить список изображений для отображения в контроле полосности. Количество изображений (без учета разделителей и многоточий) ограничено maxCount, если оно превышено, изображения с одной или обеих сторон обрезаются таким образом, чтобы осталось как можно больше изображений активных маневров. На стороне, где произошло удаление, отображается многоточие. В случае, если параметр ignoreActiveManeuver равен true, активный манёвр будет проигнорирован, и будет возвращено изображение, соответствующее всем разрешенным направлениям движения.
getLocaleManager(context)
fun getLocaleManager(context: Context): LocaleManager
Интерфейс управления локалями приложения
getPackageManager(context)
fun getPackageManager(context: Context): PackageManager
Получение объекта для работы с пакетами из контекста.
getRoadMacroGraph(context)
fun getRoadMacroGraph(context: Context): RoadMacroGraph
Получение объекта для управления глобальным дорожным графом из контекста.
getSystemMemoryManager(context)
fun getSystemMemoryManager(context: Context): SystemMemoryManager
Получение объекта для управления использованием системной памяти.
getTerritoriesAlongRouteProvider(context)
fun getTerritoriesAlongRouteProvider(context: Context): TerritoriesAlongRouteProvider
Получение объекта для получения списка территорий вдоль маршрута из контекста.
getTerritoryManager(context)
fun getTerritoryManager(context: Context): TerritoryManager
Получение объекта для работы с территориями из контекста.
getVoiceManager(context)
fun getVoiceManager(context: Context): VoiceManager
Получение объекта для управления голосами из контекста.
imageFromAsset(context,assetName,size)
fun imageFromAsset(
context: Context,
assetName: String,
size: Size? = null
): Image
context - Android контекст assetName - файл изображения size - целевой размер изображения (для SVG и Lottie игнорируется)
imageFromBitmap(context,bitmap)
fun imageFromBitmap(context: Context, bitmap: Bitmap): Image
imageFromBitmap(context,loader)
fun imageFromBitmap(context: Context, loader: Function0<Bitmap>): Image
imageFromCanvas(context,size,block)
fun imageFromCanvas(
context: Context,
size: Size,
block: Function1
): Image
imageFromLottieJSON(context,data)
fun imageFromLottieJSON(context: Context, data: ByteArray): Image
imageFromLottieJSON(context,loader)
fun imageFromLottieJSON(context: Context, loader: Function0<ByteArray>): Image
imageFromResource(context,resourceId,size)
fun imageFromResource(
context: Context,
resourceId: Int,
size: Size? = null
): Image
context - Android контекст resourceId - Android ресурс size - целевой размер изображения (для SVG и Lottie игнорируется)
imageFromSvg(context,data)
fun imageFromSvg(context: Context, data: ByteArray): Image
imageFromSvg(context,loader)
fun imageFromSvg(context: Context, loader: Function0<ByteArray>): Image
isBetterLocation(location,currentBestLocation)
fun isBetterLocation(location: Location, currentBestLocation: Location?): Boolean
kilometersPerHourToMetersPerSecond(kilometersPerHour)
fun kilometersPerHourToMetersPerSecond(kilometersPerHour: Double): Double
Преобразование скорости в километрах в час в скорость в метрах в секунду.
max(a,b)
metersPerSecondToKilometersPerHour(metersPerSecond)
fun metersPerSecondToKilometersPerHour(metersPerSecond: Double): Double
Преобразование скорости в метрах в секунду в скорость в километрах в час.
metersToUiString(meters,context)
fun metersToUiString(meters: Int, context: Context): String
Преобразование размера в метрах в строку для показа в UI контролах навигатора.
min(a,b)
MutableChannel()
fun MutableChannel(): MutableChannel<T>
MutableStatefulChannel(initialValue)
fun MutableStatefulChannel(initialValue: T): MutableStatefulChannel<T>
parseGeoJson(geoJsonData)
fun parseGeoJson(geoJsonData: String): List<GeometryMapObject>
parseGeoJsonFile(fsPath)
fun parseGeoJsonFile(fsPath: String): List<GeometryMapObject>
projectionZToStyleZ(projectionZ,latitude)
fun projectionZToStyleZ(projectionZ: Zoom, latitude: Latitude): StyleZoom
registerPlatformLocationSource(context,source)
fun registerPlatformLocationSource(context: Context, source: LocationSource?): Unit
Регистрация источника геопозиции. В качестве источника по-умолчанию можно использовать DefaultLocationSource.
registerPlatformMagneticSource(context,source)
fun registerPlatformMagneticSource(context: Context, source: MagneticHeadingSource?): Unit
remainingRouteGeometry(fullRouteGeometry,currentRoutePoint)
fun remainingRouteGeometry(fullRouteGeometry: GeoPointRouteAttribute, currentRoutePoint: RoutePoint): GeoPointRouteAttribute
Вычисляет геометрию оставшейся части маршрута, т.е. геометрию, начинающуюся с точки, соответствующей текущей точке маршрута, и до конца маршрута. Если маршрут полностью пройден или текущая точка находится за пределами маршрута, возвращается пустая геометрия.
Полная геометрия всего маршрута
Текущая позиция на маршруте
Геометрия оставшейся части маршрута
Сложность операции O(N), где N = full_route_geometry.size()
routeMatchesTruckPassZonePasses(truckPassZoneIds,passZonePasses)
fun routeMatchesTruckPassZonePasses(truckPassZoneIds: TruckPassZoneIdRouteLongAttribute, passZonePasses: List<TruckPassZonePass>): Boolean
Проверяет, достаточен ли предоставленный список пропусков для проезда пропускных зон грузового транспорта, через которые проходит маршрут.
Если маршрут не проходит через какие-либо пропускные зоны для грузового транспорта, функция возвращает true
Атрибут маршрута с идентификаторами пропускных зон для грузового транспорта
Пропуска для проезда пропускных зон грузового транспорта
Признак достаточности пропусков для проезда по маршруту
styleZToProjectionZ(styleZ,latitude)
fun styleZToProjectionZ(styleZ: StyleZoom, latitude: Latitude): Zoom
toMapGeometry(geometry)
fun toMapGeometry(geometry: GeoPointRouteAttribute): Geometry
преобразовать геометрию маршрута в IGeometryPtr
zoomOutToFit(camera,geometry,size)
fun zoomOutToFit(
camera: BaseCamera,
geometry: Geometry,
size: ScreenSize? = null
): CameraPosition
Вычисление позиции камеры, такой, что при неизменной точке установки камеры геометрический объект, расположенный на карте, умещается в область экрана, заданную padding'ом камеры.
Если не нужно изменять настройки оригинальной камеры, то можно настраивать скопированную через IBaseCamera::clone() камеру.
камера, используемая для вычисления позиции.
геометрический объект, который необходимо вписать в область экрана, заданную padding'ом камеры.
Размер области просмотра. В случае, если не указано, используется значение ICamera::size().
zoomOutToFit(camera,objects,size)
fun zoomOutToFit(
camera: BaseCamera,
objects: List<SimpleMapObject>,
size: ScreenSize? = null
): CameraPosition
Вычисление позиции камеры, такой, что при неизменной точке установки камеры геометрический объект, расположенный на карте, умещается в область экрана, заданную padding'ом камеры.
камера, используемая для вычисления позиции.
объекты карты, которые необходимо вписать в область экрана, заданную padding'ом камеры.
Размер области просмотра. В случае, если не указано, используется значение ICamera::size().