展示附近车辆-Android 最后更新时间: 2021年01月22日

接入使用

获取key

1.创建新应用

进入控制台，创建一个新应用。如果您之前已经创建过应用，可直接跳过这个步骤.

2.添加新key

在创建的应用上点击"添加新Key"按钮，在弹出的对话框中，依次输入应用名名称，选择绑定的服务为“Android平台SDK”，输入发布版安全码 SHA1、调试版安全码 SHA1、以及 Package，如下图所示：

需要注意的是： 1个KEY只能用于一个应用（多渠道安装包属于多个应用），1个Key在多个应用上使用会出现服务调用失败.

在阅读完高德地图API服务条款后，勾选此选项，点击“提交”，完成 Key 的申请，此时您可以在所创建的应用下面看到刚申请的 Key 了.

3.开通权限

需要联系高德对应接口人开通附近运力权限.

4.配置key

在AndroidManifest.xml 的 application 标签下加入如下内容：

XML

<meta-data android:name="com.amap.api.v2.apikey" android:value="key">
//开发者申请的key  
</meta-data>

集成SDK包

1.添加库文件

拷贝jar+so到工程libs文件夹下：

2.gradle配置

配置so路径，打开build.gradle，找到 sourceSets 标签，在里面添加如下配置：

XML

main {
    jniLibs.srcDirs = ['libs']
}

快速接入

1.创建NearCar

XML

获取NearCar对象
INearCar nearCar = NearCar.getInstance();

2.查询附近车辆及展示

1）初始化配置

XML

//设置车辆类型、起点名称及坐标
NearCarRequest request = new NearCarRequest(INearCar.CAR_TYPE_ALL, "首开广场", latLng);
//设置车辆图标
request.setCarImage(BitmapDescriptorFactory.fromResource(R.drawable.car));
//设置显示半径，单位：公里（支持范围：最小值2， 数字需为2的倍数。最大值20）
request.setRadius(10);
//设置返回车辆最大个数
request.setMaxCount(20);

2）查询及显示

XML

//查询及展示
nearCar.showNearCars(context, mAMap, request);

运行效果：

3.销毁

XML

//释放资源
nearCar.release();

高级功能

功能1: 同时请求多种车辆类型

构造方法（同时请求多种类型）

XML

/**
 * @param carTypes     指定车辆类型列表，注：最多只支持同时请求20种车辆类型
 *                      0：所有分类
 *                      1：出租车
 *                      2：新能源
 *                      3：舒适型
 *                      4：豪华型
 *                      5：商务型
 * @param startName     起点名称。如:xx小区南门
 * @param startPosition 起点坐标
 * @since 1.1.0
 */
public NearCarRequest(int[] carTypes, String startName, LatLng startPosition)

功能2: 设置车辆图标

设置车辆图标

XML

/**
 * 设置车辆图标资源
 * @param bitmapDescriptor
 */
public void setCarImage(BitmapDescriptor bitmapDescriptor)

获取设置的车辆图标

XML

/**
 * 获取设置的车辆图标
 * @return
 */
public BitmapDescriptor getCarImage()

功能3: 设置车辆显示半径

设置显示半径

XML

/**
 * 显示半径，单位：公里
 * 支持范围：最小值2， 数字需为2的倍数。最大值20
 * @param radius
 */
public void setRadius(int radius)

获取显示半径

XML

/**
 * 获取显示半径
 * @return
 */
public int getRadius()

功能4: 设置车辆显示最大数量

设置返回的最大车辆个数

XML

/**
 * 返回最大车辆数
 * @param maxCount
 */
public void setMaxCount(int maxCount)

获取返回的最大车辆个数

XML

/**
 * 获取返回最大车辆数
 * @return
 */
public int getMaxCount()