com.amap.api.services.route

## 类 DistanceSearch

- java.lang.Object
- - com.amap.api.services.route.DistanceSearch

-     public class DistanceSearch
      extends java.lang.Object

  距离测量，通过两点计算直线距离或者驾车导航距离，相比路径规划返回内容较少，适合频繁调用场景。
  从以下版本开始:
    6.1.0

- - ### 嵌套类概要

    嵌套类
    限定符和类型 | 类和说明
    --- | ---
    `static class` | `DistanceSearch.DistanceQuery` 距离测量属性设置类，其中包含起终点以及测量类型的设置。
    `static interface` | `DistanceSearch.OnDistanceSearchListener` 距离测量异步请求回调。

  - ### 字段概要

    字段
    限定符和类型 | 字段和说明
    --- | ---
    `static java.lang.String` | `EXTENSIONS_ALL` 扩展字段all，会返回完整参数
    `static java.lang.String` | `EXTENSIONS_BASE` 扩展字段base，会返回部分参数
    `static int` | `TYPE_DISTANCE` 距离测量方法：直线距离
    `static int` | `TYPE_DRIVING_DISTANCE` 距离测量方法：驾车导航距离（仅支持国内坐标） 会考虑路况，在不同时间请求返回结果可能不同。
    `static int` | `TYPE_WALK_DISTANCE` 距离测量方法：步行导航距离（仅支持国内坐标）

  - ### 构造器概要

    构造器
    构造器和说明
    `DistanceSearch(Context context)` 距离测量搜索的构造函数

  - ### 方法概要

    所有方法 实例方法 具体方法
    限定符和类型 | 方法和说明
    --- | ---
    `DistanceResult` | `calculateRouteDistance(DistanceSearch.DistanceQuery query)` 测量距离请求接口，调用后会发起距离测量请求。
    `void` | `calculateRouteDistanceAsyn(DistanceSearch.DistanceQuery query)` 测量距离请求接口，调用后会发起距离测量请求。
    `void` | `setDistanceSearchListener(DistanceSearch.OnDistanceSearchListener listener)` 设置距离测量异步请求监听回调

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

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

- - ### 字段详细资料

    - #### TYPE_DISTANCE

          public static final int TYPE_DISTANCE

      距离测量方法：直线距离
      从以下版本开始:
        6.1.0
      另请参阅:
        常量字段值

    - #### TYPE_DRIVING_DISTANCE

          public static final int TYPE_DRIVING_DISTANCE

      距离测量方法：驾车导航距离（仅支持国内坐标）
      会考虑路况，在不同时间请求返回结果可能不同。
      此策略和driving接口的 strategy=4 策略一致
      从以下版本开始:
        6.1.0
      另请参阅:
        常量字段值

    - #### TYPE_WALK_DISTANCE

          public static final int TYPE_WALK_DISTANCE

      距离测量方法：步行导航距离（仅支持国内坐标）
      从以下版本开始:
        6.1.0
      另请参阅:
        常量字段值

    - #### EXTENSIONS_ALL

          public static final java.lang.String EXTENSIONS_ALL

      扩展字段all，会返回完整参数
      从以下版本开始:
        7.6.0
      另请参阅:
        常量字段值

    - #### EXTENSIONS_BASE

          public static final java.lang.String EXTENSIONS_BASE

      扩展字段base，会返回部分参数
      从以下版本开始:
        7.6.0
      另请参阅:
        常量字段值

  - ### 构造器详细资料

    - #### DistanceSearch

          public DistanceSearch(Context context)
                         throws AMapException

      距离测量搜索的构造函数
      参数:
        `context` - 上下文
      抛出:
        `AMapException`
      从以下版本开始:
        6.1.0

  - ### 方法详细资料

    - #### setDistanceSearchListener

          public void setDistanceSearchListener(DistanceSearch.OnDistanceSearchListener listener)

      设置距离测量异步请求监听回调
      参数:
        `listener` - 监听回到实现
      从以下版本开始:
        6.1.0

    - #### calculateRouteDistance

          public DistanceResult calculateRouteDistance(DistanceSearch.DistanceQuery query)
                                                throws AMapException

      测量距离请求接口，调用后会发起距离测量请求。 该接口为同步接口，由于带有网络操作需要在子线程中调用。
      参数:
        `query` - 请求参数
      返回:
        距离测量结果
      抛出:
        `AMapException`
      从以下版本开始:
        6.1.0

    - #### calculateRouteDistanceAsyn

          public void calculateRouteDistanceAsyn(DistanceSearch.DistanceQuery query)

      测量距离请求接口，调用后会发起距离测量请求。 该接口为异步接口，请求结果会在`DistanceSearch.OnDistanceSearchListener`中进行回调。
      参数:
        `query` - 请求参数
      从以下版本开始:
        6.1.0