com.amap.api.track

## 类 AMapTrackClient

- java.lang.Object
- - com.amap.api.track.AMapTrackClient

-     public final class AMapTrackClient
      extends java.lang.Object

  猎鹰sdk服务类，提供轨迹上报控制、查询上报轨迹信息功能。
  从以下版本开始:
    1.0

- - ### 构造器概要

    构造器
    构造器和说明
    `AMapTrackClient(android.content.Context context)` 构造函数 应该将Application作为Context传入

  - ### 方法概要

    所有方法 静态方法 实例方法 具体方法
    限定符和类型 | 方法和说明
    --- | ---
    `void` | `addTerminal(AddTerminalRequest addTerminalRequest, OnTrackListener listener)` 创建terminal
    `void` | `addTrack(AddTrackRequest addTrackRequest, OnTrackListener listener)` 增加轨迹
    `long` | `getTrackId()` 获得当前设置的轨迹id 该方法只有在已经启动轨迹服务后才会生效
    `static java.lang.String` | `getVersion()` 获得版本号
    `void` | `queryDistance(DistanceRequest request, OnTrackListener listener)` 查询里程
    `void` | `queryHistoryTrack(HistoryTrackRequest request, OnTrackListener listener)` 查询历史轨迹
    `void` | `queryLatestPoint(LatestPointRequest request, OnTrackListener listener)` 查询最新轨迹点
    `void` | `queryTerminal(QueryTerminalRequest queryTerminalRequest, OnTrackListener listener)` 查询terminal
    `void` | `queryTerminalTrack(QueryTrackRequest request, OnTrackListener listener)` 查询终端下的轨迹
    `void` | `setCacheSize(int cacheSize)` 设置缓存大小, 单位MB。
    `void` | `setInterval(int gatherInterval, int packInterval)` 设置采集和打包位置数据的时间间隔 该接口既可以在开启轨迹服务前调用，也可以在开启轨迹服务后调用。
    `void` | `setLocationMode(int locationMode)` 设置定位模式。
    `void` | `setOnCustomAttributeListener(OnCustomAttributeListener customAttributeListener)` 设置自定义属性监听器 该接口既可以在开启轨迹服务前调用，也可以在开启轨迹服务后调用。
    `void` | `setOnTrackListener(OnTrackLifecycleListener trackListener)` 设置轨迹服务监听器 该接口必须在开启轨迹服务后调用才会生效
    `void` | `setProtocolType(int protocolType)` 设置协议类型（http、https），默认为https 该接口既可以在开启轨迹服务前调用，也可以在开启轨迹服务后调用。
    `void` | `setTrackId(long trackId)` 设置轨迹id。
    `void` | `startGather(OnTrackLifecycleListener trackListener)` 开启轨迹采集
    `void` | `startTrack(TrackParam mTrackParam, OnTrackLifecycleListener trackListener)` 开启轨迹服务 在开启轨迹服务前，需要初始化Track，并在AndroidManifest.xml文件中配置API_KEY(AK)。
    `void` | `stopGather(OnTrackLifecycleListener trackListener)` 停止轨迹采集
    `void` | `stopTrack(TrackParam mTrackParam, OnTrackLifecycleListener trackListener)` 停止轨迹服务

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

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### 构造器详细资料

    - #### AMapTrackClient

          public AMapTrackClient(android.content.Context context)

      构造函数 应该将Application作为Context传入
      参数:
        `context` - 该参数应该传入Application Context
      从以下版本开始:
        1.0

  - ### 方法详细资料

    - #### getVersion

          public static java.lang.String getVersion()

      获得版本号
      返回:
        版本号
      从以下版本开始:
        1.0

    - #### setCacheSize

          public void setCacheSize(int cacheSize)

      设置缓存大小, 单位MB。默认为50MB 该接口既可以在开启轨迹服务前调用，也可以在开启轨迹服务后调用。
      参数:
        `cacheSize` - 缓存大小，单位为MB
      从以下版本开始:
        1.0

    - #### setInterval

          public void setInterval(int gatherInterval,
                                  int packInterval)

      设置采集和打包位置数据的时间间隔 该接口既可以在开启轨迹服务前调用，也可以在开启轨迹服务后调用。
      参数:
        `gatherInterval` - 采集时间间隔 , 单位为s, 范围为1s~60s , 在定位周期大于15s时，SDK会将定位周期设置为5的倍数
        `packInterval` - 打包时间间隔 , 单位为s, 范围为采集时间*5~采集时间*50，为采集时间的整数倍
      从以下版本开始:
        1.0

    - #### setLocationMode

          public void setLocationMode(int locationMode)

      设置定位模式。默认为高精度定位模式 高精度定位模式：在这种定位模式下，将同时使用高德网络定位和GPS定位,优先返回精度高的定位 低功耗定位模式：在这种模式下，将只使用高德网络定位 仅设备定位模式：在这种模式下，将只使用GPS定位。 该接口既可以在开启轨迹服务前调用，也可以在开启轨迹服务后调用。
      参数:
        `locationMode` - 定位模式，取值参考`LocationMode`
      从以下版本开始:
        1.0

    - #### setOnCustomAttributeListener

          public void setOnCustomAttributeListener(OnCustomAttributeListener customAttributeListener)

      设置自定义属性监听器 该接口既可以在开启轨迹服务前调用，也可以在开启轨迹服务后调用。
      参数:
        `customAttributeListener` - 自定义属性监听器，每个轨迹点都会使用由该listener返回的自定义属性进行上报
      从以下版本开始:
        1.1.0

    - #### setOnTrackListener

          public void setOnTrackListener(OnTrackLifecycleListener trackListener)

      设置轨迹服务监听器 该接口必须在开启轨迹服务后调用才会生效
      参数:
        `trackListener` - 轨迹服务监听器，监听服务的绑定和启停、采集启停事件
      从以下版本开始:
        1.0

    - #### setProtocolType

          public void setProtocolType(int protocolType)

      设置协议类型（http、https），默认为https 该接口既可以在开启轨迹服务前调用，也可以在开启轨迹服务后调用。
      参数:
        `protocolType` - 协议类型，取值参考`ProtocolType`
      从以下版本开始:
        1.0

    - #### startGather

          public void startGather(OnTrackLifecycleListener trackListener)

      开启轨迹采集
      参数:
        `trackListener` - 开启轨迹采集的结果监听listener
      从以下版本开始:
        1.0

    - #### startTrack

          public void startTrack(TrackParam mTrackParam,
                                 OnTrackLifecycleListener trackListener)

      开启轨迹服务 在开启轨迹服务前，需要初始化Track，并在AndroidManifest.xml文件中配置API_KEY(AK)。
      参数:
        `mTrackParam` - 轨迹采集的配置信息
        `trackListener` - 开启轨迹服务的结果监听listener
      从以下版本开始:
        1.0

    - #### setTrackId

          public void setTrackId(long trackId)

      设置轨迹id。如果要上报散点，则将trackId置为-1 该方法只有在已经启动轨迹服务后才会生效
      参数:
        `trackId` - 轨迹id
      从以下版本开始:
        1.0

    - #### getTrackId

          public long getTrackId()

      获得当前设置的轨迹id 该方法只有在已经启动轨迹服务后才会生效
      从以下版本开始:
        1.0

    - #### stopGather

          public void stopGather(OnTrackLifecycleListener trackListener)

      停止轨迹采集
      参数:
        `trackListener` - 停止结果监听器
      从以下版本开始:
        1.0

    - #### stopTrack

          public void stopTrack(TrackParam mTrackParam,
                                OnTrackLifecycleListener trackListener)

      停止轨迹服务
      参数:
        `mTrackParam` - 和开启时传入的track参数一致
        `trackListener` - 停止结果监听器
      从以下版本开始:
        1.0

    - #### queryTerminal

          public void queryTerminal(QueryTerminalRequest queryTerminalRequest,
                                    OnTrackListener listener)

      查询terminal
      参数:
        `queryTerminalRequest` - 查询请求
        `listener` - 查询结果监听器
      从以下版本开始:
        1.0

    - #### addTerminal

          public void addTerminal(AddTerminalRequest addTerminalRequest,
                                  OnTrackListener listener)

      创建terminal
      参数:
        `addTerminalRequest` - 创建请求
        `listener` - 请求结果监听器
      从以下版本开始:
        1.0

    - #### queryDistance

          public void queryDistance(DistanceRequest request,
                                    OnTrackListener listener)

      查询里程
      参数:
        `request` - 查询请求
        `listener` - 请求结果监听器
      从以下版本开始:
        1.0

    - #### queryLatestPoint

          public void queryLatestPoint(LatestPointRequest request,
                                       OnTrackListener listener)

      查询最新轨迹点
      参数:
        `request` - 查询请求
        `listener` - 请求结果监听器
      从以下版本开始:
        1.0

    - #### queryHistoryTrack

          public void queryHistoryTrack(HistoryTrackRequest request,
                                        OnTrackListener listener)

      查询历史轨迹
      参数:
        `request` - 查询请求
        `listener` - 请求结果监听器
      从以下版本开始:
        1.0

    - #### queryTerminalTrack

          public void queryTerminalTrack(QueryTrackRequest request,
                                         OnTrackListener listener)

      查询终端下的轨迹
      参数:
        `request` - 查询请求
        `listener` - 请求结果监听器
      从以下版本开始:
        1.0

    - #### addTrack

          public void addTrack(AddTrackRequest addTrackRequest,
                               OnTrackListener listener)

      增加轨迹
      参数:
        `addTrackRequest` - 增加轨迹请求
        `listener` - 请求结果监听器
      从以下版本开始:
        1.0