query

检索关键字

天安门、美食

是

region

检索行政区划区域（支持到区县级）

（增加区域内数据召回权重，如需严格限制召回数据在区域内，请搭配使用region_limit参数），可输入行政区划名或对应citycode

北京市海淀区

北京，海淀区

北京海淀

建议填写完整区县信息

是

ak

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

是

region_limit

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

true/false

否

is_light_version

true：轻量化检索，检索速度大幅提升，排序更简单直接；如对接口平响有要求，建议咨询技术支持进行指导切换。

false，默认：优化检索结果的排序，使返回的POI更接近百度地图App的推荐顺序，提升结果的相关性和体验；可能略微增加响应耗时，建议对结果顺序敏感但对平响要求不高的场景使用。

true/false

否

type

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

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

query和type支持只填一项

火锅

否

center

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

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

38.76623,116.43213

lat<纬度>,lng<经度>

否

scope

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

1、 2

否

coord_type

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

1、2、3(默认)、 4

否

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

否

from_language

query的语言类型，支持不同语言的检索词作为入参，不填默认为中文，可以设置为auto，大模型会自行判断入参语言，参考语种列表

auto

否

language

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

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

en，fr

否

page_num

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

0、1、2

否

page_size

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

10

否

ret_coordtype

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

gcj02ll

否

output

输出数据格式，仅支持json

json

否

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

返回的结果

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

poi营业状态 ：

空（代表正常营业）

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

暂停营业

可能已关闭

已关闭

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

string

poi的电话

string

poi所在街景图id

string

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

object

详细信息

classified_poi_tag

string

POI展示分类（细致分类）

new_alias

string

poi别名

type

string

类型

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

detail_url

string

poi的详情页

shop_hours

string

poi的营业时间

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

price

string

poi商户的价格

label

string

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

overall_rating

string

poi的综合评分

image_num

string

poi图片数

comment_num

string

poi的评论数

navi_location

object

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

brand

string

poi对应的品牌

indoor_floor

string

室内poi所在楼层

ranking

string

poi的相关榜单排名

parent_id

string

poi父点id

photos

array

poi图片的下载链接

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

best_time

string

最佳游玩时间 (如需获取以下字段，请跳转至地点详情检索)

sug_time

string

建议时长(如需获取以下字段，请跳转至地点详情检索)

description

string

描述(如需获取以下字段，请跳转至地点详情检索)

children

poi子点

uid

string

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

show_name

string

poi子点简称

name

string

poi子点名称

classified_poi_tag

string

poi子点详细分类标签

location

object

poi子点坐标

address

string

poi子点地址

d7_hot_value

int

poi近7天的热度总值

以下为高级权限，可联系商务，提交工单申请开通

view_heat

int

poi的浏览热度

arrival_heat

int

poi的到达热度

interact_heat

int

poi的互动热度

heat_trend

string

近7天热度增长（递减）XX%

query

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

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

天安门、美食

是

location

圆形区域检索中心点，不支持多个点

38.76623,116.43213 lat<纬度>,lng<经度>

是

ak

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

是

radius

圆形区域检索半径，单位为米。（增加区域内数据召回权重，如需严格限制召回数据在区域内，请搭配使用radius_limit参数），当半径过大，超过中心点所在城市边界时，会变为城市范围检索，检索范围为中心点所在城市

可以不传，默认1000

否

radius_limit

是否严格限定召回结果在设置检索半径范围内。true（是），false（否）。

true/false

否

is_light_version

true：优先保证检索速度，排序更简单直接；

false，默认：优化检索结果的排序，使返回的POI更接近百度地图App的推荐顺序，提升结果的相关性和体验；可能略微增加响应耗时，建议对结果顺序敏感但对平响要求不高的场景使用。

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

否

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

否

photo_show

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

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

false、true 默认值：false

否

from_language

query的语言类型，支持不同语言的检索词作为入参，不填默认为中文，可以设置为auto，大模型会自行判断入参语言，参考语种列表

auto

否

language

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

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

en，fr

否

page_num

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

0、1、2

否

page_size

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

10

否

ret_coordtype

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

gcj02ll

否

output

输出数据格式，仅支持json

json

否

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

返回的结果

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

poi营业状态 ：

空（代表正常营业）

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

暂停营业

可能已关闭

已关闭

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

string

poi的电话

string

poi所在街景图id

string

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

object

详细信息

classified_poi_tag

string

POI展示分类（细致分类）

distance

int32

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

new_alias

string

poi别名

type

string

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

detail_url

string

poi的详情页

shop_hours

string

poi的营业时间

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

price

string

poi商户的价格

label

string

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

overall_rating

string

poi的综合评分

image_num

string

poi图片数

comment_num

string

poi的评论数

navi_location

object

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

brand

string

poi对应的品牌

indoor_floor

string

室内poi所在楼层

ranking

string

poi的相关榜单排名

parent_id

string

poi父点id

photos

array

poi图片的下载链接

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

best_time

string

最佳游玩时间 (如需获取以下字段，请跳转至地点详情检索)

sug_time

string

建议时长(如需获取以下字段，请跳转至地点详情检索)

description

string

描述(如需获取以下字段，请跳转至地点详情检索)

children

poi子点

uid

string

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

show_name

string

poi子点简称

name

string

poi子点名称

classified_poi_tag

string

poi子点详细分类标签

location

object

poi子点坐标

address

string

poi子点地址

d7_hot_value

int

poi近7天的热度总值

以下为高级权限，可联系商务，提交工单申请开通

view_heat

int

poi的浏览热度

arrival_heat

int

poi的到达热度

interact_heat

int

poi的互动热度

heat_trend

string

近7天热度增长（递减）XX%

query

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

天安门、美食

是

bounds

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

bounds参数范围，最少2对，最大100对坐标

bounds参数在大于2对坐标时，需要首尾相连成闭合多边形

38.76623,116.43213, 40.056878,116.30815, 40.465,116.314, 40.232,116.352, 40.121,116.453, 38.76623,116.43213

是

ak

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

是

is_light_version

true：优先保证检索速度，排序更简单直接；

false，默认：优化检索结果的排序，使返回的POI更接近百度地图App的推荐顺序，提升结果的相关性和体验；可能略微增加响应耗时，建议对结果顺序敏感但对平响要求不高的场景使用。

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

否

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

否

photo_show

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

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

false、true 默认值：false

否

from_language

query的语言类型，支持不同语言的检索词作为入参，不填默认为中文，可以设置为auto，大模型会自行判断入参语言，参考参考语种列表

auto

否

language

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

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

en，fr

否

page_num

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

0、1、2

否

page_size

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

10

否

ret_coordtype

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

gcj02ll

否

output

输出数据格式，仅支持json

json

否

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

返回的结果

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

poi营业状态 ：

空（代表正常营业）

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

暂停营业

可能已关闭

已关闭

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

string

poi的电话

string

poi所在街景图id

string

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

object

详细信息

classified_poi_tag

string

POI展示分类（细致分类）

distance

int32

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

type

string

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

detail_url

string

poi的详情页

shop_hours

string

poi的营业时间

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

price

string

poi商户的价格

label

string

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

overall_rating

string

poi的综合评分

image_num

string

poi图片数

new_alias

string

poi别名

comment_num

string

poi的评论数

navi_location

object

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

brand

string

poi对应的品牌

indoor_floor

string

室内poi所在楼层

ranking

string

poi的相关榜单排名

parent_id

string

poi父点id

photos

array

poi图片的下载链接

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

best_time

string

最佳游玩时间 (如需获取以下字段，请跳转至地点详情检索)

sug_time

string

建议时长(如需获取以下字段，请跳转至地点详情检索)

description

string

描述(如需获取以下字段，请跳转至地点详情检索)

children

poi子点

uid

string

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

show_name

string

poi子点简称

name

string

poi子点名称

classified_poi_tag

string

poi子点详细分类标签

location

object

poi子点坐标

address

string

poi子点地址

d7_hot_value

int

poi近7天的热度总值

以下为高级权限，可联系商务，提交工单申请开通

view_heat

int

poi的浏览热度

arrival_heat

int

poi的到达热度

interact_heat

int

poi的互动热度

heat_trend

string

近7天热度增长（递减）XX%

uid

poi的uid

8ee4560cf91d160e6cc02cd7

必须提供一项

uids

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

8ee4560cf91d160e6cc02cd7,5ffb1816cf771a226f476058

ak

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

是

scope

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

1、2

否

extensions_adcode

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

true、false

否

photo_show

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

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

false、true 默认值：false

否

ret_coordtype

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

gcj02ll

否

language

多语言检索，支持多种语言召回结果，参考语种列表

指定输入参数和召回参数结果的语言类型，可支持的语言类型为多种语言，不填默认为中文。

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

en，fr

否

output

输出数据格式，仅支持json

json

否

status

int

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

message

string

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

results

返回的结果

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

poi营业状态 ：

空（代表正常营业）

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

暂停营业

可能已关闭

已关闭

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

string

poi的电话

string

poi所在街景图id

string

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

object

详细信息

tag

string

poi分类标签

classified_poi_tag

string

POI展示分类（细致分类）

type

string

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

detail_url

string

poi的详情页

shop_hours

string

poi的营业时间10:30-14:00,16:30-22:00

price

string

poi商户的价格

overall_rating

string

poi的综合评分

image_num

string

poi图片数

comment_num

string

poi的评论数

navi_location

object

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

brand

string

poi对应的品牌

indoor_floor

string

室内poi所在楼层

ranking

string

poi的相关榜单排名

parent_id

string

poi父点id

photos

array

poi图片的下载链接

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

best_time

string

最佳游玩时间

sug_time

string

建议时长

description

string

描述

children

string

poi子点

uid

string

poi子点ID

std_tag

string

poi子点分类标签

name

string

poi子点名称

show_name

string

poi子点简称

location

object

poi子点坐标

distance

int

poi子点与主点的距离（若无distance返回，则说明该子点在主点内）

pv_rate

string

poi子点的热度（X%选择）

content_info

string

poi子点内容标签

classified_poi_tag

string

poi子点详细分类标签

query

输入建议关键字（支持拼音）

上地、天安、中关、shanghai

是

region

检索行政区划区域（仅支持到市级）

region 检索行政区划区域（仅支持到市级） （增加区域内数据召回权重，如需严格限制召回数据在区域内，请搭配使用region_limit参数），可输入行政区划名或对应citycode

北京市

是

ak

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

是

region_limit

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

true/false

否

location

传入location参数后，是综合各种相关性排序的，location参数只是其中一个因素，但不会严格按距离排序决定最终的排序

40.047857537164,116.31353434477

否

radius

圆形区域检索半径，单位为米。

当半径过大，超过中心点所在城市边界时，会变为城市范围检索，检索范围为中心点所在城市

默认1000

否

bounds

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

bounds参数范围，最少2对，最大100对坐标

bounds参数在大于2对坐标时，需要首尾相连成闭合多边形

38.76623,116.43213,

40.056878,116.30815,

40.465,116.314,

40.232,116.352,

40.121,116.453,

38.76623,116.43213

否

coord_type

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

1、2、3(默认)、4

否

extensions_adcode

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

true、false

否

language

多语言检索，支持多种语言召回结果，参考语种列表

指定输入参数和召回参数结果的语言类型，可支持的语言类型为多种语言，不填默认为中文。

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

en，fr

否

ret_coordtype

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

gcj02ll

否

output

输出数据格式，仅支持json

json

否

status

int

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

message

string

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

results

返回的结果

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

poi分类

string

POI展示分类（细致分类）

string

poi所在地址

poi子点

uid

string

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

std_tag

string

poi子点分类标签

show_name

string

poi子点简称

location

object

poi子点坐标

distance

int

poi子点与主点的距离（若无distance返回，则说明该子点在主点内）

pv_rate

string

poi子点的热度（XX%选择）

content_info

string

poi子点内容标签

classified_poi_tag

string

poi子点详细分类标签