开发 云图服务API 参考手册 附近API

附近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

用户访问过于频繁,服务不响应

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