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