Геолокация и карты в Kotlin: библиотеки, инструменты и примеры

Введение в геолокацию и карты в Kotlin

Kotlin — современный язык программирования, широко используемый для разработки Android-приложений. Работа с геолокацией и картами — одна из ключевых возможностей мобильных приложений. В этой статье мы рассмотрим основные библиотеки и инструменты для интеграции карт, получения координат пользователя и построения маршрутов в Kotlin.

1. Google Maps SDK для Android

Google Maps — самый популярный сервис для отображения карт. Для его использования в Kotlin необходимо подключить зависимость в build.gradle:

dependencies {
    implementation 'com.google.android.gms:play-services-maps:18.2.0'
    implementation 'com.google.android.gms:play-services-location:21.0.1'
}

После добавления ключа API в манифест, можно отобразить карту во фрагменте:

import com.google.android.gms.maps.*
import com.google.android.gms.maps.model.*

class MapsFragment : SupportMapFragment(), OnMapReadyCallback {
    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        getMapAsync(this)
    }

    override fun onMapReady(googleMap: GoogleMap) {
        val sydney = LatLng(-33.852, 151.211)
        googleMap.addMarker(MarkerOptions().position(sydney).title("Сидней"))
        googleMap.moveCamera(CameraUpdateFactory.newLatLngZoom(sydney, 15f))
    }
}

2. Получение текущего местоположения

Для работы с геолокацией используется Fused Location Provider. Пример получения последнего известного местоположения:

import com.google.android.gms.location.*

class LocationHelper(private val context: Context) {
    private val fusedLocationClient = LocationServices.getFusedLocationProviderClient(context)

    fun getLastLocation() {
        fusedLocationClient.lastLocation.addOnSuccessListener { location: Location? ->
            location?.let {
                val lat = it.latitude
                val lng = it.longitude
                Log.d("Location", "Широта: $lat, Долгота: $lng")
            }
        }
    }
}

Для постоянного отслеживания используйте LocationRequest и LocationCallback:

val locationRequest = LocationRequest.Builder(
    Priority.PRIORITY_HIGH_ACCURACY, 10000L
).build()

val locationCallback = object : LocationCallback() {
    override fun onLocationResult(locationResult: LocationResult) {
        for (location in locationResult.locations) {
            // Обработка новых координат
        }
    }
}

fusedLocationClient.requestLocationUpdates(locationRequest, locationCallback, Looper.getMainLooper())

3. OpenStreetMap и библиотека osmdroid

Если вам нужна бесплатная альтернатива Google Maps, используйте osmdroid. Подключение:

dependencies {
    implementation 'org.osmdroid:osmdroid-android:6.1.18'
}

Пример отображения карты и маркера:

import org.osmdroid.config.Configuration
import org.osmdroid.tileprovider.tilesource.TileSourceFactory
import org.osmdroid.views.MapView
import org.osmdroid.util.GeoPoint
import org.osmdroid.views.overlay.Marker

class OsmMapActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        Configuration.getInstance().userAgentValue = packageName
        setContentView(R.layout.activity_osm)

        val mapView = findViewById(R.id.map)
        mapView.setTileSource(TileSourceFactory.MAPNIK)
        mapView.controller.setZoom(15.0)
        val startPoint = GeoPoint(55.7558, 37.6173) // Москва
        mapView.controller.setCenter(startPoint)

        val marker = Marker(mapView)
        marker.position = startPoint
        marker.title = "Москва"
        marker.snippet = "Красная площадь"
        mapView.overlays.add(marker)
    }
}

4. Геокодирование и обратное геокодирование

Для преобразования адреса в координаты и наоборот используйте Geocoder:

fun geocodeAddress(context: Context, address: String) {
    val geocoder = Geocoder(context, Locale.getDefault())
    val addresses = geocoder.getFromLocationName(address, 1)
    if (!addresses.isNullOrEmpty()) {
        val lat = addresses[0].latitude
        val lng = addresses[0].longitude
        Log.d("Geocode", "$address: $lat, $lng")
    }
}

fun reverseGeocode(context: Context, lat: Double, lng: Double) {
    val geocoder = Geocoder(context, Locale.getDefault())
    val addresses = geocoder.getFromLocation(lat, lng, 1)
    if (!addresses.isNullOrEmpty()) {
        val fullAddress = addresses[0].getAddressLine(0)
        Log.d("ReverseGeocode", "Адрес: $fullAddress")
    }
}

5. Построение маршрутов с помощью Google Directions API

Для прокладки маршрута между двумя точками используйте HTTP-запрос к Directions API. Пример с использованием Retrofit:

interface DirectionsApi {
    @GET("maps/api/directions/json")
    suspend fun