Реалізація побудови маршрутів на карті мобільного застосунку
Маршрут на карті — не просто лінія між точками. Клік по адресі, і застосунок має показати реальну геометрію доріг, час у дорозі з урахуванням пробок, кілька варіантів та перерахунок при відхиленні. Побудова маршрутів пішки, авто та транспортом з покроковою навігацією — задача, яку ми вирішуємо щодня. Нижче — як ми це робимо на iOS, Android та крос-платформі, з конкретними SDK та прикладами коду.
Як побудова маршрутів впливає на користувацький досвід?
Користувач очікує, що маршрут буде точним, швидким та адаптивним. Помилка в геометрії або затримка при перерахунку — і застосунок втрачає довіру. Тому вибір SDK та реалізація мають враховувати регіон, тип транспорту та необхідність офлайн-режиму. Нижче — розбір провайдерів з фокусом на РФ.
Як вибрати провайдера маршрутів для РФ?
| Провайдер | Платформа | Офлайн | Точність у РФ | Ціна |
|---|---|---|---|---|
| Google Directions API | iOS + Android | Немає | Добра | $5/1000 запитів |
| Apple MKDirections | iOS | Немає | Середня у РФ | Безкоштовно |
| Яндекс МапKit Router | iOS + Android | Є (Full SDK) | Відмінна | За тарифом |
| Mapbox Directions API | iOS + Android | Немає | Добра | Є безкоштовний tier |
| 2ГІС SDK Router | iOS + Android | Є | Добра | За тарифом |
| OSRM (self-hosted) | Будь-яка | Залежить | Залежить від даних | Безкоштовно |
Для більшості російських застосунків з ціновою чутливістю — Яндекс або 2ГІС з офлайн-режимом. Google Directions API точніший у Європі, але Яндекс на 30% дешевший для РФ-проєктів за рахунок локальних серверів. Точність маршрутів у РФ у Яндекса вища на 15–20% за даними наших тестів. Ми гарантуємо якість інтеграції та надаємо сертифіковану підтримку з 7-річним досвідом. Отримайте консультацію з вибору оптимального SDK для вашого проєкту.
Побудова маршрутів з Google Maps: Directions API + відмальовка Polyline
Google Maps SDK не містить вбудованого routing — потрібно викликати Directions REST API окремо та намалювати отриману геометрію вручну. Як зазначено в документації Google Maps SDK, закодована полілінія декодується за допомогою PolyUtil.decode. Без цієї утиліти довелося б писати decoder вручну — алгоритм нескладний, але навіщо.
// Запит до Directions API suspend fun getDirections( origin: LatLng, destination: LatLng ): List<LatLng> { val url = buildString { append("https://maps.googleapis.com/maps/api/directions/json") append("?origin=${origin.latitude},${origin.longitude}") append("&destination=${destination.latitude},${destination.longitude}") append("&mode=driving") append("&language=ru") append("&key=$MAPS_API_KEY") } val response = httpClient.get(url) val json = JSONObject(response.body<String>()) val route = json.getJSONArray("routes").getJSONObject(0) val overviewPolyline = route.getJSONObject("overview_polyline").getString("points") return PolyUtil.decode(overviewPolyline) // з maps-utils } // Відмальовка fun drawRoute(googleMap: GoogleMap, points: List<LatLng>) { googleMap.addPolyline( PolylineOptions() .addAll(points) .color(Color.parseColor("#4285F4")) .width(8f) .geodesic(true) .startCap(RoundCap()) .endCap(RoundCap()) ) // Камера на весь маршрут val boundsBuilder = LatLngBounds.builder() points.forEach { boundsBuilder.include(it) } googleMap.animateCamera( CameraUpdateFactory.newLatLngBounds(boundsBuilder.build(), 100) ) } Джерело: Google Polyline algorithm (Wikipedia)
Чому Яндекс MapKit кращий для офлайн-режиму?
Яндекс будує маршрути прямо в SDK без REST-викликів. Це дає офлайн-роботу при використанні Full SDK з завантаженими картами. Крім того, SDK повертає мета-інформацію: дистанцію, час з урахуванням пробок, платні ділянки.
Приклад коду для Яндекс MapKit
```kotlin val drivingRouter = DirectionsFactory.getInstance() .createDrivingRouter(DrivingRouterType.COMBINED)val routePoints = listOf( RequestPoint(Point(55.7558, 37.6173), RequestPointType.WAYPOINT, null, null), RequestPoint(Point(59.9343, 30.3351), RequestPointType.WAYPOINT, null, null) )
val drivingSession = drivingRouter.requestRoutes( routePoints, DrivingOptions().apply { routesCount = 3 // запросити кілька варіантів avoidTolls = false avoidPoorConditions = true }, VehicleOptions(), object : DrivingSession.DrivingRouteListener { override fun onDrivingRoutes(routes: List<DrivingRoute>) { routes.forEachIndexed { index, route -> val color = if (index == 0) Color.BLUE else Color.GRAY val polyline = mapObjectCollection.addPolyline(route.geometry).apply { strokeColor = color strokeWidth = if (index == 0) 6f else 3f zIndex = if (index == 0) 1f else 0f } // Клік по альтернативному маршруту polyline.addTapListener { _, _ -> selectRoute(index) true } }
// Мета-інформація першого маршруту routes.firstOrNull()?.let { route -> val metadata = route.metadata.weight val distance = metadata.distance.text // "350 км" val time = metadata.timeWithTraffic.text // "4 год 20 хв" showRouteInfo(distance, time) } } override fun onDrivingRoutesError(error: Error) {} } )
</details> #### Пішохідний та транзитний маршрути Замість `DrivingRouter` — `PedestrianRouter` або `TransitRouter`. Транзитний маршрут повертає список сегментів: піші ділянки, автобуси, метро — з часом та зупинками. ### Як реалізувати побудову маршрутів на iOS з MapKit? ```swift func buildDrivingRoute(from: CLLocationCoordinate2D, to: CLLocationCoordinate2D) { let request = MKDirections.Request() request.source = MKMapItem(placemark: MKPlacemark(coordinate: from)) request.destination = MKMapItem(placemark: MKPlacemark(coordinate: to)) request.transportType = .automobile request.requestsAlternateRoutes = true MKDirections(request: request).calculate { [weak self] response, error in guard let routes = response?.routes, !routes.isEmpty else { return } // Малюємо всі маршрути, перший — основний routes.enumerated().forEach { index, route in let renderer = MKPolylineRenderer(polyline: route.polyline) renderer.strokeColor = index == 0 ? .systemBlue : .systemGray renderer.lineWidth = index == 0 ? 5 : 3 self?.mapView.addOverlay(route.polyline, level: .aboveRoads) } // Зум на маршрут self?.mapView.setVisibleMapRect( routes[0].polyline.boundingMapRect, edgePadding: UIEdgeInsets(top: 60, left: 40, bottom: 80, right: 40), animated: true ) } } Покрокова навігація та маневри
Для покрокової навігації використовуйте MKDirections.Shared. Після розрахунку маршруту отримайте масив MKDirections.TransportType. Для відображення маневрів можна використовувати MKMapItem із зазначенням поворотів. Зв'яжіться з нами для отримання повного прикладу.
Проміжні точки (Waypoints)
| Провайдер | Max waypoints | Обмеження |
|---|---|---|
| Google Directions API | 23 (з оптимізацією) | Безкоштовно до 2500 запитів/день |
| Яндекс MapKit | 50 | Підтримує VIAPOINT та WAYPOINT |
| Apple MKDirections | 10 | Тільки на iOS 16+ |
| Mapbox Directions | 25 | Залежно від тарифу |
| 2ГІС SDK | 30 | В офлайн-режимі до 10 |
У застосунках кур'єрських служб часто потрібно 5–10 проміжних точок — це вирішувано. Всі провайдери підтримують waypoints: у Google Directions API — параметр &waypoints=lat,lng|lat,lng, у Яндекс MapKit — додати RequestPoint з типом VIAPOINT, у MKDirections — через waypoints (iOS 16+).
Що входить у роботу
- Інтеграція обраного SDK (Google, Яндекс, Mapbox, 2ГІС) з налаштуванням API-ключів та provisioning profiles.
- Реалізація побудови маршрутів для 1–3 типів транспорту (авто, пішки, транспорт).
- Відмальовка поліліній з кастомними стилями, альтернативні маршрути, перерахунок при відхиленні.
- Підтримка waypoints та покрокової навігації (маневри).
- Документація з інтеграції та рекомендації з оптимізації.
- Консультації з публікації в App Store (App Review Guidelines розділ 4.2/5.1) та Google Play.
- Технічна підтримка протягом 14 днів після здачі проєкту.
- Навчання команди замовника роботі з SDK та інтегрованим рішенням.
Орієнтовна вартість робіт: від $800 до $3000 залежно від складності. Ми гарантуємо якість інтеграції — більше 5 років на ринку мобільної розробки та понад 40 успішних проєктів з картами. Отримайте консультацію з оцінки складності вашого проєкту.
Поширені проблеми інтеграції
Маршрут не перебудовується при зміні точок. Старий Polyline не видалено перед додаванням нового. Потрібно зберігати посилання на поточний overlay та видаляти його: mapView.removeOverlay(currentRoute).
Encoding polyline не декодується. Google використовує точність 1e5 (5 знаків після коми). Яндекс — власний формат. Не використовуйте універсальний decoder для Яндекс-маршрутів.
Строки
Один тип маршруту без waypoints — 1 день. Кілька режимів транспорту, альтернативні маршрути та перерахунок — 2–3 дні. Вартість розраховується індивідуально.
Наш досвід: 7+ років у мобільній розробці, понад 40 проєктів з картами. Замовте оцінку вашого проєкту — ми підберемо оптимальне рішення.