iOS開發(fā)之封裝高德地圖搜索管理類

一、前言

我們在項目開發(fā)中經(jīng)常會用到第三方的SDK等來實現(xiàn)項目所需要的功能,很多時候拿到別人的東西并不是所有的都適合我們自己的項目,為了方便使用或者擴展更多功能,或者為了對第三方的代碼進行更合理的管理,經(jīng)常要對他們的代碼和功能進行封裝。以此來達到方便管理,更便于閱讀,功能更適合自己項目等功能,而且有些東西進行一次封裝,多處可以使用,這樣就很方便。

我們以高德地圖搜索類AMapSearchAPI為例子,進行該功能的封裝和在項目中的使用。

二、高德地圖搜索管理類AMapSearchAPI

AMapSearchAPI里提供了各種搜索功能的Api,比如關(guān)鍵字查詢Api:

/**
 * @brief POI 關(guān)鍵字查詢接口
 * @param request 查詢選項。具體屬性字段請參考 AMapPOIKeywordsSearchRequest 類。
 */
- (void)AMapPOIKeywordsSearch:(AMapPOIKeywordsSearchRequest *)request;

還有各種周邊查詢、逆地理編碼查詢等等,這些Api都有各自的代理回調(diào),比如關(guān)鍵字檢索回調(diào)代理:

/**
 * @brief POI查詢回調(diào)函數(shù)
 * @param request  發(fā)起的請求,具體字段參考 AMapPOISearchBaseRequest 及其子類。
 * @param response 響應(yīng)結(jié)果,具體字段參考 AMapPOISearchResponse 。
 */
- (void)onPOISearchDone:(AMapPOISearchBaseRequest *)request response:(AMapPOISearchResponse *)response;

提供了各種搜索功能和回調(diào)代理。

三、功能實現(xiàn)

這里考慮到項目中經(jīng)常使用,所以創(chuàng)建一個單例作為項目中高德地圖搜索管理類。

1、實現(xiàn)代碼

DDSearchManager.h

#import <Foundation/Foundation.h>

typedef void(^keyWordSearchBlock)(NSMutableArray *pointAnnotaions);//用于關(guān)鍵字檢索回調(diào)數(shù)據(jù)
typedef void(^tipsSearchBlock)(NSArray *tips);//用于tip搜索回調(diào)數(shù)據(jù)

@interface DDSearchManager : NSObject

+ (instancetype)sharedManager;

/* 2比1查詢速度快;1的數(shù)據(jù)量比2大 。*/

/*
 1、關(guān)鍵字檢索
 
 keyword為檢索關(guān)鍵字;city可為空;block返回檢索完后的數(shù)組,數(shù)組中是MAPointAnnotation的對象
 
 注意:關(guān)鍵字未設(shè)置城市信息(默認為全國搜索)時,如果涉及多個城市數(shù)據(jù)返回,僅會返回建議城市,請根據(jù)APP需求,選取城市進行搜索。
 */
- (void)keyWordsSearch:(NSString *)keyword city:(NSString *)city returnBlock:(keyWordSearchBlock)block;


/*
 2、輸入提示查詢
 
 block回調(diào)查詢后的數(shù)組,該數(shù)組里是AMapTip對象
 */
- (void)inputTipsSearch:(NSString *)tips city:(NSString *)city returnBlock:(tipsSearchBlock)block;

@end

DDSearchManager.m

#import "DDSearchManager.h"

#import <AMapSearchKit/AMapSearchKit.h>
#import <MAMapKit/MAMapKit.h>

@interface DDSearchManager ()<AMapSearchDelegate>

//高德地圖搜索管理類
@property (nonatomic, strong) AMapSearchAPI *searchAPI;

@property (nonatomic, copy) keyWordSearchBlock keyWordSearchBlock;
@property (nonatomic, copy) tipsSearchBlock tipSearchBlock;

@end

@implementation DDSearchManager

+ (instancetype)sharedManager {
    static DDSearchManager *manager = nil;
    static dispatch_once_t once;
    dispatch_once(&once, ^{
        manager = [[self alloc]init];
    });
    return manager;
}

/// 關(guān)鍵字查詢
- (void)keyWordsSearch:(NSString *)keyword city:(NSString *)city returnBlock:(keyWordSearchBlock)block
{
    if (keyword.length) {
        
        self.keyWordSearchBlock = block;
        
        AMapPOIKeywordsSearchRequest *request = [[AMapPOIKeywordsSearchRequest alloc]init];
        
        request.keywords = keyword;
        if (city.length) {
            request.city = city;
            /* 搜索SDK 3.2.0 中新增加的功能,只搜索本城市的POI。*/
            request.cityLimit = YES;
        }
        /*返回擴展信息*/
        request.requireExtension = YES;
        request.requireSubPOIs = YES;
        
        /*發(fā)起關(guān)鍵字搜索*/
        [self.searchAPI AMapPOIKeywordsSearch:request];
    }
}

/// 輸入提示查詢
- (void)inputTipsSearch:(NSString *)tips city:(NSString *)city returnBlock:(tipsSearchBlock)block {
    if (tips.length) {
        
        self.tipSearchBlock = block;
        
        AMapInputTipsSearchRequest *request = [[AMapInputTipsSearchRequest alloc]init];
        
        request.keywords = tips;
        if (city.length) {
            request.city = city;
            request.cityLimit = YES;
        }
        
        /*發(fā)起關(guān)鍵字搜索*/
        [self.searchAPI AMapInputTipsSearch:request];
    }
}

#pragma mark delegate
#pragma AMapSearchDelegate
//關(guān)鍵字查詢代理回調(diào)
- (void)onPOISearchDone:(AMapPOISearchBaseRequest *)request response:(AMapPOISearchResponse *)response
{
    if (response.pois.count == 0) {
        return;
    }
    
    NSMutableArray *poiAnnitations = [[NSMutableArray alloc]init];
    
    [response.pois enumerateObjectsUsingBlock:^(AMapPOI * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
        
        MAPointAnnotation *annotation = [[MAPointAnnotation alloc] init];
        [annotation setCoordinate:CLLocationCoordinate2DMake(obj.location.latitude, obj.location.longitude)];
        [annotation setTitle:obj.name];
        [annotation setSubtitle:obj.address];
        
        [poiAnnitations addObject:annotation];
    }];
    //回調(diào)檢索結(jié)果,回調(diào)數(shù)組是MAPointAnnotation的對象集合
    if (self.keyWordSearchBlock) {
        self.keyWordSearchBlock (poiAnnitations);
    }
}
//輸入提示查詢代理回調(diào)
-(void)onInputTipsSearchDone:(AMapInputTipsSearchRequest *)request response:(AMapInputTipsSearchResponse *)response
{
    if (self.tipSearchBlock)
    {
        NSMutableArray *arr = [NSMutableArray array];
        for (int i=0; i<response.tips.count; i++)
        {
            //輸入提示類
            AMapTip *tip = [response.tips objectAtIndex:i];
            
            if (tip.location.latitude!=0 && ![tip.uid isEqualToString:@""])
            {
                [arr addObject:tip];
            }
        }
        //回調(diào)tip檢索結(jié)果,回調(diào)數(shù)組中是AMapTip對象的集合。
        self.tipSearchBlock (arr);
    }
}

#pragma mark set/get
- (AMapSearchAPI *)searchAPI {
    if (!_searchAPI) {
        _searchAPI = [[AMapSearchAPI alloc]init];
        _searchAPI.delegate = self;
    }
    return _searchAPI;
}

@end

2、調(diào)用

這里隨便截取了一段示例代碼,發(fā)起tip檢索,然后回調(diào)數(shù)據(jù),更新數(shù)據(jù)源,然后刷新tableView的列表功能。

[[DDSearchManager searchManager] inputTipsSearch:text city:self.selectCityBtn.titleLabel.text returnBlock:^(NSArray *tips) {

    [_searchArr removeAllObjects];
    [_searchArr addObjectsFromArray:tips]];
    [_tableView reloadData];
}];

這里有一個問題就是刷新tableView的時候如果給cell賦值,你得知道回調(diào)數(shù)組里面是什么類型的數(shù)據(jù),不然不知道怎么賦值。

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
    static NSString *cellId = kCellReuseIdentifier;
    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:kCellReuseIdentifier];
    if (cell == nil) {
        cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:kCellReuseIdentifier];
    }
    
    AMapPOI *poi = self.dataSource[indexPath.row];
    NSLog(@"poi.name :%@     poi.address:%@ ",poi.name,poi.address);
    cell.textLabel.text = poi.name;
    cell.detailTextLabel.text = poi.address;

    return cell;
}

四、問題思考

以上一個高德地圖的搜索管理類就簡單的完成了,但是就這樣能算是封裝嗎?我覺得不能算完全封裝,原因有如下:

1、結(jié)構(gòu)都通過數(shù)據(jù)回調(diào),使用的人怎么會知道數(shù)組里是什么呢?
2、封裝的話一般不應(yīng)該將原來的東西暴露在外,這里雖然DDSearchManager.h沒有暴露有關(guān)于高德地圖SDK,AMapSearchAPI等,但是在使用的時候,還得用高德SDK中的類AMapTip和MAPointAnnotation,這樣的封裝不夠徹底。

所以以上封裝還算不到封裝,如果算也只是個半成品,不夠徹底。所以我們需要繼續(xù)優(yōu)化,繼續(xù)封裝。

五、繼續(xù)封裝

1、創(chuàng)建一個定義搜索結(jié)果的基礎(chǔ)數(shù)據(jù)類型的類DDSearchObj

DDSearchObj.h
//
//  DDSearchObj.h
//  GDAddressSelected
//  該文件定義了搜索結(jié)果的基礎(chǔ)數(shù)據(jù)類型。
//

#import <Foundation/Foundation.h>
#import <CoreLocation/CoreLocation.h>

@interface DDSearchObj : NSObject

@end

///輸入提示
@interface DDSearchTip : DDSearchObj

///名稱
@property (nonatomic, copy) NSString   *name;
///區(qū)域編碼
@property (nonatomic, copy) NSString   *adcode;
///所屬區(qū)域
@property (nonatomic, copy) NSString   *district;
///地址
@property (nonatomic, copy) NSString   *address;
///經(jīng)緯度
@property (nonatomic, assign) CLLocationCoordinate2D coordinate;

@end

///點標注數(shù)據(jù)
@interface DDSearchPointAnnotation : DDSearchObj

///經(jīng)緯度
@property (nonatomic, assign) CLLocationCoordinate2D coordinate;
///標題
@property (nonatomic, copy) NSString *title;
///副標題
@property (nonatomic, copy) NSString *subtitle;

@end

這個類里面有DDSearchTip和DDSearchPointAnnotation,這分別是tip搜索回調(diào)數(shù)據(jù)類型的類和關(guān)鍵字搜索回調(diào)數(shù)據(jù)的類,這兩個類有各自的屬性,視項目情況自己添加更多屬性等。

DDSearchObj.m
#import "DDSearchObj.h"

@implementation DDSearchObj

@end


@implementation DDSearchPointAnnotation

@end


@implementation DDSearchTip

@end

2、優(yōu)化DDSearchManager類

DDSearchManager.h
#import <Foundation/Foundation.h>
#import "DDSearchObj.h"

//關(guān)鍵字搜索數(shù)據(jù)回調(diào)block
typedef void(^keyWordSearchBlock)(NSArray <__kindof DDSearchPointAnnotation*> *pointAnnotaions);
//tip搜索數(shù)據(jù)回調(diào)block
typedef void(^tipsSearchBlock)(NSArray <__kindof DDSearchTip*> *tips);

@interface DDSearchManager : NSObject

+ (instancetype)sharedManager;

/* 2比1查詢速度快;1的數(shù)據(jù)量比2大 。*/

/*
 1、關(guān)鍵字檢索
 
 keyword為檢索關(guān)鍵字;city可為空;block返回檢索完后的數(shù)組,數(shù)組中是MAPointAnnotation的對象
 
 注意:關(guān)鍵字未設(shè)置城市信息(默認為全國搜索)時,如果涉及多個城市數(shù)據(jù)返回,僅會返回建議城市,請根據(jù)APP需求,選取城市進行搜索。
 */
- (void)keyWordsSearch:(NSString *)keyword city:(NSString *)city returnBlock:(keyWordSearchBlock)block;

/*
 2、輸入提示查詢
 
 block回調(diào)查詢后的數(shù)組,該數(shù)組里是AMapTip對象
 */
- (void)inputTipsSearch:(NSString *)tips city:(NSString *)city returnBlock:(tipsSearchBlock)block;

@end

引入DDSearchObj.h頭文件,將數(shù)據(jù)回調(diào)的block用<__kindof DDSearchPointAnnotation*>修飾,表示該數(shù)組里面只能是DDSearchPointAnnotation類型的數(shù)據(jù),這樣的話,當使用該類的人用此方法的時候block回調(diào)里面就會知道,這個回調(diào)數(shù)據(jù)是DDSearchPointAnnotation的數(shù)組,而不是其他什么東西的數(shù)據(jù)。

DDSearchManager.m
#import "DDSearchManager.h"
#import <AMapSearchKit/AMapSearchKit.h>
#import <MAMapKit/MAMapKit.h>

@interface DDSearchManager ()<AMapSearchDelegate>

@property (nonatomic, strong) AMapSearchAPI *searchAPI;

@property (nonatomic, copy) keyWordSearchBlock keyWordSearchBlock;
@property (nonatomic, copy) tipsSearchBlock tipSearchBlock;

@end

@implementation DDSearchManager

+ (instancetype)sharedManager {
    static DDSearchManager *manager = nil;
    static dispatch_once_t once;
    dispatch_once(&once, ^{
        manager = [[self alloc]init];
    });
    return manager;
}

/// 關(guān)鍵字查詢
- (void)keyWordsSearch:(NSString *)keyword city:(NSString *)city returnBlock:(keyWordSearchBlock)block
{
    if (keyword.length) {
        
        self.keyWordSearchBlock = block;
        
        AMapPOIKeywordsSearchRequest *request = [[AMapPOIKeywordsSearchRequest alloc]init];
        
        request.keywords = keyword;
        if (city.length) {
            request.city = city;
            /* 搜索SDK 3.2.0 中新增加的功能,只搜索本城市的POI。*/
            request.cityLimit = YES;
        }
        /*返回擴展信息*/
        request.requireExtension = YES;
        request.requireSubPOIs = YES;
        
        /*發(fā)起關(guān)鍵字搜索*/
        [self.searchAPI AMapPOIKeywordsSearch:request];
    }
}

/// 輸入提示查詢
- (void)inputTipsSearch:(NSString *)tips city:(NSString *)city returnBlock:(tipsSearchBlock)block {
    if (tips.length) {
        
        self.tipSearchBlock = block;
        
        AMapInputTipsSearchRequest *request = [[AMapInputTipsSearchRequest alloc]init];
        
        request.keywords = tips;
        if (city.length) {
            request.city = city;
            request.cityLimit = YES;
        }
        
        /*發(fā)起關(guān)鍵字搜索*/
        [self.searchAPI AMapInputTipsSearch:request];
    }
}

#pragma mark delegate
#pragma AMapSearchDelegate
//關(guān)鍵字查詢代理回調(diào)
- (void)onPOISearchDone:(AMapPOISearchBaseRequest *)request response:(AMapPOISearchResponse *)response
{
    if (response.pois.count == 0) {
        return;
    }
    
    NSMutableArray *poiAnnitations = [[NSMutableArray alloc]init];
    
    [response.pois enumerateObjectsUsingBlock:^(AMapPOI * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
        
//        MAPointAnnotation *annotation = [[MAPointAnnotation alloc] init];
//        [annotation setCoordinate:CLLocationCoordinate2DMake(obj.location.latitude, obj.location.longitude)];
//        [annotation setTitle:obj.name];
//        [annotation setSubtitle:obj.address];
        
        DDSearchPointAnnotation *annotation = [[DDSearchPointAnnotation alloc] init];
        [annotation setCoordinate:CLLocationCoordinate2DMake(obj.location.latitude, obj.location.longitude)];
        [annotation setTitle:obj.name];
        [annotation setSubtitle:obj.address];
        
        [poiAnnitations addObject:annotation];
    }];

    if (self.keyWordSearchBlock) {
        self.keyWordSearchBlock (poiAnnitations);
    }
}
//輸入提示查詢代理回調(diào)
-(void)onInputTipsSearchDone:(AMapInputTipsSearchRequest *)request response:(AMapInputTipsSearchResponse *)response
{
    if (self.tipSearchBlock)
    {
        NSMutableArray *arr = [NSMutableArray array];
        for (int i=0; i<response.tips.count; i++)
        {
            AMapTip *tip = [response.tips objectAtIndex:i];
            
//            if (tip.location.latitude!=0 && ![tip.uid isEqualToString:@""])
//            {
//                [arr addObject:tip];
//            }
            
            if (tip.location.latitude!=0 && ![tip.uid isEqualToString:@""])
            {
                DDSearchTip *ddTip = [[DDSearchTip alloc] init];
                ddTip.name = tip.name;
                ddTip.adcode = tip.adcode;
                ddTip.district = tip.name;
                ddTip.address = tip.address;
                ddTip.coordinate = CLLocationCoordinate2DMake(tip.location.latitude, tip.location.longitude);
                
                [arr addObject:tip];
            }
            
        }
        self.tipSearchBlock (arr);
    }
}

#pragma mark set/get
- (AMapSearchAPI *)searchAPI {
    if (!_searchAPI) {
        _searchAPI = [[AMapSearchAPI alloc]init];
        _searchAPI.delegate = self;
    }
    return _searchAPI;
}

@end

這里我將原來的寫法注釋掉,稍作了變動。將高德地圖的數(shù)據(jù)轉(zhuǎn)化成我們自己的數(shù)據(jù)存儲,并回調(diào)。這樣的話,在外部使用的時候,用的人不用關(guān)心高德地圖類里面的實現(xiàn)過程,中需要知道當發(fā)起檢索時回調(diào),回調(diào)的數(shù)據(jù)在相應(yīng)的地方去拿數(shù)據(jù)就好了。

3、發(fā)起檢索

[[DDSearchManager sharedManager] keyWordsSearch:@"北京大學" city:@"北京" returnBlock:^(NSArray<__kindof DDSearchPointAnnotation *> *pointAnnotaions) {
    
    for (DDSearchPointAnnotation *annotation in pointAnnotaions)
    {
        NSLog(@"%@,%@,%f,%f",annotation.title,annotation.subtitle,annotation.coordinate.latitude,annotation.coordinate.longitude);
    }
}];

這里當我們調(diào)用該方法進行關(guān)鍵字檢索的時候,在block回調(diào)中就能知道回調(diào)的數(shù)據(jù)是DDSearchPointAnnotation對象的數(shù)組,不用關(guān)心高德地圖內(nèi)部檢索的結(jié)果是什么,只需要進入DDSearchPointAnnotation類里,就可以知道回調(diào)的數(shù)據(jù)你需要取哪些值。

這樣避免了高德SDK類的外部暴露出來,這就簡單的封裝了一個高德地圖檢索的管理類,這里是用block進行數(shù)據(jù)回調(diào)的,當然小伙伴們也可以用代理的方式。

六、總結(jié)

  • 當我們封裝一個第三方的功能的時候,封裝使得它能夠更好的服務(wù)于我們自己的項目。

  • 如果要封裝盡量封裝的徹底一點,盡量不要暴露第三方的東西,你的封裝類依賴于三方,實現(xiàn)的時候還依賴于三方類,這樣的封裝總感覺不是很完美。

  • 當然有的小伙伴說了不進行上面的優(yōu)化封裝部分也行,也能用,就看個人怎么理解了。

代碼:https://github.com/Mexiang/DDSearchManager

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,048評論 6 542
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 99,414評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,169評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經(jīng)常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,722評論 1 317
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,465評論 6 412
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 55,823評論 1 328
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,813評論 3 446
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 43,000評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 49,554評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 41,295評論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,513評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,035評論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 44,722評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,125評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,430評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,237評論 3 398
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,482評論 2 379

推薦閱讀更多精彩內(nèi)容