欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  移动技术

详解iOS集成GoogleMap(定位、搜索)

程序员文章站 2023-12-19 08:01:03
简介: 最近花了些时间看了googlemap官方文件并集成到国际版app中,网上关于googlemap for ios的讲解相对android来说少一点,比较有帮助的几乎...

简介:

最近花了些时间看了googlemap官方文件并集成到国际版app中,网上关于googlemap for ios的讲解相对android来说少一点,比较有帮助的几乎全是英文文档。下面是我开发过程中遇到的坑、以及采用的解决方法。

集成googlemap步骤:

  1. 1、cocoapods导入pod 'googlemaps'
  2. 2、获取api密匙(前提是已经在googlemapsdk中创建好自己的应用)
  3. 3、配置plist文件搭建定位环境
  4. 4、调用代理方法实现需求

tips:pod 'googlemaps'、pod 'googleplaces'、pod 'googleplacepicker'这三个框架。(googlemaps:显示基本的定位功能;googleplaces:实现搜索功能,官方文档叫做地点自动完成;googleplacepicker:是实现获取某个poi的的详细信息,比如名字、详细地址、路线等)

景点(poi)包括公园、学校和*大楼,等等。 另外,如果地图类型为 kgmstypenormal,商家景点默认将显示在地图上。 商家景点表示商店、餐馆和酒店之类的商家。

按照 google places api 中的定义,一个 poi 对应于一个地点。 例如,休闲公园为景点,但喷泉之类的地点通常不属于景点(除非它们具有国家或历史意义)。

配置plist文件:

打开plist的代码源文件,输入:

详解iOS集成GoogleMap(定位、搜索)

定位:

一、在appdelegate 头文件 导入框架

#import

二、向您的 application:didfinishlaunchingwithoptions: 方法添加以下内容,使用我们刚才获取到的 api 密钥替代 your_api_key:

[gmsservices provideapikey:@"your_api_key"];

tips:这一步是在启动app的时候,googlemap准备代理工作。

三、在我们需要显示地图的控制器调用api方法

@property (nonatomic,strong) cllocationmanager *locationmanager;//地图定位对象
@property (nonatomic,strong) gmsmapview *mapview;//地图
@property (nonatomic,strong) gmsmarker *marker;//大头针
@property (nonatomic,strong) gmsplacesclient * placesclient;//可以获取某个地方的信息
//注册的代理
@interface testmapviewcontroller ()

tips:这是在控制器.h文件声明的属性。

(一)初始化一个地图对象

gmsmapview:是控制地图的外观类

gmscameraposition:是控制地图要显示的内容类

gmscameraposition *camera = [gmscameraposition camerawithlatitude:-23.12960481 longitude:113.30887721            zoom:level];
 self.mapview = [gmsmapview mapwithframe:cgrectzero camera:camera];
 self.mapview.delegate = self; //注册代理属性
 self.mapview.settings.compassbutton = yes;//显示指南针
 [self.view addsubview:self.mapview];

tips:上面的经纬度可以随便传一个,之后会获取到新的经纬度并更新位置

(二)初始化一个定位管理者对象

if (self.locationmanager == nil) {
  self.locationmanager = [[cllocationmanager alloc]init];
 }
 self.locationmanager.delegate = self;
 [self.locationmanager requestalwaysauthorization];//授权方式,如果在后台也需要定位,那就选择 requestalwaysauthorization。
 self.locationmanager.desiredaccuracy = kcllocationaccuracybest;//最精确的定位
 self.locationmanager.distancefilter = kcldistancefilternone; // 默认是kcldistancefilternone,也可以设置其他值,表示用户移动的距离小于该范围内就不会接收到通知
 [self.locationmanager startupdatinglocation];

tips:cllocationmanager 是负责获取用户行为的类,列如获取用户当前位置信息。更多详细信息请阅览cllocationmanager。里面讲解cllocationmanager的一些应用场景并有代码实例。

运行app:这时候我们会看到并没有实景地图出来,原因是:前面提到的gmscameraposition类,我们并没有在定位成功之后将定位内容赋它。

gmscameraposition类,它是负责显示定位内容的。很重要!

(三)在定位成功的api代理方法中,获取经纬度并转成影像赋值

- (void)locationmanager:(cllocationmanager *)manager didupdatelocations:(nsarray *)locations{
 cllocation *curlocation = [locations lastobject];
 // 通过location 或得到当前位置的经纬度
 cllocationcoordinate2d curcoordinate2d = curlocation.coordinate;
 gmscameraposition *camera = [gmscameraposition camerawithlatitude:curcoordinate2d.latitude longitude:curcoordinate2d.longitude zoom:level];
 cllocationcoordinate2d position2d = cllocationcoordinate2dmake(curlocation.coordinate.latitude, curlocation.coordinate.longitude);
 self.mapview.camera = camera;//这句话很重要很重要,将我们获取到的经纬度转成影像并赋值给地图的camera属性
 [self.locationmanager stopupdatinglocation];//定位成功后停止定位
}

tips:locationmanager: didupdatelocations: 代理方法是googlemap 中实现定位成功后回调的代理方法,你可以在这里获取到经纬度。

运行app:这时候地图就出来了

详解iOS集成GoogleMap(定位、搜索)

添加大头针

gmsmarker类是负责显示大头针,默认是红色,你可以自定义大头针,用图片或者改变颜色,具体看官方文档gmsmarker。

 self.marker = [gmsmarker markerwithposition:position2d];
 self.marker.map = self.mapview;

tips:position2d是在定位成功之后转换得到的cllocationcoordinate2d属性经纬度值。

小坑提示:这时候有可能会出现,定位成功之后出现多个大头针。原因是:进行定位的时候,map获取多个预测位置,从而产生生成多个大头针的现象。解决办法:在每次生成大头针之前先清除之前的那个,只生成最精准的最后一个。

[self.marker.map clear];
 self.marker.map = nil;

反编码(经纬度转成具体位置):

 clgeocoder *geocoder = [[clgeocoder alloc]init];
 //反地理编码
 [geocoder reversegeocodelocation:curlocation completionhandler:^(nsarray * _nullable placemarks, nserror * _nullable error) {
   
  if (error) {
  }else{
   
    clplacemark *placemark = [placemarks objectatindex:0];//第一个位置是最精确的
    //赋值详细地址
    dlog(@"placemark---路号name:%@-市locality:%@-区sublocality:%@-省administrativearea:%@-路thoroughfare:%@",placemark.name,placemark.locality,placemark.sublocality,placemark.administrativearea,placemark.thoroughfare);
   
  }];

这时候就已经可以获取到具体的国家、省、市、区、街道了。

补充:反编码是获取不到poi位置的(我获取不到)。这时候可以使用

self.placesclient = [gmsplacesclient sharedclient];//获取某个地点的具体信息
 [self.placesclient currentplacewithcallback:^(gmsplacelikelihoodlist *likelihoodlist, nserror *error) {
  if (error != nil) {
   dlog(@"current place error %@", [error localizeddescription]);
   return;
  }
   
//  for (gmsplacelikelihood *likelihood in likelihoodlist.likelihoods) {
//   gmsplace* place = likelihood.place;
//   nslog(@"current place name %@ at likelihood %g", place.name, likelihood.likelihood);
//   nslog(@"current place address %@", place.formattedaddress);
//   nslog(@"current place attributions %@", place.attributions);
//   nslog(@"current placeid %@", place.placeid);
//  }
   //这里就可以获取到poi的名字了
   //这里做一些你想做的事
   
 }];

点击地图并移动大头针

这里是用到gmsmapviewdelegate的代理回调

回调1:这里是点击地图上的某个点api返回的代理方法,在这个代理方法,你可以获取经纬度去反编译地址

- (void)mapview:(gmsmapview *)mapview didtapatcoordinate:(cllocationcoordinate2d)coordinate{
 //点击一次先清除上一次的大头针
 [self.marker.map clear];
 self.marker.map = nil;
 // 通过location 或得到当前位置的经纬度
 gmscameraposition *camera = [gmscameraposition camerawithlatitude:coordinate.latitude longitude:coordinate.longitude zoom:level];
 cllocationcoordinate2d position2d = cllocationcoordinate2dmake(coordinate.latitude,coordinate.longitude);
 self.mapview.camera = camera;
 //大头针
 self.marker = [gmsmarker markerwithposition:position2d];
 self.marker.map = self.mapview;
 cllocation *curlocation = [[cllocation alloc]initwithlatitude:coordinate.latitude longitude:coordinate.longitude];
  
 clgeocoder *geocoder = [[clgeocoder alloc]init];
 //反地理编码
 [geocoder reversegeocodelocation:curlocation completionhandler:^(nsarray * _nullable placemarks, nserror * _nullable error) {
   
  if (error) {
    
   dlog(@"error.description:%@",error.description);
    
  }else{
    
   clplacemark *placemark = [placemarks objectatindex:0];
    
   //赋值详细地址
   dlog(@"placemark---路号name:%@-市locality:%@-区sublocality:%@-省administrativearea:%@-路thoroughfare:%@",placemark.name,placemark.locality,placemark.sublocality,placemark.administrativearea,placemark.thoroughfare); 
 }]; 
}

回调2:这里也是点击地图上的某个点api返回的代理方法

- (void)mapview:(gmsmapview *)mapview
didtappoiwithplaceid:(nsstring *)placeid
   name:(nsstring *)name
  location:(cllocationcoordinate2d)location{
}

tips:值得注意的,两者的区别是:第二个点击代理方法是当你点击poi的时候才会回调,会返回place的name、id、经纬度;第一个代理方法是只要点击地图任意一个位置就会回调,只会返回经纬度。也就是:每一次的点击,只会执行其中一个代理方法。

搜索:

搜索功能在官方文档是叫做“自动完成”,即你输入一部分的文本,googlemap会根据你的文本预测出地点并自动填充返回,具体请看官方文档自动完成

效果如图:

详解iOS集成GoogleMap(定位、搜索)

这里你需要做的步骤跟做“定位”的一样:

(1)获取apikey

(2) 在application:didfinishlaunchingwithoptions: 注册密匙

1[gmsplacesclient provideapikey:@"your_api_key"];

(3) 创建搜索ui并调用代理方法获取api自动填充的结果数组集

小坑提示: gmsplacesclient跟gmsservices的密匙是不一样的,密匙不对的话,会出现反复调用

viewcontroller:didfailautocompletewitherror:的现象。

tips:搭建搜索ui又几种方式:1)搜索框直接创建在导航栏 2)搜索栏创建在视图顶部 3)自定义。根据你的需求用代码~

(一)这里是第一种方式(搜索框直接创建在导航栏):

gmsautocompleteviewcontroller *accontroller = [[gmsautocompleteviewcontroller alloc] init];
 accontroller.delegate = self;
 [self presentviewcontroller:accontroller animated:yes completion:nil];

tips:这里就可以直接往搜索框编辑文字,api会直接给你返回搜索结果集合

(二)调用api代理方法:

// handle the user's selection. 这是用户选择搜索中的某个地址后返回的结果回调方法
- (void)viewcontroller:(gmsautocompleteviewcontroller *)viewcontroller
didautocompletewithplace:(gmsplace *)place {
  
 [self dismissviewcontrolleranimated:yes completion:nil];
 [self.marker.map clear];
 self.marker.map = nil;
 // 通过location 或得到当前位置的经纬度
 gmscameraposition *camera = [gmscameraposition camerawithlatitude:place.coordinate.latitude longitude:place.coordinate.longitude zoom:level];
 cllocationcoordinate2d position2d = cllocationcoordinate2dmake(place.coordinate.latitude,place.coordinate.longitude);
 self.marker = [gmsmarker markerwithposition:position2d];
 self.mapview.camera = camera;
 self.marker.map = self.mapview;
  
 self.locationlabel.text = place.name;
 self.locationdetaillabel.text = place.formattedaddress;
  
}

tips:这个代理方法实现的是,当用户在搜索集中选择了在某一个结果返回地图,并定位添加大头针。

自动填充失败的回调:

- (void)viewcontroller:(gmsautocompleteviewcontroller *)viewcontroller
didfailautocompletewitherror:(nserror *)error {
 [self dismissviewcontrolleranimated:yes completion:nil];
 // todo: handle the error.
 dlog(@"error: %@", [error description]);
}

tips:自动填充失败后你可以在这里做一些事,默认是不管的。

补充:搜索栏的外观是可以自定义的,你可以设置成跟自己的app一样的风格~具体请看设置 ui 控件样式属性

到这里,搜索功能就算完成了。

上一篇:

下一篇: