query

检索关键字。圆形区域检索和多边形区域内检索支持多个关键字并集检索，不同关键字间以$符号分隔，最多支持10个关键字检索。如:银行$酒店

如果需要按POI分类进行检索，请将分类通过query参数进行设置，如query=美食

天安门

string(45)

是

bounds

检索多边形区域。需传入多个坐标对集合，坐标对用','分割，首尾坐标对需相同。多边形为矩形时，可传入左下右上两顶点坐标对。

38.76623,116.43213,

40.056878,116.30815,

40.465,116.314,

40.232,116.352,

40.121,116.453,

38.76623,116.43213

string(50)

是

ak

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

string(50)

是

tag

检索分类偏好，与query组合进行检索，多个分类以","分隔 （POI分类），如果需要严格按分类检索，请通过query参数设置

美食

string(50)

否

extensions_adcode

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

true、false

string(50)

否

scope

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

1、2

string(50)

否

output

输出格式为json或者xml

json或xml

string(50)

否

filter

检索过滤条件。当scope取值为2时，可以设置filter进行排序。industry_type：行业类型，注意：设置该字段可提高检索速度和过滤精度，取值有： hotel（宾馆）；cater（餐饮）；life（生活娱乐） sort_name：排序字段，根据industry_type字段的值而定。 1、industry_type为hotel时，sort_name取值有： default（默认）；price（价格）；total_score（好评）；level（星级）；health_score（卫生）；distance（距离排序，需结合center字段一起使用） 2、industry_type为cater时，sort_name取值有： default（默认）；taste_rating（口味）；price（价格）；overall_rating（好评）；service_rating（服务）；distance（距离排序，需结合center字段一起使用） 3、industry_type为life时，sort_name取值有： default（默认）；price（价格）；overall_rating（好评）；comment_num（服务）；distance（距离排序，需结合center字段一起使用）sort_rule：排序规则：0（从高到低），1（从低到高）price_section：价格区间groupon：是否有团购：1（有），0（无）discount：是否有打折：1（有），0（无）

sort_rule:1

string(50)

否

coord_type

传入的坐标类型，1（wgs84ll即GPS经纬度），2（gcj02ll即国测局经纬度坐标），3（bd09ll即百度经纬度坐标），4（bd09mc即百度米制坐标）注："ll为小写LL"坐标详细说明

1、2、3(默认)、4

int

否

ret_coordtype

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

gcj02ll

string(50)

否

page_size

单次召回POI数量，默认为10条记录，最大返回20条。多关键字检索时，返回的记录数为关键字个数*page_size。

10

int

否

page_num

分页页码，默认为0,0代表第一页，1代表第二页，以此类推。常与page_size搭配使用，仅当返回结果为poi时可以翻页。

0、1、2

int

否

sn

开发者的权限签名。sn校验说明

string(50)

可选，若开发者所用AK的校验方式为SN校验时该参数必须。

timestamp

设置sn后该值必填。

string(50)

设置sn后该值必填。

photo_show

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

true、false

bool

否

language

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

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

en

string(50)

否

status

Int

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

message

string

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

total

int

POI检索总数，开发者请求中设置了page_num字段才会出现total字段。出于数据保护目的，单次请求total最多为150。

result_type

string

region_type  行政区划类型;address_type 结构化地址类型;poi_type poi类型;city_type 城市类型

results

返回的结果

string

poi名称

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字段不同。

classified_poi_tag

string

POI展示分类（细致分类）

distance

int32

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

type

string

所属分类，如hotel、cater。

tag

string

标签

label

string

标签细分解释，比如停车场标签（地上停车场/地下停车场），知名景区标签（几A级景区），酒店标签（什么类型酒店）等

navi_location

object

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

lng

float

导航引导点经度

lat

float

导航引导点纬度

alias

array

poi别名

detail_url

string

poi的详情页

children

poi子点数据，若某poi无子点，该字段为空

uid

string

poi子点的唯一标示，可用于详情检索

name

string

poi子点名称

show_name

string

poi子点简要名称

tag

string

poi子点类别

location

object

poi子点坐标 {"lat":39.911318,"lng":116.402284}, // lat poi子点纬度 , lng poi子点经度

address

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图片的下载链接。注意：该功能为高级付费功能，您可提交工单咨询。