附近API 最后更新时间: 2021年01月22日
本接口的使用，需在您的APP中引用 Android SDK(v2.6.0及以上版本）/iOS SDK（v3.0.0及以上版本）完成实时位置上报，请先详细参看《附近派单开发指南》。
附近检索接口
检索1个中心点，周边一定公里范围内（直线距离或者导航距离最大10公里），一定时间范围内（最大24小时）上传过用户位置信息的用户，返回用户标识，经纬度，距离中心点距离。
请求地址：
https://yuntuapi.amap.com/nearby/around?Parameters 服务协议：HTTP/GET。
Parameters表示：必填参数和可选参数。 所有参数均使用&进行分隔。
- 请求参数
参数名 | 含义 | 规则说明 | 参数类型 | 是否必须 | 缺省值 | |
|---|---|---|---|---|---|---|
key | 请求服务权限标识 | 用户申请Web服务API，且完成注册附近KEY | string(32) | 必填 | 无 | |
center | 中心点坐标 | 规则： lon,lat（经度,维度）， “,”分割，如117.500244, 40.417801 经纬度小数点不超过6位 | string | 必填 | 无 | |
radius | 查询半径 | 取值范围(1,10000]，单位：米，超出取值范围按照10公里返回 | 可选 | 1000 | ||
limit | 返回结果的条数 | 取值范围 (1,100] | 可选 | 30 | ||
searchtype | 搜索radius(半径）值代表的类型 | 0：直线距离（默认），1：驾车行驶距离 | 可选 | 0 | ||
timerange | 检索时间范围的描述 | 规则：[5,86400]，单位：秒 可检索5s~24小时之内上传过数据的用户信息 超过24小时未上传过数据的用户将作为过期数据，无法返回 | 可选 | 1800 | ||
sig | 数字签名 | string(280) | 可选，选择数字签名认证的用户必填 | 无 | ||
- 返回结果参数说明
状态码
info内容 | 说明 | |
|---|---|---|
OK | 正常 | |
INVALID_USERID | 找不到对应的useid信息,请检查您提供的useid是否存在； | |
KEY_NOT_BIND | App key未开通“附近”功能，请注册附近KEY | |
INVALID_USER_KEY | 用户KEY非法或过期 | |
INVALID_USER_IP | 用户IP无效 | |
INVALID_PAPAMS | 请求参数非法 | |
INVALID_UESR_HTTPS | 不支持HTTPS请求 | |
INVALID_USER_SIGNATURE | 数字签名无效 | |
INVALID_USER_SCode | 安全码未通过 | |
OVER_QUOTA | 请求超出配额 | |
SERVICE_NOT_EXIST | 请求服务不存在 | |
SERVICE_RESPONSE_ERROR | 请求服务响应错误 | |
USER_VISIT_TOO_FREQUENTLY | 用户访问过于频繁，服务不响应 | |
