uid

poi的uid

‘8ee4560cf91d160e6cc02cd7’

无

string

是

scope

检索结果详细程度。取值为1 或空，则返回基本信息；取值为2，返回检索POI详细信息

1、2

1

string(50)

否

ak

开发者的访问密钥，必填项。v2之前该属性为key。

您的ak

无

string(50)

是

uids

uid的集合，最多可以传入10个uid，多个uid之间用英文逗号分隔。

‘8ee4560cf91d160e6cc02cd7’,

‘5ffb1816cf771a226f476058’

无

string

否

extensions_adcode

是否召回国标行政区划编码，true（召回）、false（不召回）

true、false

false

string(50)

否

output

请求返回格式

json或xml

xml

string(50)

否

ret_coordtype

返回的坐标类型，可选参数，添加后POI返回国测局经纬度坐标坐标详细说明

gcj02ll

bd09ll

string(50)

否

sn

开发者的权限签名。

sn生成方法

无

string(50)

否

timestamp

设置sn后该值必填。

无

string(50)

否

photo_show

是否输出图片信息：true(输出) 、false(不输出)

true、false

无

bool

否

language

en

指定输入参数和召回参数的语言类型，可支持的语言类型为英文

注意：该功能为高级付费功能，您可提交工单咨询

string(50)

否

status

Int

本次API访问状态，如果成功返回0，如果失败返回其他数字。（见服务状态码）

message

string

对API访问状态值的英文说明，如果成功返回ok，并返回结果字段，如果失败返回错误说明。

result

返回的结果

string

poi名称

string

当返回结果为城市列表时，result_type=city_type

当返回结果为普通poi时，result_type=poi_type

当返回结果为行政区划数据时，result_type=region_type

当返回结果为门址数据时，result_type=address_type

object

poi经纬度坐标

lat

float

纬度值

lng

float

经度值

string

poi地址信息

string

所属省份

string

所属城市

string

所属区县

int

行政区划代码

string

poi电话信息

string

poi的唯一标识，可用于详情检索

string

POI的状态：

空（代表正常营业）

推算位置（代表开放/营业/办公状态可能有变化）

暂停营业

可能已关闭

已关闭

注意：该功能为高级付费功能，您可提交工单咨询

string

街景图id

string

是否有详情页：1有，0没有

object

poi的扩展信息，仅当scope=2时，显示该字段，不同的poi类型，显示的detail_info字段不同。

distance

int32

距离中心点的距离，圆形区域检索时返回

type

string

所属分类，如hotel、cater。

tag

string

标签

classified_poi_tag

string

POI展示分类（细致分类）

navi_location

object

POI对应的导航引导点坐标。大型面状POI的导航引导点，一般为各类出入口，方便结合导航、路线规划等服务使用

lng

float

导航引导点经度

lat

float

导航引导点纬度

alias

string

poi别名

detail_url

string

poi的详情页

price

string

poi商户的价格

shop_hours

string

营业时间

overall_rating

string

总体评分

taste_rating

string

口味评分

service_rating

string

服务评分

environment_rating

string

环境评分

facility_rating

string

星级（设备）评分

hygiene_rating

string

卫生评分

technology_rating

string

技术评分

image_num

string

图片数

groupon_num

int

团购数

discount_num

int

优惠数

comment_num

string

评论数

favorite_num

string

收藏数

checkin_num

string

签到数

brand

string

poi对应的品牌（如加油站中的『中石油』、『中石化』）

content_tag

string

poi标签信息

photos

array

poi图片的下载链接。注意：该功能为高级付费功能，您可提交工单咨询。

0

正常

服务请求正常召回

1

服务器内部错误

该服务响应超时或系统内部错误，请留下联系方式

2

请求参数非法

必要参数拼写错误或漏传（如query和tag请求中均未传入）

3

权限校验失败

4

配额校验失败

服务当日调用次数已超限，请前往API控制台提升（请优先进行）开发者认证

5

ak不存在或者非法

未传入ak参数；ak已被删除（可前往回收站恢复）；

8

数据解析失败

一般是query输入有误导致，如query输入特殊字符，全角符号。

9

高级权限校验失败

101

AK参数不存在

请求消息没有携带AK参数

200

APP不存在，AK有误请检查再重试

根据请求的ak，找不到对应的APP

201

APP被用户自己禁用，请在控制台解禁

202

APP被管理员删除

恶意APP被管理员删除

203

APP类型错误

当前API控制台支持Server(类型1), Mobile(类型2, 新版控制台区分为Mobile_Android(类型21)及Mobile_IPhone（类型22））及Browser（类型3），除此之外其他类型认为是APP类型错误

210

APP IP校验失败

在申请SERVER类型应用的时候选择IP校验，需要填写IP白名单，如果当前请求的IP地址不在IP白名单或者不是0.0.0.0/0就认为IP校验失败

211

APP SN校验失败

SERVER类型APP有两种校验方式IP校验和SN校验，当用户请求的SN和服务端计算出来的SN不相等的时候提示SN校验失败

240

APP 服务被禁用

用户在API控制台中创建或设置某APP的时候禁用了某项服务，若需开通权限，可进入API控制台为AK勾选对应服务

250

用户不存在

根据请求的user_id, 数据库中找不到该用户的信息，请携带正确的user_id

251

用户被自己删除

该用户处于未激活状态

252

用户被管理员删除

恶意用户被加入黑名单

260

服务不存在

服务器解析不到用户请求的服务名称

261

服务被禁用

该服务已下线

302

天配额超限，限制访问

配额超限，如果想增加配额请联系我们

401

当前并发量已经超过约定并发配额，限制访问

并发控制超限，请控制并发量或联系我们