获取快手POIID

更新时间：2024-09-26 11:33:11

接口说明

融合、转换、查询是三种获取快手POIID的方式，具体开发者可以自身实际情况选择调用。整体上建议开发者可以基于“查询”接口来获取准确的快手POIID，且可以根据查询接口做一个“工具”, 支持运营等随时查看POIID。

1、融合接口

项目	值
域名	https://open.kuaishou.com (opens new window)
接口说明	上传poi数据进行融合
调用限制说明	请求并发<100；P99 平均耗时 : 1s会存在少量2-3s的长耗时，主要原因在于当入参关键词（poi名称）召回附近非常多的相似POI时，会产生较长的融合耗时；超时时间：3s（针对离线的场景）、1s(针对实时的场景)
Path	/openapi/mp/developer/poi/service/merge
Method	POST

Request Param

参数名	类型	是否必填	备注
component_app_id	string	是	第三方应用id
authorizer_access_token	string	是	小程序授权token

以下参数作为body发送

{  
"ext\_poi\_id" : "65432164222",  
"poi\_name" : "盘古七星",  
"province" : "北京省",  
"city" : "北京市",  
"district" : "朝阳区",  
"poi\_address" : "北京市朝阳区北四环中路27号盘古七星大酒店",  
"lng\_lat" : "114.441282,38.066772",  
"poi\_type" : "餐饮-火锅-串串香",  
"poi\_pic\_url" : "http://xxx.png",  
"poi\_opening\_time" : "示例见下",  
"poi\_phone" : "13378552136",  
"poi\_shop_labels" : \["自助餐", "海鲜"\]  
}  

body参数说明

参数名	是否必填	类型	备注
ext_poi_id	是	string	外部POI的唯一标识
source	是	int	外部poiId来源，1:高德 2:百度 3:腾讯
poi_name	是	string	POI名称
province	是	string	省（直辖市写市名：北京市等） 示例：海南省、北京市
city	是	string	市（省直辖县写"省直"） 示例：三亚市、北京市
district	是	string	区，示例：天涯区、海淀区、沙县
poi_address	是	string	POI地址（完整的详细地址），示例：北京市海淀区上地西路6号
lng_lat	是	string	POI经纬度，经度纬度逗号分隔，精度不能低于小数点后6位
poi_type	是（期望提供完整分类与快手分类做映射）	string	POI品类，格式为：一级-二级-三级示例：餐饮-火锅-串串香
poi_pic_url	否	string	POI头图
poi_opening_time	否	string	POI营业时间，纯文本
poi_phone	否	string	POI电话
poi_shop_labels	否	string数组	店铺标签
notify_url	否	string	融合结果通
attach	否	string	回调附加信息

POI营业时间示例

示例1：  
2021-01-12——2021-07-12  
上午10:00-下午2:00

示例2:  
周一-周五  
上午10:00-下午8:00  
周六-周日  
上午10:00-下午9:00

示例3:  
春/夏/秋季  
周一-周五  
上午10:00-下午8:00  
周六-周日  
上午10:00-下午9:00  
冬季  
周一-周五  
上午10:00-下午6:00  
周六-周日  
上午10:00-下午7:00  

Response

{  
"result": 1, // 非1视为异常情况，错误码见错误码说明  
"error_msg": "success", // 错误提示信息  
"data" : {  
"extPoiId" : "65432164222",  
"ksPoiId" : "6724909395445513704",  
"poiInfo": {  
"name": "北京福江和利汽车维修有限公司",  
"address": "北京市北京市房山区石窝村商贸园区80号",  
"lat": 39.550497,  
"lng": 115.817545  
}  
}  
}  

2、转换接口

项目	值
域名	线上环境：https://open.kuaishou.com (opens new window)
接口说明	外部poiId转换为快手poiId接口
Path	/openapi/mp/developer/poi/service/transform
Method	POST

Request Param

参数名	类型	位置	是否必填	备注
component_app_id	string	request param	是	第三方应用id
authorizer_access_token	string	request param	是	小程序授权token

以下参数作为body发送

{  
"external\_poi\_id":"123123",  
"source":1  
"lng\_lat":"100,200",  
"poi\_name":"快手总部",  
"poi_city":"北京市昌平区"  
}  

body参数说明

参数名	类型	是否必填	备注
external_poi_id	string	是	待转换的poiId
source	int	是	外部poiId来源，1:高德 2:百度 3:腾讯
lng_lat	string	是	经纬度，经度纬度逗号分隔
poi_name	string	是	poi名称
poi_city	string	是	poi城市名，市+区拼接

Response

{  
"result": 1, // 非1视为错误码，详见错误码说明  
"error_msg": "success", // 错误提示信息  
"data": {  
"externalPoiId":"123123",  
"ksPoiId":"456456",  
"poiName":"快手总部",  
"poiCity":"北京市昌平区"  
}  
}  

3、查询接口

项目	值
域名	线上环境：https://open.kuaishou.com (opens new window)
接口说明	小程序查询指定条件下要挂载的POI列表
Path	/openapi/mp/developer/poi/service/list
Method	GET

Request Param

参数名	类型	位置	是否必填	备注
component_app_id	string	request param	是	服务商id
authorizer_access_token	string	request paaram	是	小程序授权token
key_word	string	request param	是	店铺名称
city	string	request param	否	申请POI所在城市的完整名称。eg: 直辖市支持格式（最长：市+区）：北京市昌平区、北京市、昌平区； 非直辖市支持格式（最长：省+市+区）：河北省石家庄市裕华区、石家庄市裕华区、石家庄市、裕华区 注意：lngLat字段为空时，必传
lng_lat	string	request param	否	经纬度，经度纬度逗号分隔 注意：city为空时必传

Response

{  
"result": 1, // 非1视为错误码，详见错误码说明  
"error_msg": "success",  
"data": \[  
{  
"poiId": "6724909272396185084",  
"poiName": "北京市大兴区乐园路4号院2号楼1层119,好利来(大兴乐园路店)",  
"city": "北京市",  
"address": "xxxxx详细地址",  
"lat": 39.550497,  
"lng": 115.817545  
},  
{  
"poiId": "6724909544117014239",  
"poiName": "北京市西城区新街口街道西直门南小街国英园1-5号(青年宫电影院斜对面),好利来(西直门南小街)",  
"city": "北京市",  
"address": "xxxxx详细地址",  
"lat": 39.550497,  
"lng": 115.817545  
},  
{  
"poiId": "6724909544114833659",  
"poiName": "北京市丰台区马家堡西居住区明日商厦40号楼1层111号,好利来(马家堡店)",  
"city": "北京市",  
"address": "xxxxx详细地址",  
"lat": 39.550497,  
"lng": 115.817545  
},  
{  
"poiId": "6724909491622225961",  
"poiName": "北京市朝阳区左家庄南里16号楼,好利来(左家庄店)",  
"city": "北京市",  
"address": "xxxxx详细地址",  
"lat": 39.550497,  
"lng": 115.817545  
}  
\]  
}