场景介绍
开发者可以调用 HarmonyOS 位置相关接口,获取设备实时位置,或者最近的历史位置。
对于位置敏感的应用业务,建议获取设备实时位置信息。如果不需要设备实时位置信息,并且希望尽可能的节省耗电,开发者可以考虑获取最近的历史位置。
接口说明
获取设备的位置信息,所使用的接口说明如下。
接口名
功能描述
Locator(Context context)
创建 Locator 实例对象。
RequestParam(int scenario)
根据定位场景类型创建定位请求的 RequestParam 对象。
onLocationReport(Location location)
获取定位结果。
startLocating(RequestParam request, LocatorCallback callback)
向系统发起定位请求。
requestOnce(RequestParam request, LocatorCallback callback)
向系统发起单次定位请求。
stopLocating(LocatorCallback callback)
结束定位。
getCachedLocation()
获取系统缓存的位置信息。
开发步骤
应用在使用系统能力前,需要检查是否已经获取用户授权访问设备位置信息。如未获得授权,可以向用户申请需要的位置权限。
系统提供的定位权限有:
ohos.permission.LOCATION
ohos.permission.LOCATION_IN_BACKGROUND
访问设备