快速获取线下场景POI数据，分享场景查询API体验指南

最近自研产品需要接入一个POI查询的能力，需要输入场景的名称就能立即获取相关POI数据。

找了很多平台，有些虽然能满足需求，但价格确实感人，用不起。最后在朋友推荐下，找到一个叫场景查询（名称关键词）的API，用起来还不错，性价比蛮高，分享出来，感兴趣的可以调取玩玩。

API相关参数说明

先看看这个场景查询（名称关键词）API的标准开发文档内容，了解其关键参数和说明：

Body参数

名称	类型	是否必需	字段含义
keyword	string	是	场景名称关键词
brand_id	integer	否	品牌ID
category_id	integer	否	分类ID
city_id	integer	否	城市ID
page_num	integer	否	分页页码
page_size	integer	否	每页数据量

从Body参数可知，想要获取这个POI的基础信息，你必须要提供确定的场景名称关键词即可，其他类似品牌ID这种是非必需，但可作为补充，提升POI查询的准确性；如果所查询的POI数量较多，也可设置分页，还是比较方便的。

返回响应字段说明

名称	类型	是否必需	字段含义
response_id	string	是	平台公共网响应ID
code	integer	是	公共网关响应码
message	string	是	公共网关响应参数
biz_code	integer	是	API服务响应码
biz_message	string	是	API服务响应信息
items	array	是	场景基础信息

返回的场景POI基础数据很丰富，包含场景ID、名称、分类名称、品牌名称、地址、经纬度等，十几个不同类型的数据，能帮助用户快速了解场景POI，适用各种深度应用开发。

比如给产品增加一个竞品分析功能，就可以通过POI关键词查询来实现，追踪目标品牌的扩张轨迹和区域密度。

API体验及接入指南

注册与在线体验

1、在开放平台能力中心页面找到“场景查询”栏目，找到场景查询（名称关键词）API，点击查看详情；

2、进入详情页后，右上角是API的标准开发文档，目前API是提供测试的，可以先调用试试再说；

3、平台的【在线体验】页面是提供部分API 的免费在线测试，这个功能非常好，不需要花钱便能感受API的效果，省去很多测试成本，建议多去试试。

回到今天推荐的核心API：“场景查询（名称关键词）API”，接口设计简洁易用，开发者可以快速集成到系统中，以下是关键步骤：

1.注册与认证 登录平台控制台，获取场景查询（名称关键词）接口API Key，用于后续接口调用；

2.接口调用示例 提供多种编程语言的SDK，以下以Python为例，展示场景查询（名称关键词）API接口的调用方法：

以麦当劳为例，我们输入所想查询的场景名称和ID，便立即返回了想要的POI基础信息：

总结测评下来，这个场景POI查询（名称关键词）API的响应还是很快的，简单易用，对我们产品的帮助也很大，如果有类似需求的开发者可以去体验体验。