百度地图SDK提供的检索服务包括以下功能模块:
POI检索,
公交方案检索,
驾车路线检索,
步行路线检索,
行政区边界数据检索,
地理编码,
反地理编码,
公交详情检索,
在线建议查询,
短串分享(包括POI搜索结果分享、驾车/公交/骑行/步行路线规划分享、反向地理编码结果分享)。
1 POI周边检索
POI(Point of Interest),中文可以翻译为“兴趣点”。在地理信息系统中,一个POI可以是一栋房子、一个商铺、一个邮筒、一个公交站等。
百度地图SDK提供三种类型的POI检索:周边检索、区域检索和城市内检索。下面将以周边检索为例,向大家介绍如何使用检索服务。
1.1 在页面上定义一个输入框,内容改变时发起检索
注意检查 nearBySearchOption.location 内容是否正确,否则总是检索不到结果
UITextField *poiTextField = [[UITextField alloc] initWithFrame:CGRectMake(30, 30, 100, 20)];
poiTextField.backgroundColor = [UIColor lightGrayColor];
[poiTextField addTarget:self action:@selector(valueChange:) forControlEvents:UIControlEventEditingChanged];
[self.view addSubview:poiTextField];
- (void)valueChange:(UITextField *)textField {
_poiSearch = [[BMKPoiSearch alloc]init];
_poiSearch.delegate = self;
// 附近云检索
BMKNearbySearchOption *nearBySearchOption = [[BMKNearbySearchOption alloc]init];
// 检索关键字
nearBySearchOption.keyword = textField.text;
// 检索中心点及半径
nearBySearchOption.location = _locService.userLocation.location.coordinate;
nearBySearchOption.radius = 10000;
// 搜索结果排序,距离由近到远
nearBySearchOption.sortType = BMK_POI_SORT_BY_DISTANCE;
// 分页索引及数量
nearBySearchOption.pageIndex = 0;
nearBySearchOption.pageCapacity = 10;
// 开始检索,结果在代理方法 onGetPoiResult 中返回
BOOL flag = [_poiSearch poiSearchNearBy:nearBySearchOption];
if (flag) {
NSLog(@"搜索成功--%@", textField.text);
}else {
NSLog(@"搜索失败");
}
}
1.2 结果监听
调用 poiSearchNearBy 方法后,检索结果 在代理方法 onGetPoiResult 中返回,poiResult.poiInfoList 就是检索到的结果,是一个 BMKPoiInfo 的集合,每个BMKPoiInfo包含该检索点的名称,地址,uid等详细信息。
- (void)onGetPoiResult:(BMKPoiSearch *)searcher result:(BMKPoiResult *)poiResult errorCode:(BMKSearchErrorCode)errorCode {
if (errorCode == BMK_SEARCH_NO_ERROR) {
for (int i = 0; i < poiResult.poiInfoList.count; i++) {
BMKPoiInfo *info = [poiResult.poiInfoList objectAtIndex:i];
NSLog(@"地址:%@---%@---%@", info.city ,info.name, info.address);
}
}else {
NSLog(@"检索异常-%d", errorCode);
}
}
检索.PNG
检索结果.jpeg
1.3 展示
1.3.1 把这些数据显示到tableview上,就是我们常见的搜索框搜索得到对应的结果。
检索结果.PNG1.3.2 或者将搜索出来的结果通过大头针展示在地图上:
- (void)onGetPoiResult:(BMKPoiSearch *)searcher result:(BMKPoiResult *)poiResult errorCode:(BMKSearchErrorCode)errorCode {
// 清楚屏幕中所有的annotation
NSArray* array = [NSArray arrayWithArray:_mapView.annotations];
[_mapView removeAnnotations:array];
if (errorCode == BMK_SEARCH_NO_ERROR) {
NSMutableArray *arrM = [NSMutableArray array];
for (int i = 0; i < poiResult.poiInfoList.count; i++) {
BMKPoiInfo *info = [poiResult.poiInfoList objectAtIndex:i];
NSLog(@"地址:%@---%@---%@", info.city ,info.name, info.address);
BMKPointAnnotation* item = [[BMKPointAnnotation alloc]init];
item.coordinate = info.pt;
item.title = info.name;
[arrM addObject:item];
}
[_mapView addAnnotations:arrM];
[_mapView showAnnotations:arrM animated:YES];
self.poiResultArr = poiResult.poiInfoList;
[self.tableView reloadData];
}else {
NSLog(@"检索异常-%d", errorCode);
}
}
大头针展示.PNG
2 公交详情信息检索-基于POI
基于上面POI检索返回的POI结果中,BMKPoiInfo有一属性epoitype,表示POI类型,epoitype字段值为2标示公交路线,4表示地铁路线,把这两种类型的POI的 uid 传给公交信息检索接口,可以得到该POI所代表的路线的详细信息(如:该公交线有多少个站点,每个站点的名称,位置、参考票价和上下线行信息)。
点击tableView调用 公交详情信息检索,代码如下:
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
return self.poiResultArr.count;
}
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"ID"];
if (!cell) {
cell = [[UITableViewCell alloc]initWithStyle:UITableViewCellStyleDefault reuseIdentifier:@"ID"];
}
BMKPoiInfo *info = self.poiResultArr[indexPath.row];
cell.textLabel.text = info.name;
return cell;
}
- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
BMKPoiInfo *info = self.poiResultArr[indexPath.row];
if (info.epoitype == 2 || info.epoitype == 4) {
// 发起公交检索
[self startBusLineSearchWithCity:info.city uid:info.uid];
}else {
NSLog(@"这不是一条公交线路");
}
[tableView deselectRowAtIndexPath:indexPath animated:YES];
}
#pragma mark
#pragma mark -- 公交方案检索
- (void)startBusLineSearchWithCity:(NSString *)city uid:(NSString *)uid{
_busLineSearch = [[BMKBusLineSearch alloc]init];
_busLineSearch.delegate = self;
BMKBusLineSearchOption *option = [[BMKBusLineSearchOption alloc]init];
option.city = city;
option.busLineUid = uid;
BOOL flag = [_busLineSearch busLineSearch:option];
if(flag)
{
NSLog(@"busline检索发送成功 %@---%@", city, uid);
}
else
{
NSLog(@"busline检索失败");
}
}
- (void)onGetBusDetailResult:(BMKBusLineSearch *)searcher result:(BMKBusLineResult *)busLineResult errorCode:(BMKSearchErrorCode)error {
if (error == BMK_SEARCH_NO_ERROR) {
//在此处理正常结果
NSLog(@"%@,共有%zd站",busLineResult.busLineName, busLineResult.busStations.count);
}
else {
NSLog(@"抱歉,未找到Bus结果%d",error);
}
}
注意代理控制:
-(void)viewWillDisappear:(BOOL)animated
{
[_mapView viewWillDisappear];
_mapView.delegate = nil; // 不用时,置nil,否则影响内存的释放
_locService.delegate = nil;
_poiSearch.delegate = nil;
_busLineSearch.delegate = nil;
}
分别点击下面第1条,第3条,第4条,打印结果:
检索结果.PNG 公交检索结果.jpeg