LocationClientOptions class
Constructors
-
LocationClientOptions({bool isMockEnable = true, num interval = 2000, bool isOnceLocation = false, bool isNeedAddress = true, bool isWifiScan = true, LocationMode locationMode = LocationMode.Battery_Saving, LocationProtocol locationProtocol = LocationProtocol.HTTP, bool isKillProcess = false, bool isGpsFirst = false, num httpTimeOut = 30000, bool isOffset = true, bool isLocationCacheEnable = true, bool isOnceLocationLatest = false, bool isSensorEnable = false, num lastLocationLifeCycle = 30000, GeoLanguage geoLanguage = GeoLanguage.ZH, bool? isDownloadCoordinateConvertLibrary, num deviceModeDistanceFilter = 0.0, AMapLocationPurpose? locationPurpose, bool isOpenAlwaysScanWifi = true, num scanWifiInterval = 30000, num distanceFilter = 0, bool pausesLocationUpdatesAutomatically = false, bool allowsBackgroundLocationUpdates = false, num locationTimeout = 3000, num reGeocodeTimeout = 3000, bool locatingWithReGeocode = false, Set? monitoredRegions, bool detectRiskOfFakeLocation = false})
-
Properties
-
allowsBackgroundLocationUpdates
→ bool
-
是否允许后台定位。默认为NO。只在iOS 9.0及之后起作用。
iOS
设置为YES的时候必须保证 Background Modes 中的 Location updates 处于选中状态，否则会抛出异常。
由于iOS系统限制，需要在定位未开始之前或定位停止之后，修改该属性的值才会有效果。
final
-
detectRiskOfFakeLocation
→ bool
-
检测是否存在虚拟定位风险，默认为NO，不检测。
iOS
注意:设置为YES时，单次定位通过 AMapLocatingCompletionBlock 的error给出虚拟定位风险提示；
连续定位通过 amapLocationManager:didFailWithError: 方法的error给出虚拟定位风险提示。
error格式为 error.domain==AMapLocationErrorDomain; error.code==AMapLocationErrorRiskOfFakeLocation;
附带的error的详细信息参考 error.localizedDescription 中的描述以及 error.userInfo 中的信息(error.userInfo.AMapLocationRiskyLocateResult 表示有虚拟风险的定位结果;
error.userInfo.AMapLocationAccessoryInfo 表示外接辅助设备信息)。
final
-
deviceModeDistanceFilter
→ num
-
final
-
distanceFilter
→ num
-
设定定位的最小更新距离。单位米，默认为 kCLDistanceFilterNone，
iOS
表示只要检测到设备位置发生变化就会更新位置信息。
final
-
geoLanguage
→ GeoLanguage
-
逆地理信息的语言,目前之中中文和英文
Android, iOS
final
-
hashCode
→ int
-
The hash code for this object.
no setterinherited
-
httpTimeOut
→ num
-
联网超时时间 单位：毫秒 默认值：30000毫秒
Android
final
-
interval
→ num
-
发起定位请求的时间间隔 默认值：2000毫秒
Android
final
-
isDownloadCoordinateConvertLibrary
→ bool?
-
final
-
isGpsFirst
→ bool
-
高精度模式下单次定位是否优先返回卫星定位信息
Android
默认值：false
只有在单次定位高精度定位模式下有效
为true时，会等待卫星定位结果返回，最多等待30秒，若30秒后仍无卫星定位结果返回，返回网络定位结果
final
-
isKillProcess
→ bool
-
退出时是否杀死进程
Android
默认值:false, 不杀死
注意：如果设置为true，并且配置的service不是remote的则会杀死当前页面进程，请慎重使用
final
-
isLocationCacheEnable
→ bool
-
是否使用缓存策略, 默认为true 使用缓存策略
Android
final
-
isMockEnable
→ bool
-
是否允许模拟位置
Android
从3.4.0开始，默认值为true，允许模拟;
3.4.0之前的版本，默认值为false，不允许模拟
final
-
isNeedAddress
→ bool
-
是否需要地址信息
Android
默认值：true 返回地址信息
2.9.0之前的版本定位类型为AMapLocation.LOCATION_TYPE_GPS时不会返回地址信息
自2.9.0版本开始，当类型为AMapLocation.LOCATION_TYPE_GPS时也可以返回地址信息(需要网络通畅，第一次有可能没有地址信息返回）
final
-
isOffset
→ bool
-
final
-
isOnceLocation
→ bool
-
是否单次单次定位
Android, iOS
默认值：false
final
-
isOnceLocationLatest
→ bool
-
定位是否等待WIFI列表刷新 定位精度会更高，但是定位速度会变慢1-3秒 从3.7.0版本开始，
Android
支持连续定位（连续定位时首次会等待刷新） 3.7.0之前的版本，仅适用于单次定位，当设置为true时，连续定位会自动变为单次定位,
final
-
isOpenAlwaysScanWifi
→ bool
-
是否开启始终wifi扫描 只有设置了android.permission.WRITE_SECURE_SETTINGS权限后才会开启
Android
开启后，即使关闭wifi开关的情况下也会扫描wifi 默认值为：true, 开启wifi始终扫描
final
-
isSensorEnable
→ bool
-
final
-
isWifiScan
→ bool
-
是否允许主动调用WIFI刷新
Android
final
-
lastLocationLifeCycle
→ num
-
final
-
locatingWithReGeocode
→ bool
-
连续定位是否返回逆地理信息，默认NO。
iOS
final
-
locationMode
→ LocationMode
-
定位模式 默认值：Hight_Accuracy 高精度模式
Android, iOS
final
-
locationProtocol
→ LocationProtocol
-
定位协议 默认值：HTTP http协议
Android
final
-
locationPurpose
→ AMapLocationPurpose?
-
定位场景
Android
final
-
locationTimeout
→ num
-
指定单次定位超时时间,默认为10s。最小值是2s。注意单次定位请求前设置。
iOS
注意: 单次定位超时时间从确定了定位权限(非kCLAuthorizationStatusNotDetermined状态)后开始计算。
final
-
monitoredRegions
→ Set?
-
获取被监控的region集合。
iOS暂不支持
final
-
pausesLocationUpdatesAutomatically
→ bool
-
指定定位是否会被系统自动暂停。默认为NO。
iOS
final
-
reGeocodeTimeout
→ num
-
指定单次定位逆地理超时时间,默认为5s。最小值是2s。注意单次定位请求前设置。
iOS
final
-
runtimeType
→ Type
-
A representation of the runtime type of the object.
no setterinherited
-
scanWifiInterval
→ num
-
final
