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

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

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

API相关参数说明

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

Body参数

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

返回响应字段说明

返回的场景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的响应还是很快的，简单易用，对我们产品的帮助也很大，如果有类似需求的开发者可以去体验体验。