景点查询

正常 NEW

中国 A 级景区与景点 POI 查询。

协议：HTTP 格式：JSON 版本：v1.0.0日调用量：1593次

¥ 0.004 / 次

按次计费

购买次数包更优惠，低至 0.0032 元/次

100次调用包 100 次调用 ¥0.0040 /次

500次调用包 500 次调用 ¥0.0038 /次省 5%

1000次调用包 1,000 次调用 ¥0.0036 /次省 10%

推荐 5000次调用包 5,000 次调用 ¥0.0034 /次省 15%

热门 10000次调用包 10,000 次调用 ¥0.0032 /次省 20%

健康检查

服务存活探测

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/scenic/ping JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.version	string	数据版本
data.time	string	数据时间
data.datasets	object	数据集说明
data.datasets.spot	string	景区数据说明
data.datasets.poi	string	景点 POI 数据说明
data.batch_limit	integer	批量查询允许的最大条数

请求示例

返回示例

{"msg":"success","code":200,"data":{"time":"2026-10-22 14:43:28","version":"1.0","datasets":{"poi":"旅游景点 POI (高德采集)","spot":"中国A级景区 (1A-5A)"},"batch_limit":10}}

景区等级列表

返回 A 级景区等级列表

返回 A 级景区等级列表，仅包含合法的 1A-5A 等级（已清洗脏值）。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/scenic/grades JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].grade	string	评级
data.list[].grade_level	integer	等级数字（1-5）

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"grade":"5A","grade_level":5},{"grade":"4A","grade_level":4},{"grade":"3A","grade_level":3}],"total":5}}

景区地区列表

返回景区地区列表

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/scenic/regions JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].region	string	地区

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"region":"山东"},{"region":"浙江"},{"region":"四川"}],"total":51}}

景区字段列表

返回景区可查询字段

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/scenic/fields JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].field	string	字段名
data.list[].label	string	标签
data.list[].brief	boolean	是否属于精简字段

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"brief":true,"field":"id","label":"ID"},{"brief":true,"field":"name","label":"景区名称"},{"brief":true,"field":"region","label":"所属地区"}],"total":9}}

景区查询

查询 A 级景区

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/scenic/query JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
keyword	string	是	关键词
limit	integer	否	返回条数，默认 10，最大 20；超出范围按边界值处理
brief	boolean	否	精简模式
fields	string	否	返回字段白名单，空格分隔，最多 30 个；超出 30 个截断，单字段超 64 字符忽略

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].name	string	名称
data.list[].region	string	地区
data.list[].grade	string	评级
data.list[].grade_level	integer	等级数字（1-5）
data.list[].lng_bd	string	经度（BD-09 坐标系）
data.list[].lat_bd	string	纬度（BD-09 坐标系）
data.list[].lng_wgs84	string	经度（WGS84 坐标系）
data.list[].lat_wgs84	string	纬度（WGS84 坐标系）
data.total	integer	总条数
data.mode	string	查询匹配模式
data.error	string	服务暂不可用时的错误标识（如 db_unavailable），正常时不返回

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":4392,"name":"黄山景区","grade":"5A","lat_bd":"30.1303900","lng_bd":"118.1680894","region":"安徽","lat_wgs84":"30.1269161","lng_wgs84":"118.1562316","grade_level":5},{"id":4408,"name":"黄山虎林园","grade":"4A","lat_bd":"30.2475649","lng_bd":"118.1640670","region":"安徽","lat_wgs84":"30.2441431","lng_wgs84":"118.1521747","grade_level":4},{"id":4396,"name":"东黄山度假区","grade":"4A","lat_bd":"30.1568298","lng_bd":"118.3031003","region":"安徽","lat_wgs84":"30.1531536","lng_wgs84":"118.2914389","grade_level":4}],"mode":"like","total":4}}

景区搜索

搜索 A 级景区

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/scenic/search JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
keyword	string	是	关键词
limit	integer	否	返回条数，默认 20，最大 20；超出范围按边界值处理
brief	boolean	否	精简模式
fields	string	否	返回字段白名单，空格分隔，最多 30 个；超出 30 个截断，单字段超 64 字符忽略
grade	string	否	按等级过滤（如 5A）
region	string	否	按地区过滤（如北京）

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].name	string	名称
data.list[].region	string	地区
data.list[].grade	string	评级
data.list[].grade_level	integer	等级数字（1-5）
data.list[].lng_bd	string	经度（BD-09 坐标系）
data.list[].lat_bd	string	纬度（BD-09 坐标系）
data.list[].lng_wgs84	string	经度（WGS84 坐标系）
data.list[].lat_wgs84	string	纬度（WGS84 坐标系）
data.list[].relevance	number	相关度评分（越大越相关）
data.total	integer	总条数
data.mode	string	查询匹配模式
data.error	string	服务暂不可用时的错误标识（如 db_unavailable），正常时不返回

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":4392,"name":"黄山景区","grade":"5A","lat_bd":"30.1303900","lng_bd":"118.1680894","region":"安徽","lat_wgs84":"30.1269161","lng_wgs84":"118.1562316","relevance":12.070938110351562,"grade_level":5},{"id":4396,"name":"东黄山度假区","grade":"4A","lat_bd":"30.1568298","lng_bd":"118.3031003","region":"安徽","lat_wgs84":"30.1531536","lng_wgs84":"118.2914389","relevance":12.070938110351562,"grade_level":4},{"id":4408,"name":"黄山虎林园","grade":"4A","lat_bd":"30.2475649","lng_bd":"118.1640670","region":"安徽","lat_wgs84":"30.2441431","lng_wgs84":"118.1521747","relevance":12.070938110351562,"grade_level":4}],"mode":"fulltext","total":4}}

景区分页列表

分页返回景区列表

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/scenic/list JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
page	integer	否	页码，默认 1；小于 1 按 1 处理
page_size	integer	否	每页条数，默认 20，最大 20；超出范围按边界值处理
brief	boolean	否	精简模式
fields	string	否	返回字段白名单，空格分隔，最多 30 个；超出 30 个截断，单字段超 64 字符忽略
grade	string	否	按等级过滤（如 5A）
region	string	否	按地区过滤（如北京）

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].name	string	名称
data.list[].region	string	地区
data.list[].grade	string	评级
data.list[].grade_level	integer	等级数字（1-5）
data.list[].lng_bd	string	经度（BD-09 坐标系）
data.list[].lat_bd	string	纬度（BD-09 坐标系）
data.list[].lng_wgs84	string	经度（WGS84 坐标系）
data.list[].lat_wgs84	string	纬度（WGS84 坐标系）
data.total	integer	总条数
data.page	integer	当前页码
data.page_size	integer	每页条数
data.pages	integer	页数
data.error	string	服务暂不可用时的错误标识（如 db_unavailable），正常时不返回

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":10,"name":"颐和园","grade":"5A","lat_bd":"40.0048690","lng_bd":"116.2787490","region":"北京","lat_wgs84":"39.9973136","lng_wgs84":"116.2662954","grade_level":5},{"id":85,"name":"十三陵","grade":"5A","lat_bd":"40.2635440","lng_bd":"116.2318460","region":"北京","lat_wgs84":"40.2566219","lng_wgs84":"116.2191321","grade_level":5},{"id":105,"name":"慕田峪长城","grade":"5A","lat_bd":"40.4374420","lng_bd":"116.5716113","region":"北京","lat_wgs84":"40.4305512","lng_wgs84":"116.5591602","grade_level":5}],"page":1,"pages":598,"total":11956,"page_size":20}}

景区详情

按 ID 获取景区详情

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/scenic/detail JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
id	integer	是	景区 ID
brief	boolean	否	精简模式
fields	string	否	返回字段白名单，空格分隔，最多 30 个；超出 30 个截断，单字段超 64 字符忽略

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.id	integer	唯一标识
data.name	string	名称
data.region	string	地区
data.grade	string	评级
data.grade_level	integer	等级数字（1-5）
data.lng_bd	string	经度（BD-09 坐标系）
data.lat_bd	string	纬度（BD-09 坐标系）
data.lng_wgs84	string	经度（WGS84 坐标系）
data.lat_wgs84	string	纬度（WGS84 坐标系）

请求示例

返回示例

{"msg":"success","code":200,"data":{"id":1,"name":"石景山游乐园","grade":"4A","lat_bd":"39.9178111","lng_bd":"116.2155183","region":"北京","lat_wgs84":"39.9108622","lng_wgs84":"116.2028471","grade_level":4}}

景区批量查询

批量查询景区

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/scenic/batch JSON

请求参数

参数名	类型	必填	说明
items	array	是	景区 ID 或名称数组；GET 请求请以 items[]=10&items[]=85 形式传递，最多 10 项，超出直接报错（4002）
key	string	否	匹配字段：id / name，默认 name。注意：参数名与认证密钥参数 key 同名，请使用 Authorization 请求头认证，勿用 URL 的 key 参数传递密钥
brief	boolean	否	精简模式
fields	string	否	返回字段白名单，空格分隔，最多 30 个；超出 30 个截断，单字段超 64 字符忽略

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.ok	integer	成功处理的条目数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].name	string	名称
data.list[].grade	string	评级
data.list[].lat_bd	string	纬度（BD-09 坐标系）
data.list[].lng_bd	string	经度（BD-09 坐标系）
data.list[].region	string	地区
data.list[].lat_wgs84	string	纬度（WGS84 坐标系）
data.list[].lng_wgs84	string	经度（WGS84 坐标系）
data.list[].grade_level	integer	等级数字（1-5）
data.total	integer	总条数
data.returned	integer	本次实际返回条数
data.max_limit	integer	允许返回的最大条数
data.not_found	integer	未找到的记录数
data.truncated	boolean	保留字段，当前恒为 false（超过 10 条时直接返回 4002 错误，不会截断）

请求示例

返回示例

{"msg":"success","code":200,"data":{"ok":3,"list":[{"id":10,"name":"颐和园","grade":"5A","lat_bd":"40.0048690","lng_bd":"116.2787490","region":"北京","lat_wgs84":"39.9973136","lng_wgs84":"116.2662954","grade_level":5},{"id":85,"name":"十三陵","grade":"5A","lat_bd":"40.2635440","lng_bd":"116.2318460","region":"北京","lat_wgs84":"40.2566219","lng_wgs84":"116.2191321","grade_level":5},{"id":105,"name":"慕田峪长城","grade":"5A","lat_bd":"40.4374420","lng_bd":"116.5716113","region":"北京","lat_wgs84":"40.4305512","lng_wgs84":"116.5591602","grade_level":5}],"total":3,"returned":3,"max_limit":10,"not_found":0,"truncated":false}}

附近景区

按坐标查询附近景区

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/scenic/nearby JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
lat	number	是	纬度
lng	number	是	经度
radius	number	否	搜索半径 km，默认 10，取值范围 0~200（不含 0），超出返回 4002
limit	integer	否	返回条数，默认 20，最大 20；超出范围按边界值处理
brief	boolean	否	精简模式
fields	string	否	返回字段白名单，空格分隔，最多 30 个；超出 30 个截断，单字段超 64 字符忽略

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].name	string	名称
data.list[].region	string	地区
data.list[].grade	string	评级
data.list[].grade_level	integer	等级数字（1-5）
data.list[].lng_bd	string	经度（BD-09 坐标系）
data.list[].lat_bd	string	纬度（BD-09 坐标系）
data.list[].lng_wgs84	string	经度（WGS84 坐标系）
data.list[].lat_wgs84	string	纬度（WGS84 坐标系）
data.list[].distance	number	距离（数值）
data.total	integer	总条数
data.has_more	boolean	是否还有更多数据
data.error	string	服务暂不可用时的错误标识（如 db_unavailable），正常时不返回

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":177,"name":"前门大街景区","grade":"3A","lat_bd":"39.9055240","lng_bd":"116.4045880","region":"北京","distance":0.73,"lat_wgs84":"39.8977732","lng_wgs84":"116.3919642","grade_level":3},{"id":128,"name":"德双睿景区","grade":"1A","lat_bd":"39.9043386","lng_bd":"116.4024527","region":"北京","distance":0.95,"lat_wgs84":"39.8965940","lng_wgs84":"116.3898262","grade_level":1},{"id":205,"name":"北京老舍茶馆","grade":"3A","lat_bd":"39.9060590","lng_bd":"116.3996550","region":"北京","distance":1.12,"lat_wgs84":"39.8983302","lng_wgs84":"116.3870260","grade_level":3}],"total":20,"has_more":true}}

POI 类型列表

返回 POI 类型列表

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/scenic/poi-types JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
level	string	否	类别级别：main / sub / detail，默认 main；非法值返回 4003
main	string	否	一级类别（level 为 sub / detail 时用于过滤）
sub	string	否	二级类别（level 为 detail 时用于过滤）
limit	integer	否	返回条数，默认 20，最大 20；超出范围按边界值处理

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].type_main	string	主分类

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"type_main":"风景名胜"},{"type_main":"体育休闲服务"},{"type_main":"科教文化服务"}],"total":15}}

POI 字段列表

返回 POI 可查询字段

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/scenic/poi-fields JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].field	string	字段名
data.list[].label	string	标签
data.list[].brief	boolean	是否属于精简字段

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"brief":true,"field":"id","label":"ID"},{"brief":true,"field":"title","label":"景点名称"},{"brief":false,"field":"tel","label":"联系电话"}],"total":14}}

POI 查询

查询景点 POI

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/scenic/poi-query JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
keyword	string	是	关键词
limit	integer	否	返回条数，默认 10，最大 20；超出范围按边界值处理
brief	boolean	否	精简模式
fields	string	否	返回字段白名单，空格分隔，最多 30 个；超出 30 个截断，单字段超 64 字符忽略

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].title	string	标题
data.list[].tel	string	电话
data.list[].address	string	详细地址
data.list[].type	string	类型
data.list[].type_main	string	主分类
data.list[].type_sub	string	子分类
data.list[].type_detail	string	细分类型
data.list[].area_id	string	区域标识
data.list[].poi_id	string	POI 标识
data.list[].lng_gcj	string	经度（GCJ-02 坐标系）
data.list[].lat_gcj	string	纬度（GCJ-02 坐标系）
data.list[].lng_wgs84	string	经度（WGS84 坐标系）
data.list[].lat_wgs84	string	纬度（WGS84 坐标系）
data.total	integer	总条数
data.mode	string	查询匹配模式
data.error	string	服务暂不可用时的错误标识（如 db_unavailable），正常时不返回

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":133,"tel":"010-63095630;010-63095745;010-63095718","type":"风景名胜;风景名胜;风景名胜","title":"天安门","poi_id":"B000A60DA1","address":"东长安街","area_id":"110101","lat_gcj":"39.9087220","lng_gcj":"116.3974960","type_sub":"风景名胜","lat_wgs84":"39.9073190","lng_wgs84":"116.3912520","type_main":"风景名胜","type_detail":"风景名胜"},{"id":216559,"tel":"010-63095718;010-63095630","type":"风景名胜;风景名胜;风景名胜","title":"天安门","poi_id":"B0FFFTXZOA","address":"东长安街","area_id":"110101","lat_gcj":"39.9087220","lng_gcj":"116.3974960","type_sub":"风景名胜","lat_wgs84":"39.9073190","lng_wgs84":"116.3912520","type_main":"风景名胜","type_detail":"风景名胜"}],"mode":"exact","total":2}}

POI 分页列表

分页返回 POI 列表

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/scenic/poi-list JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
page	integer	否	页码，默认 1；小于 1 按 1 处理
page_size	integer	否	每页条数，默认 20，最大 20；超出范围按边界值处理
brief	boolean	否	精简模式
fields	string	否	返回字段白名单，空格分隔，最多 30 个；超出 30 个截断，单字段超 64 字符忽略
type_main	string	否	按一级类别过滤
type_sub	string	否	按二级类别过滤
type_detail	string	否	按三级类别过滤
area_id	string	否	按行政区划编码过滤

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].title	string	标题
data.list[].tel	string	电话
data.list[].address	string	详细地址
data.list[].type	string	类型
data.list[].type_main	string	主分类
data.list[].type_sub	string	子分类
data.list[].type_detail	string	细分类型
data.list[].area_id	string	区域标识
data.list[].poi_id	string	POI 标识
data.list[].lng_gcj	string	经度（GCJ-02 坐标系）
data.list[].lat_gcj	string	纬度（GCJ-02 坐标系）
data.list[].lng_wgs84	string	经度（WGS84 坐标系）
data.list[].lat_wgs84	string	纬度（WGS84 坐标系）
data.total	integer	总条数
data.page	integer	当前页码
data.page_size	integer	每页条数
data.pages	integer	页数
data.error	string	服务暂不可用时的错误标识（如 db_unavailable），正常时不返回

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":1,"tel":"","type":"风景名胜;风景名胜;风景名胜","title":"礼王府","poi_id":"B000A81F8Z","address":"西黄城根南街9号","area_id":"110102","lat_gcj":"39.9195840","lng_gcj":"116.3771780","type_sub":"风景名胜","lat_wgs84":"39.9181930","lng_wgs84":"116.3709480","type_main":"风景名胜","type_detail":"风景名胜"},{"id":2,"tel":"","type":"风景名胜;风景名胜相关;旅游景点","title":"北京动物园(北2门)","poi_id":"B000A81FAR","address":"五塔寺路22号","area_id":"110108","lat_gcj":"39.9441570","lng_gcj":"116.3334870","type_sub":"风景名胜相关","lat_wgs84":"39.9428340","lng_wgs84":"116.3273360","type_main":"风景名胜","type_detail":"旅游景点"},{"id":3,"tel":"","type":"风景名胜;公园广场;动物园","title":"北京动物园(东北门)","poi_id":"B000A81FAS","address":"西直门外大街137号北京动物园","area_id":"110108","lat_gcj":"39.9449320","lng_gcj":"116.3351300","type_sub":"公园广场","lat_wgs84":"39.9436050","lng_wgs84":"116.3289750","type_main":"风景名胜","type_detail":"动物园"}],"page":1,"pages":16225,"total":324498,"page_size":20}}

附近 POI

按坐标查询附近 POI

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/scenic/poi-nearby JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
lat	number	是	纬度
lng	number	是	经度
radius	number	否	搜索半径 km，默认 5，取值范围 0~200（不含 0），超出返回 4002
limit	integer	否	返回条数，默认 20，最大 20；超出范围按边界值处理
brief	boolean	否	精简模式
fields	string	否	返回字段白名单，空格分隔，最多 30 个；超出 30 个截断，单字段超 64 字符忽略

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].id	integer	记录唯一标识
data.list[].title	string	标题
data.list[].tel	string	电话
data.list[].address	string	详细地址
data.list[].type	string	类型
data.list[].type_main	string	主分类
data.list[].type_sub	string	子分类
data.list[].type_detail	string	细分类型
data.list[].area_id	string	区域标识
data.list[].poi_id	string	POI 标识
data.list[].lng_gcj	string	经度（GCJ-02 坐标系）
data.list[].lat_gcj	string	纬度（GCJ-02 坐标系）
data.list[].lng_wgs84	string	经度（WGS84 坐标系）
data.list[].lat_wgs84	string	纬度（WGS84 坐标系）
data.list[].distance	number	距离（数值）
data.total	integer	总条数
data.has_more	boolean	是否还有更多数据
data.error	string	服务暂不可用时的错误标识（如 db_unavailable），正常时不返回

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"id":210567,"tel":"010-67012288","type":"风景名胜;风景名胜相关;旅游景点","title":"共青团中央","poi_id":"B0FFFRNCSD","address":"前门东大街10号","area_id":"110101","lat_gcj":"39.9003010","lng_gcj":"116.4062740","distance":0.12,"type_sub":"风景名胜相关","lat_wgs84":"39.8988980","lng_wgs84":"116.4000320","type_main":"风景名胜","type_detail":"旅游景点"},{"id":412,"tel":"","type":"风景名胜;风景名胜相关;旅游景点","title":"东交民巷使馆建筑群","poi_id":"B000A84ZLN","address":"市东城区东交民巷","area_id":"110101","lat_gcj":"39.9024430","lng_gcj":"116.4069100","distance":0.13,"type_sub":"风景名胜相关","lat_wgs84":"39.9010400","lng_wgs84":"116.4006680","type_main":"风景名胜","type_detail":"旅游景点"},{"id":4158,"tel":"","type":"风景名胜;风景名胜;风景名胜","title":"正金银行旧址","poi_id":"B000A9LEX5","address":"正义路4附近","area_id":"110101","lat_gcj":"39.9027760","lng_gcj":"116.4072890","distance":0.18,"type_sub":"风景名胜","lat_wgs84":"39.9013730","lng_wgs84":"116.4010470","type_main":"风景名胜","type_detail":"风景名胜"}],"total":20,"has_more":true}}

产品说明

产品概述

中国 A 级景区与景点 POI 查询。

使用场景

数据查询：快速集成景点查询到您的应用中

业务系统：将景点查询数据嵌入业务流程

开发工具：通过 API 接口获取数据查询数据

数据分析：基于景点查询数据进行分析和决策

费用计算

按次计费单价

¥0.004 / 次

每次调用接口从账户余额中扣除相应费用，VIP 用户可享折扣

扣费优先级

免费额度

次数包

余额扣费

计费方式详解

1 免费额度

· 接口每日免费额度已关闭
· VIP 用户月度免费额度：
· 个人版：每月 5000 次，本接口月上限 5000 次
· 专业版：每月 30000 次，本接口月上限 30000 次
· 企业版：每月 200000 次，本接口月上限 200000 次
· 账户如有注册/活动赠送的免费次数，会优先于接口免费额度扣减
· VIP 月度免费额度仅适用于单次售价不高于 ¥0.0800/次的接口；接口每日免费额度按接口配置执行
VIP 月度免费额度每月重置，未使用部分不累计至下月。

2 次数包

预付费购买固定调用次数，最高可省 20%（相对按次付费），用完为止。
次数包为独立计费，不与 VIP 折扣叠加。
请在有效期内使用，过期后未使用的次数不可再用。

3 余额扣费

按次从账户余额扣除费用；所有用户可享量折扣，VIP 用户额外享 VIP 折扣。
扣费公式：实际扣费 = 接口单价 × (1 - VIP 折扣比例 - 量折扣比例)，并受总折扣上限和最低利润率保护约束
VIP 折扣：个人版9折专业版8折企业版7折
量折扣：月付费调用 ≥1000 次享 2%、月付费调用 ≥10000 次享 5%、月付费调用 ≥20000 次享 10%
· 量折扣按账号当月全部接口的付费调用次数统计，达到更高档位时按更高档位计算
总折扣上限：VIP 折扣 + 量折扣合计不超过 50%
最低利润率保护：折后价不得低于成本价 × (1 + 15%)；若接口售价本身低于该保护价，则取消折扣并按售价计费
余额不足时调用将失败，请及时充值。

次数包方案

方案名称	调用次数	价格	折算单价	比按次付费节省	有效期
100次调用包	100 次	¥0.4	¥0.0040/次	-	365 天
500次调用包	500 次	¥1.9	¥0.0038/次	省5%	365 天
1000次调用包	1000 次	¥3.6	¥0.0036/次	省10%	365 天
5000次调用包	5000 次	¥17	¥0.0034/次	省15%	365 天
10000次调用包	10000 次	¥32	¥0.0032/次	省20%	365 天

VIP 权益对比

等级	每月免费次数	本接口月免费上限	折扣	VIP 折后单价
免费版	按接口配置	—	-	¥0.004/次
个人版	5000 次	5000 次	10%	¥0.0036/次
专业版	30000 次	30000 次	20%	¥0.0032/次
企业版推荐	200000 次	200000 次	30%	¥0.0028/次

* VIP 月度免费额度每月重置。每月免费次数为账号级 VIP 月额度，本接口月免费上限为其中对本接口的限制（接口可单独设置上限或关闭）。VIP 折扣仅适用于余额扣费方式，VIP 折后单价不含量折扣。本接口已关闭接口级月度免费额度（不影响 VIP 月度免费额度）。接口每日免费额度已关闭。

费用计算示例

* 以下示例未包含量折扣，量折扣按账号当月全部接口的付费调用量另行计算。

示例1：普通用户按次付费

调用 1000 次，费用 = 0.004 × 1000 = ¥4.00

示例2：个人版用户按次付费（仅 VIP 折扣，已考虑最低利润率保护）

调用 1000 次，折扣约 10%，费用 = 0.004 × (1 - 10%) × 1000 ≈ ¥3.60

示例3：购买「500次调用包」次数包

支付 ¥1.90，获得 500 次调用，折算单价 ¥0.0038/次

同等次数按次付费需 ¥2.00，次数包可节省 ¥0.10

错误码说明

错误码	说明	解决方案
200	请求成功	-
400000	请求参数错误	检查参数名、格式与取值
401000	认证失败	检查 Authorization: Bearer 密钥是否正确、是否过期
402000	账户余额不足	充值后重试
403000	无访问权限	确认密钥权限、接口范围与 IP 白名单是否满足要求
404001	接口或端点不存在	检查 API 与端点的请求路径
409000	请求冲突	请稍后重试
422000	参数校验失败	检查参数格式与取值
429000	请求频率或额度超限	降低调用频率，或升级套餐提升额度
500000	服务器内部错误	携带响应中的 request_id 联系技术支持
502000	服务暂时不可用	稍后重试
503000	服务暂时不可用	稍后重试
504000	请求超时	稍后重试

更新日志

暂无更新日志