MTMath

object MTMath

Pure math helpers for geographic calculations, projections, and tile indices.

Properties

const val EARTH_CIRCUMFERENCE: Double

Circumference of the Earth in meters.

const val EARTH_RADIUS: Double = 6378137.0

Radius of the Earth in meters.

const val MAX_SAFE_LATITUDE: Double = 85.05112877980659

Maximum latitude used for Web Mercator calculations to prevent infinity.

Functions

fun circumferenceAtLatitude(latitude: Double): Double

Calculates the Earth's circumference at a given latitude in meters.

fun haversineCumulatedDistanceWgs84(route: List<LngLat>): Double

Calculates the total cumulated distance of a route made of multiple WGS84 coordinates.

fun haversineDistanceWgs84(from: LngLat, to: LngLat): Double

Calculates the great-circle distance between two WGS84 coordinates using the Haversine formula.

fun haversineIntermediateWgs84(from: LngLat, to: LngLat, ratio: Double): LngLat

Computes an intermediate point between two WGS84 coordinates using the Haversine formula.

fun latitudeToMercatorY(latitude: Double): Double

Converts a latitude to Web Mercator Y coordinate in meters.

fun latitudeToTileY(latitude: Double, zoom: Double, round: Boolean = true): Double

Calculates the Web Mercator tile Y coordinate (XYZ scheme) for a given latitude and zoom level.

fun longitudeToMercatorX(longitude: Double): Double

Converts a longitude to Web Mercator X coordinate in meters.

fun longitudeToTileX(longitude: Double, zoom: Double, round: Boolean = true): Double

Calculates the Web Mercator tile X coordinate for a given longitude and zoom level.

fun mercatorToWgs84(x: Double, y: Double): LngLat

Converts a Web Mercator (X, Y) in meters to WGS84 coordinate.

fun mercatorXToLongitude(x: Double): Double

Converts a Web Mercator X coordinate in meters to longitude.

fun mercatorYToLatitude(y: Double): Double

Converts a Web Mercator Y coordinate in meters to latitude.

fun toDegrees(radians: Double): Double

Converts radians to degrees.

fun toRadians(degrees: Double): Double

Converts degrees to radians.

fun wgs84ToMercator(coordinate: LngLat): Pair<Double, Double>

Converts a WGS84 coordinate to Web Mercator (X, Y) in meters.

fun wgs84ToTileIndex(coordinate: LngLat, zoom: Double, round: Boolean = true): Pair<Double, Double>

Converts a WGS84 coordinate to Web Mercator tile indices.

fun wrapLongitude(longitude: Double): Double

Wraps a longitude value to be within the [-180, 180] range.