参数名称 | 参数含义 | 示例 | 必选 |
|---|
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 | 否 |
