停车场库信息上架高德服务
一、服务使用场景
当停车场的地理位置以及停车场库的相关信息(名称、剩余车位、收费金额等)无法在地图导航上显示时,对于停车场库的经营业主方而言的确不是一个好消息。阿里云IoT联合阿里集团高德导航为停车生态合作伙伴开放高德上架入口,停车系统的开发企业只需和阿里云IoT停车开放平台对接即可将场库基本信息上架到高德地图,在高德地图上展示场库的名称,总车位数,剩余车位数等场库关键信息。针对某些优质场库,特别是使用阿里云IOT余位校验服务的,还有机会享受高德手机端和车机端的高亮显示,凸显您场库的优质服务。
二、服务带来价值
1、场库在高德导航的手机端和车机端露出,有助于车主更便捷搜索到场库位置并导航至场库。
2、针对经营性的车场,如果余位充足的,便于高德导航将车主引流至停车场,帮助企业拉流增收。
3、针对优质场库的高亮露出,有助于车场业主打造更加优质停车服务和体验,区分自身品牌。
三、场景串联说明
第一步:企业停车云平台对接停车场本地的停车系统,实现企业旗下场库的停车基础数据(总车位数、剩余车位数,进离场车辆信息等)汇聚。
第二步:企业停车云平台对接阿里停车开放平台能力调用前置条件标准API,实现场库基础数据和动态数据的接入。
第三步:阿里停车开放平台,将场库数据进行去重,校验,和清洗后,推送给高德数据中枢.
第四步: 高德数据平台进行场库审核,审核通过后正常上架审核不通过则返回信息不通过。
四、接入步骤
4.1、前置条件:
企业停车云平台已经完成阿里云停车开放平台前置API的对接,能够将企业自身云平台数据和阿里云停车开放平台数据进行在线打通。
4.2、服务调用流程如下:
4.2.1 说明
企业在完成前置条件的情况下按照下述接口参数传入停车场静态信息,停车场库的相关信息发生变化时,需要再次调用改接口进行更新,更新内容会在审核后同步到高德展示。
4.2.2 接口
path: /park/isv/v1/park/amap/apply
version: 1.0.0
4.2.3 参数
参数名称 | 参数类型 | 必填 | 长度 | 说明 |
---|---|---|---|---|
vendorParkId | String | 是 | 停车场商的车场ID号 | |
spaceType | Integer | 是 | 停车场空间类型:地面车场1;地下车场2;立体车库3;机械式车库4;路边车场5; 其他车场类型0 | |
charge | Integer | 是 | 是否收费值说明 是:1 否:0 无法判定:2 | |
openTime | String | 否 | 开放时间,如:中午 11:00—-14:30 | |
inOutInfo | String | 是 | 停车场出入口数组,格式:x1,y1,type1;x2,y2,type2。x,y为经纬度信息;type为出入口类型:出入口值:0/出口值:1/入口值:2 | |
remark | String | 否 | 备注信息,记录停车场特殊信息,如“为自由出入口”、“施工中” | |
dayTime | String | 否 | 白天(收费)对应时间段。如:5:30-18:30 | |
nightTime | String | 否 | 夜间(收费)对应时间段。如:18:30-5:30 | |
prcCDE | Integer | 否 | 小车白天收费价格。填写规则:xx 元/小时(xx 小时、xx 分钟) | |
prcCNE | Integer | 否 | 小车夜间收费价格,同上 | |
prcTDE | Integer | 否 | 大车白天收费价格,同上 | |
prcTNE | Integer | 否 | 大车夜间收费价格,同上 | |
feeText | String | 否 | 文本表述的收费信息。如:前3小时15元/小时,后 1 小时10元/次。 | |
openType | Integer | 否 | 开放方式取值。完全开放:0;选择性对外病人:1; 选择性对外访客:2;选择性对外顾客:3;选择性对外游客:4;选择性对外住客5;选择性对外其他:6;不对外开放:7 | |
height | Integer | 否 | 停车场限高。单位:厘米 |
bizResults请求参数:
参数名称 | 参数类型 | 必填 | 长度 | 说明 |
---|---|---|---|---|
空 | 空 | 空 | 空 | 空 |
说明
4.2.4 调用示例
Java SDK的方式
请求示例
IoTApiClientBuilderParams ioTApiClientBuilderParams = new IoTApiClientBuilderParams();
ioTApiClientBuilderParams.setAppKey("123456");
ioTApiClientBuilderParams.setAppSecret("abcdefghijklmn");
SyncApiClient syncApiClient = new SyncApiClient(ioTApiClientBuilderParams);
IoTApiRequest request = new IoTApiRequest();//设置api的版本
request.setApiVer("1.0.0"); // 接口参数
request.putParam("vendorParkId","2947297626687");
request.putParam("spaceType",0);
request.putParam("charge", 0);
request.putParam("inOutInfo", "114.32,39.23,0;114.35,39.25,1");
request.putParam("openType", 0);//请求参数域名、path、request
ApiResponse response = syncApiClient.postBody("aprk-api-pre.aliplus.com", "/park/isv/v1/park/amap/apply", request);
System.out.println("response code = " + response.getCode()
+ " response content = " + new String(response.getBody(), "utf-8"));
响应示例
{
"code": 200,
"data": {},
"message": "success"
}
HTTP Client调用的方式
请求示例
{
"id":"5e1c0fbc-acdb-4c47-9846-7fc9beedbe14",
"params":{
"vendorParkId": "2947297626687",
"spaceType": 0,
"charge": 0,
"inOutInfo": "114.32,39.23,0;114.35,39.25,1",
"openType": 0
},
"request":{
"apiVer":"1.0.0"
},
"version":"1.0"
}
响应示例
{
"code": 200,
"data": {},
"message": "success"
}