简要描述
基本信息
| Item |
Info |
| URL |
/nsc/${version}/poi/suggest |
| Method |
GET |
| Content-Type: |
application/json |
接口输入参数
v1
| 参数名 |
类型 |
必选 |
说明 |
| channel |
是 |
string |
渠道,系统会对 channel 和 app_id 做相关性校验 |
| user_id |
否 |
string |
用户名,nio 用户传入 |
| channel_user_id |
否 |
string |
渠道用户名,企业对接必传 |
| keywords |
是 |
string |
搜索关键词 |
| latitude |
是 |
double |
纬度 |
| longitude |
是 |
double |
经度 |
v2
| 参数名 |
类型 |
必选 |
说明 |
| channel |
是 |
string |
渠道,系统会对 channel 和 app_id 做相关性校验 |
| user_id |
否 |
string |
用户名,nio 用户传入 |
| channel_user_id |
否 |
string |
渠道用户名,企业对接必传 |
| keywords |
是 |
string |
搜索关键词 |
| latitude |
否 |
double |
纬度(城市信息和经纬度必传其一) |
| longitude |
否 |
double |
经度(城市信息和经纬度必传其一) |
| city_code |
否 |
string |
6位区域行政码(城市信息和经纬度必传其一) |
| city_limit |
否 |
boolean |
区域数据召回限制。为 true 时,仅返回 city_code 对应区域内数据 |
注意:user_id和channel_user_id必传且只传其一
返回示例
{
"result_code":"success",
"debug_msg":"success",
"display_msg":"success",
"request_id":"0a7d9161ivvxqxry-164",
"server_time":1518143886,
"data":[
{
"poi_id":"mapbar: MAPITPTNJRTNHPJRHPTPC",
"latitude":31.277751,
"longitude":121.196542,
"name":"上海汽车创新港",
"province":"上海",
"city_name":"上海市",
"city_code":"130700",
"district":"嘉定区",
"address":"安拓路56号",
"area_code":"976243"
},
{
"poi_id":"team-1: 00000001",
"latitude":31.277751,
"longitude":121.196542,
"name":"上海汽车创新港 隔壁",
"province":"上海",
"city_name":"上海市",
"city_code":"130700",
"district":"嘉定区",
"address":"安拓路56号",
"area_code":"976243"
}
]
}
返回参数说明
| 参数名 |
类型 |
说明 |
| result_code |
string |
参考 API 规范 |
| request_id |
string |
参考 API 规范 |
| debug_msg |
string |
参考 API 规范 |
| display_msg |
string |
参考 API 规范 |
| server_time |
long |
参考 API 规范 |
| data |
list |
符合条件的 POI |
| --poi_id |
string |
POI ID |
| --latitude |
double |
纬度 |
| --longitude |
double |
经度 |
| --name |
string |
名称 |
| --province |
string |
省份 |
| --city_name |
string |
城市中文名 |
| --city_code |
string |
城市码 |
| --district |
string |
行政区 |
| --address |
string |
地址 |
| --area_code |
string |
地区码 |