Постановка задачи
Имеются значения широты и долготы определенной точки в пространстве. Необходимо получить ее адрес.
Решение
Получение обычного адреса на основании известных пространственных координат (x и y) называется обратным геокодированием. Для выполнения такой операции нужно создать и использовать экземпляр класса CLGeocoder, а также предоставить блоковый объект завершения. При этом необходимо гарантировать, что блоковый объект не имеет возвращаемого значения и принимает два параметра:
• массив меток (типа NSArray). Метками будут обозначены те точки на карте, которые соответствуют критериям поискового запроса;
• ошибку (типа NSError), которая будет преобразована в код ошибки, если обратное геокодирование не удастся.
Инстанцировав объект типа CLGeocoder, мы используем его метод reverseGeocodeLocation: completionHandler: для выполнения обратного геокодирования.
Верхняя часть. m-файла простого контроллера вида, применяемого для этой цели, определяется следующим образом:
#import «ViewController.h»
#import
@interface ViewController ()
@property (nonatomic, strong) CLGeocoder *myGeocoder;
@end
@implementation ViewController
В ходе загрузки вида можно выполнить обратное геокодирование:
— (void)viewDidLoad{
[super viewDidLoad];
CLLocation *location = [[CLLocation alloc]
initWithLatitude:+38.41 12810
longitude:-122.8409780f];
self.myGeocoder = [[CLGeocoder alloc] init];
[self.myGeocoder
reverseGeocodeLocation: location
completionHandler: ^(NSArray *placemarks, NSError *error) {
if (error == nil && placemarks.count > 0){
CLPlacemark *placemark = placemarks[0];
/* Результаты получены. */
NSLog(@"Country = %@", placemark.country);
NSLog(@"Postal Code = %@", placemark.postalCode);
NSLog(@"Locality = %@", placemark.locality);
}
else if (error == nil &&
[placemarks count] == 0){
NSLog(@"No results were returned.");
}
else if (error!= nil){
NSLog(@"An error occurred = %@", error);
}
}];
}
— (void)viewDidUnload{
[super viewDidUnload];
self.myGeocoder = nil;
}
Если операция завершится успешно, то в массиве placemarks будут содержаться объекты типа CLPlacemark. Эти объекты будут отмечать адреса, удовлетворяющие значениям широты и долготы, которые мы сообщили методу reverseGeocodeLocation: completionHandler:. Итак, все, что от нас требуется, — убедиться в отсутствии ошибок и в том, что в массиве меток есть как минимум одна метка.
Методы NSLog из приведенного ранее кода выводят в окне консоли адрес, прошедший процедуру обратного геокодирования:
Country = United States
Postal Code = 95472
Locality = Sebastopol
Обсуждение
В каждом приложении имеется лимит объема запросов на обратное геокодирование, которые могут быть выполнены в данном приложении за один день. Этот объем определяется провайдером серверного приложения, обеспечивающего поддержку геолокационных служб в iOS. Существуют различные платные онлайновые сервисы, которые предоставляют разработчикам сторонние API. Я не могу сейчас рекламировать какие-либо из подобных сервисов, но можете сами поискать их в Интернете, если захотите преодолеть ограничения, связанные с обратным геокодированием пространственных координат, существующие в настоящее время в iOS SDK. Чтобы выполнить запрос на обратное геокодирование, нужно создать экземпляр класса CLGeocoder. Этот класс требует активного сетевого соединения — оно необходимо для успешной обработки запросов. Значения, прошедшие обратное геокодирование, сообщаются блоку обработки завершения, который передается методу reverseGeocodeLocation: completionHandler:.
См. также
Раздел 9.7.
9.9. Поиск в картографическом виде
Постановка задачи
Требуется предоставить пользователям, просматривающим картографический вид, поисковую функцию. Например, можно помочь им найти все рестораны или тренажерные залы в конкретном регионе, отображенном на карте. Если пользователь находится в центре города и видит свое местоположение на карте, он может просто ввести в строку поиска слово «рестораны» — и приложение выполнит поиск по такому запросу.
Решение
Картографические виды, без преувеличения, просто великолепны. Но иногда такой вид ничем не может помочь пользователю, который видит на экране просто одну большую карту. В таком случае вполне сгодится и обычная бумажная карта. Картографические возможности смартфонов интересны именно в контексте их интерактивности. Пользователь может находить на карте объекты, искать интересующие его места, получать информацию о том, как попасть в место, расположенное по тому или иному адресу. Apple включила в iOS SDK три очень удобных класса, позволяющих пользователю искать места на карте. Такой поиск совершенно прост. От вас требуется всего лишь ввести текстовый запрос о том, что вас интересует, например «рестораны» или «кафе, — и SDK выполнит за вас остальную работу. В этом разделе мы собираемся отобразить в контроллере вида картографический вид (с местоположением пользователя) и отслеживать местоположение пользователя. Таким образом, та точка, в которой он находится, всегда будет располагаться в центре карты.
Как только картографический вид поможет нам установить местоположение пользователя (предполагается, что пользователь разрешил нам это сделать), мы вызовем класс MKLocalSearch и выберем все рестораны, находящиеся поблизости от него. Первым делом определим картографический вид, вот так:
#import «ViewController.h»
#import
@interface ViewController ()
@property (nonatomic, strong) MKMapView *myMapView;
@end
@implementation ViewController
Далее необходимо создать картографический вид:
— (void)viewDidLoad {
[super viewDidLoad];
/* Создаем карту, совпадающую по размеру с нашим видом */
self.myMapView = [[MKMapView alloc]
initWithFrame: self.view.bounds];
self.myMapView.delegate = self;
/* Задаем для карты тип Standard */
self.myMapView.mapType = MKMapTypeStandard;
self.myMapView.autoresizingMask =
UIViewAutoresizingFlexibleWidth |
UIViewAutoresizingFlexibleHeight;
self.myMapView.showsUserLocation = YES;
self.myMapView.userTrackingMode = MKUserTrackingModeFollow;
/* Добавляем ее к нашему виду */
[self.view addSubview: self.myMapView];}
Мы используем свойство showsUserLocation картографического вида. Это логическое значение. Если оно равно YES, то картографический вид ищет местоположение пользователя (при наличии у нас разрешения на это). Все это, конечно, хорошо, но по умолчанию картографический вид действует так: он находит место на карте и отображает для него аннотацию, но не перемещает центральную точку карты и не увеличивает то место, где располагается пользователь. Иными словами, если в данный момент в картографическом виде отображается карта Великобритании, а пользователь находится где-то в Нью-Йорке, то он по-прежнему будет видеть на экране своего устройства карту Соединенного королевства. Чтобы исправить этот недостаток, нужно задать для свойства userTrackingMode картографического вида значение MKUserTrackingModeFollow, при котором центр картографического вида всегда соответствует местоположению пользователя. Отображаемая часть карты корректируется в соответствии с перемещением пользователя.
Теперь, когда мы приказали картографическому виду отслеживать местоположение пользователя, необходимо реализовать следующие методы делегатов картографического вида:
• mapView: didFailToLocateUserWithError: — вызывается в делегате, когда картографическому виду не удается определить местоположение пользователя. В этом методе мы выводим для пользователя предупреждение о том, что определить его местоположение не получается;
• mapView: didUpdateUserLocation: — вызывается в делегате картографического вида всякий раз, когда информация о местоположении пользователя обновляется. Таким образом, он всегда соответствует успешному варианту развития бизнес-логики. В этом методе можем реализовать локальную функцию поиска.
Сначала давайте реализуем метод mapView: didFailToLocateUserWithError::
— (void) mapView:(MKMapView *)mapView
didFailToLocateUserWithError:(NSError *)error{
UIAlertView *alertView = [[UIAlertView alloc]
initWithTitle:@"Failed"
message:@"Could not get the user's location"
delegate: nil cancelButtonTitle:@"OK"
otherButtonTitles: nil];
[alertView show];
}
Элементарно. Переходим к методу mapView: didUpdateUserLocation::
— (void) mapView:(MKMapView *)mapView
didUpdateUserLocation:(MKUserLocation *)userLocation{
MKLocalSearchRequest *request = [[MKLocalSearchRequest alloc] init];
request.naturalLanguageQuery = @"restaurants";
MKCoordinateSpan span = MKCoordinateSpanMake(0.01, 0.01);
request.region =
MKCoordinateRegionMake(userLocation.location.coordinate, span);
MKLocalSearch *search = [[MKLocalSearch alloc] initWithRequest: request];
[search startWithCompletionHandler:
^(MKLocalSearchResponse *response, NSError *error) {
for (MKMapItem *item in response.mapItems){
NSLog(@"Item name = %@", item.name);
NSLog(@"Item phone number = %@", item.phoneNumber);
NSLog(@"Item url = %@", item.url);
NSLog(@"Item location = %@", item.placemark.location);
}
}];
}
В этом методе все просто. Мы создаем локальный поисковый запрос и устанавливаем в качестве значения его свойства naturalLanguageQuery те элементы, которые мы хотим найти на карте, — в данном случае рестораны. Затем получаем местоположение пользователя и создаем на его основе регион типа MKCoordinateRegion. Мы делаем это потому, что хотим определить область, окружающую пользователя, и выполнить поиск в этой области. Область сообщает движку поиска местоположения о том, что мы хотим ограничить круг поиска заданным регионом. Как только регион создан, задаем его в качестве значения свойства region для локального поиска. Сделав это, можно приступать к поиску. Для этого мы отправляем локальный поисковый запрос методу экземпляра startWithCompletionHandler:, относящемуся к классу MKLocalSearch. Этот метод принимает блок в качестве параметра. Данный блок кода вызывается при поступлении результатов поиска или возникновении ошибки.
Найденные элементы будут записаны в свойстве mapItems параметра отклика нашего блокового объекта, эти картографические элементы будут относиться к типу MKMapItem. У каждого элемента будут свойства — в частности, name, phoneNumber и url — которые помогут нанести на карту интересующие нас точки. При этом мы воспользуемся приемами, изученными ранее в этой главе, — например, отобразим на карте маркеры, о которых говорили в разделе 9.4.
См. также
Разделы 9.4–9.6.
9.10. Отображение направлений на карте