iOS定位SDK提供的单次定位方法基于苹果定位核心,苹果定位核心会在设备移动时连续返回定位结果,高德在此基础上封装了单次定位。当设备可以正常联网时,还可以返回该定位点的对应的中国境内位置信息(包括:省、市、区/县以及详细地址)。

第 1 步,引入头文件

在调用定位功能的类中引入AMapFoundationKit.h和AMapLocationKit.h这两个头文件,注意Swift需要在桥接文件中引入头文件:

#import

#import

//在桥接文件中引入头文件

#import

#import

第 2 步,配置Key

在调用定位时,需要添加Key,需要注意的是请在 SDK 任何类的初始化以及方法调用之前设置正确的 Key。

如果您使用的是定位SDK v2.x版本需要引入基础 SDK AMapLocationKit.framework ,设置apiKey的方式如下:

iOS 定位SDK v2.x版本设置 Key:

[AMapServices sharedServices].apiKey =@"您的key";

AMapServices.shared().apiKey = "您的key"

如果您使用的是定位SDK v1.x版本,请您尽快更新。

iOS 定位SDK v1.x版本设置 Key:

[AMapLocationServices sharedServices].apiKey =@"您的key";

AMapLocationServices.shared().apiKey = "您的key"

第 3 步,设置期望定位精度

由于苹果系统的首次定位结果为粗定位,其可能无法满足需要高精度定位的场景。

所以,高德提供了 kCLLocationAccuracyBest 参数,设置该参数可以获取到精度在10m左右的定位结果,但是相应的需要付出比较长的时间(10s左右),越高的精度需要持续定位时间越长。

推荐:kCLLocationAccuracyHundredMeters,一次还不错的定位,偏差在百米左右,超时时间设置在2s-3s左右即可。

// 带逆地理信息的一次定位(返回坐标和地址信息)

[self.locationManager setDesiredAccuracy:kCLLocationAccuracyHundredMeters];

// 定位超时时间,最低2s,此处设置为2s

self.locationManager.locationTimeout =2;

// 逆地理请求超时时间,最低2s,此处设置为2s

self.locationManager.reGeocodeTimeout = 2;

locationManager.desiredAccuracy = kCLLocationAccuracyHundredMeters

locationManager.locationTimeout = 2

locationManager.reGeocodeTimeout = 2

高精度:kCLLocationAccuracyBest,可以获取精度很高的一次定位,偏差在十米左右,超时时间请设置到10s,如果到达10s时没有获取到足够精度的定位结果,会回调当前精度最高的结果。

// 带逆地理信息的一次定位(返回坐标和地址信息)

[self.locationManager setDesiredAccuracy:kCLLocationAccuracyBest];

// 定位超时时间,最低2s,此处设置为10s

self.locationManager.locationTimeout =10;

// 逆地理请求超时时间,最低2s,此处设置为10s

self.locationManager.reGeocodeTimeout = 10;

locationManager.desiredAccuracy = kCLLocationAccuracyBest

locationManager.locationTimeout = 10

locationManager.reGeocodeTimeout = 10

其余精度阈值您可以通过查看参考手册得到。

第 4 步,请求定位并拿到结果

调用 AMapLocationManager 的 requestLocationWithReGeocode:completionBlock: 方法,请求一次定位。

您可以选择在一次定位时是否返回地址信息(需要联网)。以下是请求带逆地理信息的一次定位,代码如下:

// 带逆地理(返回坐标和地址信息)。将下面代码中的 YES 改成 NO ,则不会返回地址信息。

[self.locationManager requestLocationWithReGeocode:YES completionBlock:^(CLLocation *location, AMapLocationReGeocode *regeocode, NSError *error) {

if (error)

{

NSLog(@"locError:{%ld - %@};", (long)error.code, error.localizedDescription);

if (error.code == AMapLocationErrorLocateFailed)

{

return;

}

}

NSLog(@"location:%@", location);

if (regeocode)

{

NSLog(@"reGeocode:%@", regeocode);

}

}];

locationManager.requestLocation(withReGeocode: false, completionBlock: { [weak self] (location: CLLocation?, reGeocode: AMapLocationReGeocode?, error: Error?) in

if let error = error {

let error = error as NSError

if error.code == AMapLocationErrorCode.locateFailed.rawValue {

//定位错误:此时location和regeocode没有返回值,不进行annotation的添加

NSLog("定位错误:{\(error.code) - \(error.localizedDescription)};")

return

}

else if error.code == AMapLocationErrorCode.reGeocodeFailed.rawValue

|| error.code == AMapLocationErrorCode.timeOut.rawValue

|| error.code == AMapLocationErrorCode.cannotFindHost.rawValue

|| error.code == AMapLocationErrorCode.badURL.rawValue

|| error.code == AMapLocationErrorCode.notConnectedToInternet.rawValue

|| error.code == AMapLocationErrorCode.cannotConnectToHost.rawValue {

//逆地理错误:在带逆地理的单次定位中,逆地理过程可能发生错误,此时location有返回值,regeocode无返回值,进行annotation的添加

NSLog("逆地理错误:{\(error.code) - \(error.localizedDescription)};")

}

else {

//没有错误:location有返回值,regeocode是否有返回值取决于是否进行逆地理操作,进行annotation的添加

}

}

if let location = location {

NSLog("location:%@", location)

}

if let reGeocode = reGeocode {

NSLog("reGeocode:%@", reGeocode)

}

})

Logo

为开发者提供学习成长、分享交流、生态实践、资源工具等服务,帮助开发者快速成长。

更多推荐