AMapLocationClient

java.lang.Object
- com.amap.api.location.AMapLocationClient

```
public class AMapLocationClient
extends java.lang.Object
```
定位服务类。此类提供单次定位、持续定位、最后位置相关功能。
Location service class. This class provides single location, continuous location, and last location related functions.

从以下版本开始:

2.0.0

版本:

2.0.0

作者:

liqi

构造器概要

构造器
构造器和说明
`AMapLocationClient(android.content.Context context)` 构造方法 constructor method
`AMapLocationClient(android.content.Context context, android.content.Intent intent)` 自定义service定位实例 Custom service location instance
`AMapLocationClient(android.os.Looper looper, android.content.Context context)` 指定looper Specify looper

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`void`	`addLogCallback(ILogCallback callback)` 添加日志回调
`void`	`addSatelliteListener(IGnssSatelliteListenerDelegate listener)` 设置卫星监听
`void`	`addSensorListener(ISensorListenerDelegate listener)` 设置传感器监听
`void`	`disableBackgroundLocation(boolean removeNotification)` 关闭后台定位功能与`enableBackgroundLocation(int, Notification)`配对使用注意:关闭后台定位功能只是代表不再提供后台定位的能力，并不是停止定位，停止定位请调用`stopLocation()`。
`void`	`enableBackgroundLocation(int notificationId, android.app.Notification notification)` 开启后台定位功能注意: 如果您设置了target>=28,需要增加android.permission.FOREGROUND_SERVICE权限, 如果您的app需要运行在Android Q版本的手机上，需要为ApsService增加android:foregroundServiceType="location"属性，例：<service android:name="com.amap.api.location.APSService" android:foregroundServiceType="location"/> 主要是为了解决Android 8.0以上版本对后台定位的限制，开启后会显示通知栏,如果您的应用本身已经存在一个前台服务通知，则无需再开启此接口注意:启动后台定位只是代表开启了后台定位的能力，并不代表已经开始定位，开始定位请调用`startLocation()`。
`static java.lang.String`	`getDeviceId(android.content.Context context)` 获取设备号 Get device ID
`AMapLocation`	`getLastKnownLocation()` 获取最后位置 Get last location
`void`	`getReGeoLocation(AMapLocation location)` 获取带有逆地理信息的定位 Get location with reverse geolocation information
`java.lang.String`	`getVersion()` 获取定位sdk版本信息 Get location SDK version information
`static boolean`	`isHttpDnsEnabled()` 返回进程级共享 HTTPDNS 是否已开启。
`boolean`	`isLocationDim()`
`boolean`	`isStarted()` 本地定位服务是否已经启动，用于用户检查服务是否已经启动 Whether the local location service has been started, used for the user to check if the service has been started
`void`	`notifyAppEnterForeBack(boolean foreground)` 应用前后台变化时，通知SDK。
`void`	`notifyEventChanged(int scene, int action, long pNum1, long pNum2, java.lang.String pStr)` 事件变化通知
`void`	`notifySceneChanged(int scene)` 通知定位场景改变，相关定位策略会发生变化优化定位策略，定位更准
`void`	`onDestroy()` 销毁定位,释放定位资源, 当不再需要进行定位时调用此方法该方法会释放所有定位资源，调用后再进行定位需要重新实例化AMapLocationClient Destroy location, release location resources, call this method when location is no longer needed This method will release all location resources, and re-instantiate AMapLocationClient is required for further location after calling
`void`	`removeLogCallback(ILogCallback callback)` 移除日志回调
`void`	`removeSatelliteListener(IGnssSatelliteListenerDelegate listener)` 移除卫星监听
`void`	`removeSensorListener(ISensorListenerDelegate listener)` 移除传感器监听
`void`	`sendFeedback()` 日志反馈
`static void`	`setApiKey(java.lang.String apiKey)` 设置apikey 必须在AmapLocationClient实例化之前调用 Set apikey Must be called before AmapLocationClient instantiation
`static void`	`setHost(java.lang.String host)` 设置host 可以让sdk中所有请求都执行设置的地址，其中真实host存放在Header中设置空表示关闭 Setting host allows all requests in the SDK to execute the set address, with the real host stored in the Header Setting empty means close
`static boolean`	`setHttpDnsEnabled(boolean enabled)` 设置是否启用 HTTPDNS，默认关闭。
`void`	`setLocationListener(AMapLocationListener listener)` 设置定位回调监听 Set location callback listener
`void`	`setLocationOption(AMapLocationClientOption option)` 设置定位参数 Set location parameters
`void`	`setReGeoLocationCallback(IReGeoLocationCallback callback)` 设置获取逆地理信息的定位监听回调 Set the location listener callback for obtaining reverse geolocation information
`void`	`startAssistantLocation(android.webkit.WebView webView)` 启动H5辅助定位只适用于Android 4.2及以后版本该接口只用于配合Web JS API的H5辅助定位，开启后并没有开始定位，开始定位由JS API触发。
`void`	`startAssistantLocation(android.webkit.WebView webView, AMapLocationClientOption option)` 启动H5辅助定位，并配置SDK对传入WebView的WebSettings处理。
`void`	`startLocation()` 开始定位 Start location
`void`	`stopAssistantLocation()` 停止辅助定位如果已经调用了startAssistantLocation接口，在destroy时请调用该接口 Stop assistant location If the startAssistantLocation interface has been called, please call this interface at destroy
`void`	`stopLocation()` 停止定位 Stop location
`void`	`unRegisterLocationListener(AMapLocationListener listener)` 移除定位监听 Remove location listener
`static void`	`updateCountryCode(java.lang.String countryCode)` 设置国家/地区码，用于基础库统一的区域策略（如逆地理语言、服务节点选择等）。
`static void`	`updatePrivacyAgree(android.content.Context context, boolean isAgree)` 设置是否同意用户授权政策必须在AmapLocationClient实例化之前调用 Set whether to agree to the user authorization policy Must be called before AmapLocationClient instantiation
`static void`	`updatePrivacyShow(android.content.Context context, boolean isContains, boolean isShow)` 设置包含隐私政策，并展示用户授权弹窗必须在AmapLocationClient实例化之前调用 Set the privacy policy and display the user authorization popup Must be called before AmapLocationClient instantiation

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - AMapLocationClient
```
public AMapLocationClient(android.content.Context context)
                   throws java.lang.Exception
```
    构造方法
    constructor method
    
    参数:
    
    context - Android上下文
    Android Context
    
    抛出:
    
    java.lang.Exception
    
    从以下版本开始:
    
    2.0.0
  - AMapLocationClient
```
public AMapLocationClient(android.content.Context context,
                          android.content.Intent intent)
                   throws java.lang.Exception
```
    自定义service定位实例
    Custom service location instance
    
    参数:
    
    context -
    
    intent -
    
    抛出:
    
    java.lang.Exception
    
    从以下版本开始:
    
    2.3
  - AMapLocationClient
```
public AMapLocationClient(android.os.Looper looper,
                          android.content.Context context)
                   throws java.lang.Exception
```
    指定looper
    Specify looper
    
    参数:
    
    looper -
    
    context -
    
    抛出:
    
    java.lang.Exception
    
    从以下版本开始:
    
    5.0.0
- 方法详细资料
  - setLocationOption
```
public void setLocationOption(AMapLocationClientOption option)
```
    设置定位参数
    Set location parameters
    
    参数:
    
    option - 定位参数
    Location parameters
    
    从以下版本开始:
    
    2.0.0
  - notifyEventChanged
```
public void notifyEventChanged(int scene,
                               int action,
                               long pNum1,
                               long pNum2,
                               java.lang.String pStr)
```
    事件变化通知
    
    参数:
    
    scene - 场景名称参考com.amap.location.sdk.api.define.LocationEvent.Scene
    
    action - 场景的具体动作参考com.amap.location.sdk.api.define.LocationEvent.Action
    
    pNum1 -
    
    pNum2 -
    
    pStr -
  - addSensorListener
```
public void addSensorListener(ISensorListenerDelegate listener)
```
    设置传感器监听
    
    参数:
    
    listener -
  - removeSensorListener
```
public void removeSensorListener(ISensorListenerDelegate listener)
```
    移除传感器监听
    
    参数:
    
    listener -
  - addSatelliteListener
```
public void addSatelliteListener(IGnssSatelliteListenerDelegate listener)
```
    设置卫星监听
    
    参数:
    
    listener -
  - removeSatelliteListener
```
public void removeSatelliteListener(IGnssSatelliteListenerDelegate listener)
```
    移除卫星监听
    
    参数:
    
    listener -
  - addLogCallback
```
public void addLogCallback(ILogCallback callback)
```
    添加日志回调
    
    参数:
    
    callback - 日志回调
  - removeLogCallback
```
public void removeLogCallback(ILogCallback callback)
```
    移除日志回调
    
    参数:
    
    callback - 日志回调
  - setLocationListener
```
public void setLocationListener(AMapLocationListener listener)
```
    设置定位回调监听
    Set location callback listener
    
    参数:
    
    listener - 定位完成后的回调接口
    Callback interface after location is completed
    
    从以下版本开始:
    
    2.0.0
  - startLocation
```
public void startLocation()
```
    开始定位
    Start location
    
    从以下版本开始:
    
    2.0.0
  - stopLocation
```
public void stopLocation()
```
    停止定位
    Stop location
    
    从以下版本开始:
    
    2.0.0
  - getLastKnownLocation
```
public AMapLocation getLastKnownLocation()
```
    获取最后位置
    Get last location
    
    返回:
    
    最后一次定位的位置信息
    Location information of the last location
    
    从以下版本开始:
    
    2.0.0
  - notifyAppEnterForeBack
```
public void notifyAppEnterForeBack(boolean foreground)
```
    应用前后台变化时，通知SDK。在前后台切换这个阶段会做一些动态策略，优化定位策略，定位更准。
    
    参数:
    
    foreground -
  - notifySceneChanged
```
public void notifySceneChanged(int scene)
```
    通知定位场景改变，相关定位策略会发生变化优化定位策略，定位更准
    
    参数:
    
    scene -
  - sendFeedback
```
public void sendFeedback()
```
    日志反馈
  - isLocationDim
```
public boolean isLocationDim()
```
  - startAssistantLocation
```
public void startAssistantLocation(android.webkit.WebView webView)
```
    启动H5辅助定位
  - 只适用于Android 4.2及以后版本
  - 该接口只用于配合Web JS API的H5辅助定位，开启后并没有开始定位，开始定位由JS API触发。
  - 建议在WebView控件初始化之后就调用该接口，尽量不要在WebView执行loadUrl之后调用
  - Only applicable to Android 4.2 and later versions
  - This interface is only used for H5 assistant location in conjunction with Web JS API. After opening, it does not start location, and the location is triggered by JS API.
  - It is recommended to call this interface after the WebView control is initialized, and try not to call it after WebView executes loadUrl

参数:: webView - 自定义的webView
Custom webView
从以下版本开始:: 3.8.0

startAssistantLocation

public void startAssistantLocation(android.webkit.WebView webView,
                                   AMapLocationClientOption option)

启动H5辅助定位，并配置SDK对传入WebView的WebSettings处理。

只适用于Android 4.2及以后版本
当option中关闭H5 JavaScript时，不会注册H5 JS bridge，H5辅助定位JS API不可用，H5页面无法通过JS触发定位。
默认配置保持与startAssistantLocation(WebView)一致。
该接口只影响本次传入的WebView，不影响普通定位流程，也不会全局修改业务方其他WebView。

Only applicable to Android 4.2 and later versions
When H5 JavaScript is disabled in option, the H5 JS bridge will not be registered, the H5 assistant location JS API is unavailable, and H5 pages cannot trigger location through JS.
The default option is compatible with startAssistantLocation(WebView).
This API only affects the WebView passed in this call. It does not affect normal location flows or globally modify other app WebViews.

类 AMapLocationClient

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

AMapLocationClient

AMapLocationClient

AMapLocationClient

方法详细资料

setLocationOption

notifyEventChanged

addSensorListener

removeSensorListener

addSatelliteListener

removeSatelliteListener

addLogCallback

removeLogCallback

setLocationListener

startLocation

stopLocation

getLastKnownLocation

notifyAppEnterForeBack

notifySceneChanged

sendFeedback

isLocationDim

startAssistantLocation

startAssistantLocation

stopAssistantLocation

getVersion

updatePrivacyShow

updateCountryCode

setHttpDnsEnabled

isHttpDnsEnabled

updatePrivacyAgree

setApiKey

isStarted

unRegisterLocationListener

setReGeoLocationCallback

getReGeoLocation

onDestroy

enableBackgroundLocation

disableBackgroundLocation

getDeviceId

setHost