utils/dev.kindling.utils.method.format.network/GeoCoordinate

GeoCoordinate

data class GeoCoordinate(val latitude: Double, val longitude: Double)(source)

Represents a geographic coordinate pair.

Constructors

GeoCoordinate

constructor(latitude: Double, longitude: Double)

Properties

latitude

val latitude: Double

longitude

val longitude: Double

Functions

distanceLabelTo

fun GeoCoordinate.distanceLabelTo(other: GeoCoordinate, inMiles: Boolean = false): String

Formats the distance between two coordinates as a human-readable string. Example: paris.distanceLabelTo(london) → "341 km"

distanceTo

fun GeoCoordinate.distanceTo(other: GeoCoordinate): Double

Computes the Haversine great-circle distance in kilometers between two coordinates. Example: GeoCoordinate(48.8566, 2.3522).distanceTo(GeoCoordinate(51.5074, -0.1278)) → ~341.0 km

isWithinKm

fun GeoCoordinate.isWithinKm(other: GeoCoordinate, radiusKm: Double): Boolean

Returns true if this coordinate is within radiusKm of other.

toDecimalDegrees

fun GeoCoordinate.toDecimalDegrees(decimals: Int = 4): String

Formats a GeoCoordinate as a decimal degrees string. Example: GeoCoordinate(48.8566, 2.3522).toDecimalDegrees() → "48.8566°N, 2.3522°E"

toDms

fun GeoCoordinate.toDms(): String

Formats a GeoCoordinate as a DMS string. Example: GeoCoordinate(48.8566, 2.3522).toDms() → "48° 51' 24\" N, 2° 21' 8\" E"

toGoogleMapsUrl

fun GeoCoordinate.toGoogleMapsUrl(): String

Returns a Google Maps URL for this coordinate. Example: GeoCoordinate(48.8566, 2.3522).toGoogleMapsUrl() → "https://maps.google.com/?q=48.8566,2.3522"