控制台
开发 出行解决方案参考手册 客户端相关服务 行程前 推荐上车点-Android

推荐上车点-Android 最后更新时间: 2020年12月15日

RecommendSpotManager

构造方法

/**
 * 构造方法
 * @param context   上下文
 * @param aMap      AMap对象
 * @param options   配置项，用于自定义推荐上车点的字体颜色、字体大小、波纹圈颜色
 * @since 1.0.0
 *
 */
public RecommendSpotManager(Context context,  AMap aMap, RecommendSpotOptions options)

添加屏幕大头针Marker对象

/**
* 添加大头针Marker
* @param x 屏幕像素点x轴坐标。
* @param y 屏幕像素点y轴坐标。
* @param bitmapDescriptor  大头针的图片资源
* @since 1.0.0
*/
public void addCenterPin(int x, int y, BitmapDescriptor bitmapDescriptor)

设置请求推荐上车点的监听

/**
* 设置请求推荐点的监听
* @param requestRecommendSpotListener
* @since 1.0.0
*/
public void setRequestRecommendSpotListener(RequestRecommendSpotListener requestRecommendSpotListener)

 地图状态改变时调用该方法（必须实现地图的 OnCameraChangeListener监听并调用）

/**
 * 地图状态改变时的逻辑处理
 * @param cameraPosition
 * @since 1.0.0
 */
public void onCameraChange(CameraPosition cameraPosition)

 地图状态改变完成时调用该方法（必须实现地图的 OnCameraChangeListener监听并调用）

/**
* 地图状态变化完成时调用，触发获取推荐上车点
* @param position
* @since 1.0.0
*/
public void onCameraChangeFinish(final CameraPosition position)

设置吸附到推荐上车点的回调监听

/**
 * 设置吸附到推荐上车点的回调监听
 * @param attachRecommendSpotCallback
 * @since 1.0.0
 */
public void setAttachRecommendSpotCallback(AttachRecommendSpotCallback attachRecommendSpotCallback)

设置自定义大头针动画的回调监听

/**
 * 设置自定义大头针动画回调
 * @param pinMarkerAnimationCallback
 * @since 1.0.0
 */
public void setPinMarkerAnimationCallback(PinMarkerAnimationCallback pinMarkerAnimationCallback)

设置运营区域面回调监听

/**
 * 设置运营区域回调监听，当请求结果包含运营区域时触发此回调
 * @param onAreaChangedListener 运营区域面回调监听
 * @since 1.3.0
 */
public void setOnAreaChangedListener(OnAreaChangedListener onAreaChangedListener)

切换展示运营区域面

/**
 * 切换运营区域
 * @return true:切换成功，false：切换失败
 * @since 1.3.0
 */
public boolean selectArea(String areaId)

获取大头针的Marker对象

/**
 * 返回大头针的Marker对象
 * @return 大头针对象
 * @since 1.0.0
 */
public Marker getCenterPinMarker()

设置上车点显示的缩放级别

/**
 * 设置上车点显示的缩放级别，当大于该级别时才显示上车点Marker
 * @param zoomLevel
 * @since 1.0.0
 */
public void setZoomLevel(int zoomLevel)

设置请求推荐上车点数量

/**
 * 设置请求推荐上车点的个数
 * @param spotCount
 * @since 1.0.0
 */
public void setSpotCount(int spotCount)

设置推荐上车点搜索半径

/**
 * 设置推荐上车点搜索半径
 * @param radius
 * @since 1.1.0
 */
public void setRecommendSpotSearchRadius(int radius)

设置自动吸附开关

/**
 * 设置开启/关闭自动吸附，注：显示运营区域面时关闭不生效
 * @param isAutoAttachEnable 是否开启自动吸附，默认：true（开启）
 * @since 1.3.0
 */
public void setAutoAttachEnable(boolean isAutoAttachEnable)

设置吸附距离（单位：像素或米，参考 AttachDistanceUnit）

/**
 * 设置中心点吸附到推荐上车点距离
 * @param distance 距离，默认距离50
 * @param unit 单位：包含像素和米，参见{@link AttachDistanceUnit}，默认单位： 像素
 * @since 1.3.0
 */
public void setAttachDistance(int distance,int unit){

添加上车点

/**
 * 批量添加推荐上车点
 * @param spots 上车点数据
 * @since 1.2.0
 */
public synchronized void addRecommendSpots(List<RecommendSpotInfo> spots)

清除上车点Marker

/**
 * 清除上车点Marker
 * @since 1.0.0
 */
public  void clearRecommendSpots()

获取SDK版本号

/**
 * 获取当前版本号
 * @return
 * @since 1.1.0
 */
public String getVersion()

自定义上车点数据源

/**
 * 设置自定义上车点数据源
 * @param provider  上车点数据源
 * @since 1.2.0
 */
public void setRecommendSpotProvider(IRecommendSpotProvider provider)

释放资源

/**
 * 释放资源
 * @since 1.2.0
 */
public void destroy()

吸附距离单位定义

/**
 * 吸附距离单位，包括米、像素
 * @since 1.3.0
 */
public class AttachDistanceUnit{
    /**
     * 单位：像素
     */
    public final static int ATTACH_DISTANCE_UNIT_PX = 2;
    /**
     * 单位：米
     */
    public final static int ATTACH_DISTANCE_UNIT_M = 1;
}

运营区域回调监听

/**
 * 运营区域回调监听
 * @since 1.3.0
 */
public interface OnAreaChangedListener{
    /**
     * @param areas 回调运营区域列表
     * @since 1.3.0
     */
    void onAreaChanged(List<AreaInfo> areas);
}

IRecommendSpotProvider

自定义数据源

/**
 * 获取附近推荐上车点信息
 * @param center 中心点
 * @return 上车点信息列表
 * @since 1.2.0
 */
 List<RecommendSpotInfo> getRecommendSpotInfos(LatLng center)

OnRecommendSpotClickListener

上车点点击监听

/**
 * 自定义大头针开始动画方法
 * @param recommendSpotInfo 上车点信息
 * @return
 * @since 1.2.0
 */
boolean onRecommendSpotClick(RecommendSpotInfo recommendSpotInfo)

AttachRecommendSpotCallback

吸附成功

/**
 * 吸附到推荐上车点的回调方法
 * @param attachedSpot 推荐点的数据信息
 * @since 1.0.0
 */
void attachedRecommendSpot(RecommendSpotInfo attachedSpot);

吸附失败回调

/**
 * 吸附失败返回当前中心点逆地理结果
 * @param regeocodeAddress
 * @since 1.1.0
 */
void attachedRecommendSpotFailed(RegeocodeAddress regeocodeAddress)

PinMarkerAnimationCallback

/**
 * 自定义大头针开始动画方法
 * @param marker
 * @param position
 * @return  true  为 实现自定义   false  未实现动画
 * @since 1.0.0
 */
boolean handleAnimation(Marker marker, LatLng position);

RequestRecommendSpotListener

/**
 * 请求失败的回调
 * @param errorCode     错误码
 * @param errorMessage  错误信息
 * @since 1.0.0
 */
void onError(int errorCode, String errorMessage);

AreaInfo运营区域信息

获取运营区域id

/**
 * 获取运营区域id
 * @return
 */
public String getId()

获取运营区域名称

/**
 * 获取运营区域名称
 * @return
 */
public String getName()

RecommendSpotOptions

/**
 * 设置波纹圈颜色
 * @param color
 * @return
 * @since 1.0.0
 */
public RecommendSpotOptions breatheCircleColor(int color)
/**
 * 设置推荐点的字体颜色
 * @param color
 * @return
 * @since 1.0.0
 */
public RecommendSpotOptions textColor(int color)
/**
 * 设置推荐点的字体大小
 * @param size
 * @return
 * @since 1.0.0
 */
public RecommendSpotOptions textSize(float size)
/**
 * 设置推荐圆点的半径，注：1.3.0，推荐圆点只支持图片格式
 * @param radius
 * @return
 * @since 1.0.0
 * @deprecated
 */
public RecommendSpotOptions circleRadius(int radius)
/**
 * 设置呼吸波纹动画圆最大半径
 * @param radius
 * @return
 * @since 1.2.0
 */
public RecommendSpotOptions maxBreatheCircleRadius(int radius)
/**
 * 设置吸附动画圆最大半径
 * @param radius
 * @return
 * @since 1.2.0
 */
public RecommendSpotOptions maxAttachCircleRadius(int radius)
/**
 * 设置吸附圆点图标
 * @param dotIcon
 * @return
 * @since 1.2.0
 */
public RecommendSpotOptions dotIcon(BitmapDescriptor dotIcon)
/**
 * 设置运营区域面显示样式
 * @return
 * @since 1.3.0
 */
public RecommendSpotOptions areaStyle(AreaStyle areaStyle)
/**
 * 设置运营区域面是否显示
 * @param isAreaVisible
 * @return
 * @since 1.3.0
 */
public RecommendSpotOptions areaVisible(boolean isAreaVisible)

AreaStyle 运营区域面显示样式

设置填充色

/**
 * 设置区域填充色
 * @param fillColor
 * @since 1.3.0
 */
public void setFillColor(int fillColor)

设置边框色

/**
 * 设置区域边框色
 * @param strokeColor
 * @since 1.3.0
 */
public void setStrokeColor(int strokeColor)

设置边框宽度

/**
 * 设置区域边框线宽
 * @param strokeWidth
 */
public void setStrokeWidth(int strokeWidth)

错误码说明

 序号 

 errcode 

 errmsg 

 状态描述 

 问题排查策略 

1

 10000 

 OK 

 请求正常 

 请求正常 

2

 10001 

 INVALID_USER_KEY 

 key不正确或过期 

 发起请求时，传入的key不正确或者过期 

3

 10002 

 SERVICE_NOT_AVAILABL E,Solution URL "http://lbs.a map.com/api/webservice/inf o/" 

 没有权限使用相应 的服 务或者请求 接口的路径 拼写 错误 

 

1.没有权限使用相应的服务，例如：申请了WEB定位功能的key，却使用该key访问逆地理编码功能时，就会返回该错误。反之亦然

2.请求接口的路径拼写错误

4

 10003 

 DAILY_QUERY_OVER_LIMI T,Solution URL "http://lbs.am ap.com/api/webservice/info/" 

 访问已超出日访问 量 

 日访问量超限，被系统自动封停，第二天0:0 0会自动解封

5

 10004 

 ACCESS_TOO_FREQUEN T,Solution URL"http://lbs.am ap.com/api/webservice/info/" 

 单位时间内访问过 于频 繁 

 单位时间内（1分钟）访问量超限，被系统 自 动封停，下一分钟自动解封。 

6

 10005 

 INVALID_USER_IP 

 IP白名单出错，发 送请求的服务器IP 不在IP白名单内 

 在LBS官网控制台设置的IP白名单不正确。 白名单中未添加对应服务器的出口IP。可 到"控制台>配置"中设定IP白名单

7

 10006 

 INVALID_USER_DOMAIN 

 绑定域名无效 

 为Key绑定的域名无效，需要在官网控制台 重 新设置 

8

 10007 

 INVALID_USER_SIGNATURE

 数字签名未通过验 证 

 数字签名未通过。在key控制台中，开启 了"数字签名"功 能，但没有按照指定算法生 成"数字签名

9

 10008 

 INVALID_USER_SCODE 

 MD5安全码未通过 验证 

 需要判定key绑定的SHA1,package是否与sd k包里的一致 

10

 10009 

 USERKEY_PLAT_NOMATCH 

 请求key与绑定平 台不 符 

 请求中使用的key与绑定平台不符，例如： 申 请的是JS A PI的key，却用来调Web服务 接口 

11

 10010 

 IP_QUERY_OVER_LIMIT,So lution URL "http://lbs.amap.c om/api/webservice/info/" 

 IP访问超限 

 未设定IP白名单的开发者使用Key发起请 求， 从单个IP向 服务器发送的请求次数超 出限 制，被系统自动封停

12

 10011 

 NOT_SUPPORT_HTTPS 

 服务不支持https请 求 

 服务不支持https请求，如果需要申请支持， 请提交工单联系我们 

13

 10012 

 INSUFFICIENT_PRIVILEGE S 

 权限不足，服务请 求被 拒绝 

 由于不具备请求该服务的权限，所以服务被 拒绝

14

 

 10013

 USER_KEY_RECYCLED 

 Key被删除 

 Key被删除后无法正常使用 

15

 10014 

 QPS_HAS_EXCEEDED_TH E_LIMIT 

 QPS超限 

 QPS超出限制，超出部分的请求被拒绝。限 流阈值内的请求依旧会正常返回 

16

 

 10015

 GATEWAY_TIMEOUT 

 受单机QPS限流限 制 

 受单机QPS限流限制时出现该问题，建议降 低请求的QPS或在控制台提工单联系我们 

17

 10016 

 SERVER_IS_BUSY 

 服务器负载过高 

 服务器负载过高，请稍后再试 

18

 10017

 RESOURCE_UNAVAILABLE

 

所请求的资源不可用

 所请求的资源不可用 

19

 20000 

 INVALID_PARAMS 

 请求参数非法 

 请求参数的值没有按照规范要求填写。例 如，某参数值域范围为[1,3],开发者误填 了"4" 

20

 20001 

 MISSING_REQUIRED_PAR AMS

 缺少必填参数 

 缺少接口中要求的必填参数 

21

 20002 

 ILLEGAL_REQUEST 

 请求协议非法 

 请求协议非法 

22

 20003 

 UNKNOWN_ERROR 

 其他未知错误 

 其他未知错误 

23

 300** 

 ENGINE_RESPONSE_DAT A_ERRO R 

 服务响应失败

 出现3开头的错误码，建议先检查传入参数 是否正确，若无法解决，请详细描述错误复 现信息，提工单给我们 

 

客户支持

如果您在使用高德地图API产品时遇到问题，请先参考提供的相关资料.如仍未解决，请与我们联系.您可以通过下列途径获得满意答复： 在线支持：http://lbs.amap.com/

本页目录
返回顶部 示例中心 常见问题 智能客服 公众号
二维码