query

检索关键字

宠物友好餐厅

是

region

限定搜索区域

北京市

是

region_limit

区域数据召回限制，为true时，仅召回region对应区域内数据

true/false

否

type

对query召回结果进行二次筛选，type内容建议参考POI分类内容，建议query同属于一个大类；

如query=美食 type=火锅（用于泛搜索场景）

query和type支持只填一项

火锅

否

scope

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

1、 2

否

coord_type

传入的坐标类型，1（wgs84ll即GPS经纬度），2（gcj02ll即国测局经纬度坐标），3（bd09ll即百度经纬度坐标），4（bd09mc即百度米制坐标）

1、2、3(默认)、 4

否

center

传入poi坐标，辅助检索结果按距离排序与返回

需要搭配排序字段一起使用并结合coord_type字段说明该字段的坐标类型

38.76623,116.43213

lat<纬度>,lng<经度>

否

filter

检索排序条件，包含以下3部分

industry_type：排序支持的行业类型，取值有：hotel（酒店宾馆）；cater（餐饮）；life（生活类）

sort_name：排序方式，取值有：default（默认）；price（价格）；overall_rating（评分）；distance（距离排序，需结合center字段一起使用）

sort_rule：排序规则，取值有：0（从高到低），1（从低到高）

industry_type:cater

sort_name:overall_rating

sort_rule:1

否

extensions_adcode

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

true、false

否

address_result

query传入结构化地址（如：上地十街10号），检索结果返回数据的类型。若不传入该字段，默认召回门址数据，仅当address_result=false时，召回相应的POI数据

false

否

photo_show

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

购买商用授权后可联系商务，提交工单申请开通

false, true

默认值: false

否

language

多语言检索，支持多种语言召回结果，参考语种列表，默认为中文。

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

en

否

page_num

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

0、1、2

否

page_size

单次召回POI数量，默认为10条记录，最大返回20条。取值为10-20

10

否

ret_coordtype

返回的坐标类型，可选参数，默认返回百度坐标系坐标详细说明

bd09ll、bd09mc、wgs84ll、gcj02ll

否

output

输出数据格式

json/xml

否

baidu_user_id

用户请求id，任意定义，不可超过16位字符串

输入baidu_user_id和baidu_session_id参数后，检索接口会自动关联历史搜索行为，使返回结果逐步个性化——越用越精准，成为“私人定制版搜索接口”

12345

否

baidu_session_id

百度对话id，任意定义，不可超过16位字符串

用于辨别同一轮请求，如请求该接口效果不满意，请继续使用相同的ssesion_id发起请求，后续将对第一轮的请求进行效果优化， 若对效果满意并需更多字段则可以使用相同session_id请求地点详情接口

注：与baidu_user_id配合使用，但不可和baidu_user_id相同

67891

否

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 城市类型

query_type

string

搜索类型：精搜precise/泛搜general

results

object

返回的结果

string

poi的唯一标示，ID

string

poi名称，单次请求最多返回10条结果

object

poi经纬度坐标

lat

float

纬度值

lng

float

经度值

string

poi所属省份

string

poi所属城市

string

poi所属区县

string

poi所属乡镇街道

int

poi所属乡镇街道编码

int

poi所属区域代码

string

poi所在地址

string

多维检索匹配标签

string

poi匹配置信度

1.8以上为非常满足，1.5分以上为比较满足，0.8-1.5是一般满足，0.8以下不满足

string

poi营业状态 ：

空（代表正常营业）

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

暂停营业

可能已关闭

已关闭

购买商用授权后可联系商务，提交工单申请开通

string

poi的电话

string

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

object

详细信息

classified_poi_tag

string

POI展示分类（细致分类）

navi_location

object

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

brand

string

poi对应的品牌

type

string

类型

如（hotel、cater、life），配合filter排序

new_alias

string

poi别名

price

string

poi商户的价格

photos

array

poi图片的下载链接

购买商用授权后可联系商务，提交工单申请开通

detail_url

string

poi的详情页

overall_rating

string

poi的综合评分

shop_hours

string

poi的营业时间

10:30-14:00,16:30-22:00

label

string

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

ranking

string

poi的相关榜单排名

image_num

string

poi图片数

new_alias

string

poi别名

comment_num

string

poi的评论数

indoor_floor

string

室内poi所在楼层

parent_id

string

poi父点id

children

object

poi子点

uid

string

poi子点ID，可用于poi详情检索

show_name

string

poi子点简称

name

string

poi子点名称

classified_poi_tag

string

poi子点详细分类标签

location

object

poi子点坐标

address

string

poi子点地址