推荐上车点-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产品时遇到问题,请先参考提供的相关资料.如仍未解决,请与我们联系.您可以通过下列途径获得满意答复: 在线支持:https://lbs.amap.com/