- 快速开始：API服务
- 快速开始：MCP服务
- 网关公共响应码对照
- 城市ID对照表
- API能力对接
- 店铺级定位SDK
- 数据模型
场景查询（名称关键词）
开发中
POST
/v1/poi_by_keyword
请求参数
Authorization
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token示例：
Authorization: Bearer ********************Body 参数application/json
示例
{
"keyword": "麦当劳",
"brand_id": 4,
"category_id": 1544,
"city_id": 340,
"page_num": 1,
"page_size": 10
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://data-api.isjike.com/api/v1/poi_by_keyword' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"keyword": "麦当劳",
"brand_id": 4,
"category_id": 1544,
"city_id": 340,
"page_num": 1,
"page_size": 10
}'返回响应
🟢200成功
application/json
Body
示例
{
"response_id": "5a5fcf35-4d80-4466-80a5-beb1b4a82e96",
"code": 200,
"message": "success",
"biz_code": 200,
"biz_message": "ok",
"data": {
"items": [
{
"poi_id": 54261031,
"poi_name": "麦当劳",
"category_id": 1544,
"category_name": "西式快餐",
"brand_id": 4,
"brand_name": "麦当劳",
"province_id": 7,
"province": "广东省",
"city_id": 340,
"city": "深圳市",
"district": "南山区",
"address": "广东省深圳市南山区沙河街道深圳华侨城创意文化园北区",
"longitude": 113.986917,
"latitude": 22.542019,
"category_id_list": [
10,
102,
1544
],
"category_name_list": [
"美食",
"小吃快餐",
"西式快餐"
],
"recognizable": true,
"poi_status": 1,
"distance": -1
},
{
"poi_id": 40660180,
"poi_name": "麦当劳",
"category_id": 1544,
"category_name": "西式快餐",
"brand_id": 4,
"brand_name": "麦当劳",
"province_id": 7,
"province": "广东省",
"city_id": 340,
"city": "深圳市",
"district": "南山区",
"address": "荔海二道与前海路交叉口西北20米",
"longitude": 113.902002,
"latitude": 22.51508,
"category_id_list": [
10,
102,
1544
],
"category_name_list": [
"美食",
"小吃快餐",
"西式快餐"
],
"recognizable": true,
"poi_status": 5,
"distance": -1
},
{
"poi_id": 54260800,
"poi_name": "麦当劳",
"category_id": 1544,
"category_name": "西式快餐",
"brand_id": 4,
"brand_name": "麦当劳",
"province_id": 7,
"province": "广东省",
"city_id": 340,
"city": "深圳市",
"district": "坪山区",
"address": "广东省深圳市坪山区坪山街道和城里",
"longitude": 114.336499,
"latitude": 22.704369,
"category_id_list": [
10,
102,
1544
],
"category_name_list": [
"美食",
"小吃快餐",
"西式快餐"
],
"recognizable": true,
"poi_status": 1,
"distance": -1
},
{
"poi_id": 54260907,
"poi_name": "麦当劳",
"category_id": 1544,
"category_name": "西式快餐",
"brand_id": 4,
"brand_name": "麦当劳",
"province_id": 7,
"province": "广东省",
"city_id": 340,
"city": "深圳市",
"district": "宝安区",
"address": "深圳市宝安区宝安大道沙井水源居西南侧约290米",
"longitude": 113.820877,
"latitude": 22.751046,
"category_id_list": [
10,
102,
1544
],
"category_name_list": [
"美食",
"小吃快餐",
"西式快餐"
],
"recognizable": true,
"poi_status": 1,
"distance": -1
},
{
"poi_id": 54603096,
"poi_name": "麦当劳",
"category_id": 1544,
"category_name": "西式快餐",
"brand_id": 4,
"brand_name": "麦当劳",
"province_id": 7,
"province": "广东省",
"city_id": 340,
"city": "深圳市",
"district": "光明区",
"address": "光明办事处汇业路北侧万和科技大厦A栋负一层107-2号商铺",
"longitude": 113.938555,
"latitude": 22.740322,
"category_id_list": [
10,
102,
1544
],
"category_name_list": [
"美食",
"小吃快餐",
"西式快餐"
],
"recognizable": true,
"poi_status": 1,
"distance": -1
},
{
"poi_id": 54261052,
"poi_name": "麦当劳",
"category_id": 1544,
"category_name": "西式快餐",
"brand_id": 4,
"brand_name": "麦当劳",
"province_id": 7,
"province": "广东省",
"city_id": 340,
"city": "深圳市",
"district": "龙岗区",
"address": "广东省深圳市龙岗区龙岗街道圳埔岭路与临河东路交汇处北侧南联社区合正方州润园2栋一层16号（复式一层及二层复试）商铺",
"longitude": 114.245334,
"latitude": 22.711123,
"category_id_list": [
10,
102,
1544
],
"category_name_list": [
"美食",
"小吃快餐",
"西式快餐"
],
"recognizable": true,
"poi_status": 1,
"distance": -1
},
{
"poi_id": 32809553,
"poi_name": "麦当劳(赤湾店)",
"category_id": 1544,
"category_name": "西式快餐",
"brand_id": 4,
"brand_name": "麦当劳",
"province_id": 7,
"province": "广东省",
"city_id": 340,
"city": "深圳市",
"district": "南山区",
"address": "招商街道赤湾六路山海逸居2栋107号商铺",
"longitude": 113.88677,
"latitude": 22.48286,
"category_id_list": [
10,
102,
1544
],
"category_name_list": [
"美食",
"小吃快餐",
"西式快餐"
],
"recognizable": true,
"poi_status": 1,
"distance": -1
},
{
"poi_id": 2493928,
"poi_name": "麦当劳(莲塘店)",
"category_id": 1544,
"category_name": "西式快餐",
"brand_id": 4,
"brand_name": "麦当劳",
"province_id": 7,
"province": "广东省",
"city_id": 340,
"city": "深圳市",
"district": "罗湖区",
"address": "莲塘聚宝路聚宝综合楼首层",
"longitude": 114.164857,
"latitude": 22.565204,
"category_id_list": [
10,
102,
1544
],
"category_name_list": [
"美食",
"小吃快餐",
"西式快餐"
],
"recognizable": true,
"poi_status": 1,
"distance": -1
},
{
"poi_id": 2493914,
"poi_name": "麦当劳(西丽店)",
"category_id": 1544,
"category_name": "西式快餐",
"brand_id": 4,
"brand_name": "麦当劳",
"province_id": 7,
"province": "广东省",
"city_id": 340,
"city": "深圳市",
"district": "南山区",
"address": "西丽镇众冠花园城首层",
"longitude": 113.950044,
"latitude": 22.580278,
"category_id_list": [
10,
102,
1544
],
"category_name_list": [
"美食",
"小吃快餐",
"西式快餐"
],
"recognizable": true,
"poi_status": 2,
"distance": -1
},
{
"poi_id": 32809496,
"poi_name": "麦当劳(田贝店)",
"category_id": 1544,
"category_name": "西式快餐",
"brand_id": 4,
"brand_name": "麦当劳",
"province_id": 7,
"province": "广东省",
"city_id": 340,
"city": "深圳市",
"district": "罗湖区",
"address": "翠竹街道愉天社区田贝三路106号宝安外贸大厦118号101-1号商铺",
"longitude": 114.118718,
"latitude": 22.565943,
"category_id_list": [
10,
102,
1544
],
"category_name_list": [
"美食",
"小吃快餐",
"西式快餐"
],
"recognizable": true,
"poi_status": 1,
"distance": -1
}
]
}
}修改于 2025-08-14 07:54:11