最近自研产品需要接入一个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接口的调用方法：
import http.client
import json
conn = http.client.HTTPSConnection("data-api.isjike.com")
payload = json.dumps({
"keyword": "麦当劳",
"brand_id": 4,
"category_id": 1544,
"city_id": 340,
"page_num": 1,
"page_size": 10
})
headers = {
'Content-Type': 'application/json'
}
conn.request("POST", "/api/v1/poi_by_keyword", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))以麦当劳为例，我们输入所想查询的场景名称和ID，便立即返回了想要的POI基础信息：
总结测评下来，这个场景POI查询（名称关键词）API的响应还是很快的，简单易用，对我们产品的帮助也很大，如果有类似需求的开发者可以去体验体验。
来自 “ ITPUB博客 ” ，链接：https://blog.itpub.net/70046922/viewspace-3091968/ ，如需转载，请注明出处，否则将追究法律责任。
