Дано
-
Разработка мобильного приложения под IOS для мониторинга автотранспорта
-
Минимальная версия IOS – 15.5, SwiftUI
-
Использование YandexMapKit для отображения местоположения автомобилей на карте
-
Данные получаем по API с использованием GRPC
Цель
-
Необходимо предоставить информацию об истории поездок с отображением адресов начала и окончания движения
-
Обратный геокодинг (получение адреса по известным географическим координатам) нужно выполнять на стороне клиента, что обусловлено особенностями лицензирования YandexMapKit
Примечание
Я не стану описывать в статье способ подключения YandexMapKit к проекту. Во-первых, это не сложно, а во-вторых описаний этого процессе в интернете предостаточно, в том числе на сайте YandexMapKit SDK.
Однако хочу “пожаловаться”, что исключительно из-за картографии Яндекса в проекте начали использовать CocoaPods, потому что вендор (по состоянию на март 2024 года) не снизошел до разработки пакета, который можно подключить к проекту минуя Pods.
Решение
Для достижения нашей цели определим класс GeoCoder и его инстанс для исключения дубликатов объектов нашего класса:
import SwiftUI import Combine import YandexMapsMobile final class GeoCoder: ObservableObject { static let shared = GeoCoder() // MARK: - Variables private lazy var searchManager = YMKSearch.sharedInstance().createSearchManager(with: .online) private var searchSession: YMKSearchSession? private var searchSessions: [YMKSearchSession] = [] ... }Количество запросов на геокодирование ограничено лицензией YandexMapKit, поэтому мы будем кэшировать результаты геокодирования на устройстве, чтобы при каждом вызове метод сначала проверял кэш. Способ кеширования вы можете выбрать сами. Ввиду относительно небольшого размера кэша я избрал самый простой – @AppStorage
// Хранилище кэша @AppStorage("geoCache") var geoCache: [String: String] = [:]Однако для работы Dictionary[String: String] необходим extension:
extension Dictionary: RawRepresentable where Key == String, Value == String { public init?(rawValue: String) { guard let data = rawValue.data(using: .utf8), let result = try? JSONDecoder().decode([String:String].self, from: data) else { return nil } self = result } public var rawValue: String { guard let data = try? JSONEncoder().encode(self), let result = String(data: data, encoding: .utf8) else { return "{}" // пустой Dictionary представляем как String } return result } }Теперь определяем сам метод.
Обратите внимание, что для логирования я использую функцию writeLog (_ logText: String, logLevel: OSLogType = .default), работу которой демонстрировать не буду. Там используется OSLog и Crashlytics от Google. Вы можете использовать методы логирования своего проекта.
// MARK: - Methods func submitSearch(with point: YMKPoint, completion: @escaping () -> Void) { //проверяем кэш if let address = self.geoCache["(point.latitude)_(point.longitude)"] { writeLog("GeoCoder->submitSearch(): Already cached (address)") completion() } else { //в кэше точку не нашли, отправляем запрос на обратное геокодирование let searchSession = searchManager.submit( with: point, zoom: 16, searchOptions: YMKSearchOptions(), responseHandler: { response, error in // обработка ошибок if let error = error { writeLog("GeoCoder->submitSearch(): ERROR (error.localizedDescription)", logLevel: .error) completion() } //обработка результата guard let response = response else { return completion() } if let obj = response.collection.children.first?.obj?.metadataContainer.getItemOf(YMKSearchToponymObjectMetadata.self) { let object = obj as! YMKSearchToponymObjectMetadata // Сохраняем даные в кэше. self.geoCache["(point.latitude)_(point.longitude)"] = object.address.formattedAddress writeLog("GeoCoder->submitSearch(): SUCCESS (object.address.formattedAddress)") completion() } } ) searchSessions.append(searchSession) } }Использование
Не забываем про определение объекта класса
@ObservedObject var geoCoder = GeoCoder.sharedИ про “подключение” его в Struct, который отвечает за отображение конкретной поездки:
import SwiftUI import Kingfisher import SwiftProtobuf import YandexMapsMobile struct TrackView: View { @StateObject var geoCoder = GeoCoder.shared @State var track: API_V1_TrackInfo @State var startAddress: String @State var endAddress: String init(track: API_V1_TrackInfo) { self.track = track self.startAddress = "( String(track.beginPoint.latitude)), (String(track.beginPoint.longitude))" self.endAddress = "( String(track.endPoint.latitude)), (String(track.endPoint.longitude))" } var body: some View { ... LazyVStack { VStack(alignment: .leading){ Text("(track.begin.toLocaTimetring()) - (startAddress)") .frame(maxWidth: .infinity, alignment: .leading) .multilineTextAlignment(TextAlignment.leading) Spacer() Text("(track.end.toLocaTimetring()) - (endAddress)") .frame(maxWidth: .infinity, alignment: .leading) .multilineTextAlignment(TextAlignment.leading) } .onAppear{ let beginPoint = YMKPoint(latitude: track.beginPoint.latitude, longitude: track.beginPoint.longitude) let endPoint = YMKPoint(latitude: track.endPoint.latitude, longitude: track.endPoint.longitude) geoCoder.submitSearch(with: beginPoint , completion: { if let address = geoCoder.geoCache["(beginPoint.latitude)_(beginPoint.longitude)"] { self.startAddress = address } }) geoCoder.submitSearch(with: endPoint , completion: { if let address = geoCoder.geoCache["(endPoint.latitude)_(endPoint.longitude)"] { self.endAddress = address } }) } .frame(maxWidth: .infinity) .padding(0) }.padding(0) ... } }Результат
При открытии указаны координаты, которые заменяются адресами по мере загрузки
В результате наблюдаем следующие записи в логе:
Часть адресов уже есть в кэше, остальные геокодируем
Обратите внимание, что адреса от Яндекса по умолчанию приходят на том языке, который используется устройством пользователя.