DSS-H平台停车场接口(webservice)

1、停车场 web 接 口文档1.停车场 webservice 接口与第三方物业相关的接口，主要用于向外提供数据；1.1接口说明接口规范采用SOPA协议参数以及返回结构采用JSON格式；服务地址停车场接口 WSDL:端口 /admin/services/ThirdPartyServicewsdl反向寻车接口 Wsdl:端口 /admin/services/FindCarServicewsdl1.2接口详情停车场信息查询(编号、名称)接口名称： getParkinglot(StringconditionJson,StringpagerJson)；请求参数：conditionJson , pagerJ

2、son分另U为 json字符串；例：conditionJsonjson字符串格式"parkingLotCode":"dr1213", "parkingLot":"dr"名称类型必填备注parkingLotCodeString否车场编号parkingLotString否车场名称备注：如果不需要设置条件，传入空字符串即可例：pagerJsonjson 字符串格式"pageSize":10,"curre ntPage":1名称类型必填备注currentPageInt否页码pageS

3、izeInt否每页显示数目备注：如果不需要分页而查询所有记录，传入空字符串即可返回结果：例"pager": "totalPage":0, "currentPage":1, "previousPage":0, "nextPage":0, "pageSize":10, "total":1, "pageListSize":8,"arrayList":"id":1,"parkingLot&quo

4、t;:"dh","parkingLotCode":"A1","totalLot":1000,"idleLot":6,"defaultProvince":"31","fullDeal":1,"isAutoControl":0,"isAutoOnSluice":0,"isOutAutoOnSluice":0,"discernMode":1,"isMon

5、thlyAutoExit":1,"isFreeAutoExit":1,"attribute6":"1","unknownCarExitMode":1,"updateDate":"Apr2,201510:06:40AM", "feeRuleldList":"1","1","1", "idleLotCountMode":1,"specialCar":&

6、quot;","inMatchByte":"","outMatchByte":"","isUnlnteriorAutoAlarm":1,"attribute1":"","attribute2":"0","attribute3":"","attribute4":"0"名称类型备注totalPageInt总页数currentPage

7、Int当前页previousPageIntnextPageIntpageSizeInt每页条数totalInt总条数pageListSizeIntidLongparkingLotString车场名称parkingLotCodeString车场编号totalLotLong总车位idleLotLong余位defaultprovinceString默认省份fullDealInteger车场满位后处理isAutoControlInteger道闸是否自动控制isAutoOnSluiceInteger内部车是否自动放行isOutAutoOnSluiceInteger外部车是否自动放行discernMode

8、Integer识别模式：1-车牌识别为主，2-刷卡识别为主isMonthlyAutoExitInteger月卡用户自动放行：0-否，1-是isFreeAutoExitInteger收费为零自动放行：0-否，1-是attribute6String冗余属性6unknownCarExitModeInteger未识别车辆放行模式：1-自动放行，2-按最低金额收费updateDateDate更新时间feeRuleIdListList用户类别收费规则关联IDidleLotCountModeInteger余位计算方式specialCarInteger特殊车辆inMatchByteString入口关心匹配字符

9、outMatchByteString出口关心匹配字符isUnlnteriorAutoAlarmInteger非内部车进行报警attribute1String冗余属性1attribute2String冗余属性2attribute3String冗余属性3attribute4String冗余属性4车位信息(编号、停车场区域、摄像头编号、VIP车牌号)接口名称：getPark in gs(Stri ngcon diti onJson, Stri ngpagerJs on)请求参数：conditionJson , pagerJson分另U为 json字符串；例：conditionJsonjson字符串格

10、式"carportCode":"P001","channelld":"100001$1$1$0","carNum":"12","carportName":"车位 1","carportStatus":"1"名称类型必填备注carportCodeString否车位编号channelIdString否车位与探测器关联时关 联的探测器ID，用于区 域类型为车位的情况carNumString否车位配置的专

11、用车辆车牌，用逗号分隔carportNameString否车位名称carportStatusString否是否停车:1-已停车，2-未停车；备注：carportCode、carportName、carportStatus 为一组输入参数，进行查询时每一项 都允许为空，若该组参数有一个不为空，channelId、carNum请勿选择，否则查询冲突。channelId进行查询时，其它输入参数请勿选择，否则查询冲突。carNum 进行查询时，其它输入参数请勿选择，否则查询冲突。例：pagerJsonjson 字符串格式"pageSize":10,"currentPage

12、":1名称类型必填备注currentPageInt否页码pageSizeInt否每页显示数目备注：如果不需要分页而查询所有记录，传入空字符串即可返回结果：例"pager":"totalPage":0,"currentPage":1,"previousPage":0,"nextPage":0,"pageSize":10,"total":4,"pageListSize":8,"arrayList":"

13、id":1,"carportCode":"1","carportName":"1","carportShape"carportAllocation":"0","carportStatus":"2","mapId"memo":"","carportCenterX"carportCenterY"carportType":"

14、1","carAreaType":"0", "parkingLotld":1,"channelld":"1000169$1$0$0" ,"errorcode":""名称类型备注totalPageInt总页数currentPageInt当前页码previousPageIntnextPageIntpageSizeInt每页条数totalInt总条数pageListSizeIntIdLongcarportCodeString车位编号，可以为字符；唯一编

15、码carportNameString车位名称carportShapeString车位形状carportAllocationString是否分配：0-未分配；1-已分配carportStatusString是否停车：1-已停车，2-未停车；mapIdLong车位图层memoString备注carportCenterXString车位中心点的X值carportCenterYString车位中心点的Y值carportTypeString车位类型carAreaTypeString是否是停车区域parkingLotIdLong所属的停车场IDchannelIdString车位与探测器关联时关联的探测 器

16、ID,用于区域类型为车位的情况errorcodeString错误信息（1 :通过车位名称、车位编号、车位状态这组参数进行查询时，摄像头编号或车牌号请勿选 择！ 2:请选择摄像头编号或车牌 号其中一项进行查询，以免发生查 询冲突。）二维码定位信息接口名称： getSemacodeList(Stri ngpagerJs on) 请求参数：pagerJson为json字符串；例：pagerJsonjson 字符串格式"pageSize":10,"curre ntPage":1名称类型必填备注currentPageInt否页码pageSizeInt否每页显示数目

17、备注：如果不需要分页而查询所有记录，传入空字符串即可返回结果：例"pager": "totalPage":O, "currentPage":1, "previousPage":0, "nextPage":O, "pageSize":10, "total":2, "pageListSize":8,"arrayList":"id":1,"serialNumber":"23

18、234","mapld"gpsX"gpsY"memo":""名称类型备注totalPageInt总页数currentPageInt当前页码previousPageIntnextPageIntpageSizeInt每页条数totalInt总条数pageListSizeIntidLongserialNumberString二维码序列号mapIdLong二维码所在地图gpsXString二维码在地图上的横坐标gpsYString二维码在地图上的纵坐标memoString二维码描述；查询设备通道信息接口名称： getEnc

19、oderChannel(StringconditionJson,StringpagerJson); 请求参数： conditionJson , pagerJson分另U为 json字符串；例：conditionJsonjson字符串格式"category"","type":2名称类型必填备注categoryString是设备种类typeString否设备类型备注：Category和type作为一组参数，不能分开查询，查询时两个参数都要同时赋值；Category是整形，不允许为空，如果要查询所有通道信息时，设置category为0，type 为空

20、。例如："category":"0","type":""例：pagerJsonjson 字符串格式"pageSize":10,"currentPage":1名称类型必填备注currentPageInt否页码pageSizeInt否每页显示数目备注：如果不需要分页而查询所有记录，传入空字符串即可返回结果：例"arrayList":"code":"1000000$1$0$0","errCode":&q

21、uot;"名称类型备注nameString通道名称codeString设备编码errCodeString错误信息(设备种类不为0时，请输 入设备类型，设备类型不为空时，设 备种类不能为0,否则查询异常)停车场电子地图反向寻车获取路径信息流程图:开始(1 )通过车牌号获取停车信名称类型必填备注searchJs onString是车牌信息pageJsonString否扩展字段，为分页预留exte ndString否扩展字段，暂时没使用返回结果：格式RspCode:1,RspMsg： xxx,RspData:json 数组Json数组中各对象含义：名称类型备注idInt停车记录的IDcar

22、NumString车牌号carImgUrlString抓拍图片地址URLcarportNameString车位名称parkDateString停车时间carportCodeString车位编码mapIdString停车所在地图IDcarportCenterXString车位位置横坐标carportCenterYString车位位置纵坐标(2 )通过二维码序列号获取二维码的位置接口名称： getLocati on BySerialNumber(Stri ngserialNumber,Stri ngexte nd); 请求参数：serialNumber :二维码序列号格式为;xxxxxx ；ext

23、end扩展字段，暂时没使用例如：10003名称类型必填备注serialNumberString是二维码序列号信息exte ndString否扩展字段，暂时没使用返回结果：格式RspCode:1,RspMsg： xxx,RspData:json 对象、Json数组中各对象含义：名称类型备注mapIdInt二维码所在地图IDpointXString二维码横坐标pointYString二维码纵坐标(3)通过地图的ID获取地图的图片地址URL接口名称：getMaplmgUrlByMapld(Stri ngmapld,Stri ngexte nd); 请求参数：mapld :地图ID格式为：xxxxxx

24、xextend扩展字段，暂时没使用 例如：名称类型必填备注mapIdString是地图IDexte ndString否扩展字段，暂时没使用返回结果：格式RspCode:1,RspMsg： xxx,RspData:json 对象Json数组中各对象含义：名称类型备注imgUrlString地图图片的访问地址 URL(4)获取最短路径接口名称：getRouter(Stri nglocatio ns,Stri ngexte nd);请求参数：locatio ns包含两个点的位置的字符串，格式为：*mapld:xxxx,po in tX:xxxx,po in tY:xxxx,mapld:xxxx,po

25、 in tX:xxxx,po intY :xxxxextend扩展字段，暂时没使用例如：mapId:,poi ntX:mapld:poi ntX:poi ntY:mapId:,poi ntX:,poi ntY:,mapld:poi ntX:poi ntY:mapId:,poi ntX:-,poi ntY:,mapId:poi ntX:,poi ntY:mapId:,poi ntX:,poi ntY:,mapId:,po in tX:,po in tY:1.2.名称类型必填备注locati onsString是包含两个点的位置的字符串exte ndString否扩展字段，暂时没使用返回结果：格式

26、RspCode:1,RspMsg： xxx,RspData:json 数组Json数组中各对象含义：名称类型备注idint点的IDmapIdint二维码所在地图IDpointXString二维码横坐标pointYString二维码纵坐标"carNum":"浙 A8888"10003mapld:poi ntX:poi ntY:,mapld:poi ntX:poi ntY:我写的一个接口getParki ngs也没有数据，你传入参数如下："carportCode":"001","carportName&quo

27、t;:" 车位 1","carportStatus":"1"这组参数任意传那 个都行"cha nn elld":"100001$1$1$0""carNum":"浙 A1002"(5 )获取所有的地图接口StringgetAIIMaps(StringsearchJson,StringpageJson,Stringextend)参数searchJson： 查询json字符串，该接口中目前没用到pageJson： 分页json字符串，该接口中目前没用到exten

28、d : 扩展json字符串，该接口中目前没用到返回成功：1，json数组字符串失败：0返回数据的json数组字段说明序号字段名名称类型长度必须备注1mapId地图ID2name地图名称查询车辆进出场记录接口getCarOutI nHistoryWSDL:端口 /admin/services/ThirdPartyServicewsdl描述根据传入的时间范围参数查询相应的车辆进岀场记录参数名称类型含义startDateString查询起始时间，格式：2015-01-0110:25:33endDateString查询结束时间，格式： 2015-01-0210:25:33返回String，进出场记录列

29、表对应的json字符串?调用示例：getCarOutInHistory( “015-01-0110:25:33 ”，2015-01-0210:25:33 ”);?返回值示例："array":"carNumber":"浙 AAN909","enterDate":"2015-01-0911:19:29.0","enterChannel":"入口"，”exitDate":"2015-01-0911:21:43.0","ex

30、itCha nn el":"出口","cardNumber":"","mo ney":" null","carNumber":"浙AN386Y","e nterDate":"2014-12-2011:19:38.0","e nterCha nn el":"入口"，”exitDate":"2014-12-2011:14:44.0",&quo

31、t;exitChannel":"出口 "，”cardNumber更新道闸系统卡片充值信息接口updateCardsWSDL:端口 /admin/services/ThirdPartyServicewsdl描述从第三方同步卡片充值信息到道闸系统中参数名称类型含义cardInfosString（标准Json字符串）卡片相关信息（支持多张卡）格式为："cardList":"cardNumber":"1000001","mon ey":200,"startTime":&qu

32、ot;2015"en dTime":"2015"updateDate":"2015"cardNumber":"100 "mo ney":300, "startTime":"2015 "en dTime":"2015 "updateDate":"2015 -01 - 0112:30:00",-01 - 3112:30:00",-01 - 0112:30:00",0003

33、",-01 - 0112:30:00",-02 - 1512:30:00",-01 - 0112:30:00"返回int，更新成功返回1，更新失败返回0参数字段说明:cardNumber :卡号money :充值金额startTime :充值有效期起始时间endTime :充值有效期截止时间updateDate :充值时间? 调用示例：updateCards（相应的 jsonString）;更新卡片中的可视对讲门禁功能有效截止日期接口update In tercomCardAvailableDateWSDL:端口 /admin/services/Thir

34、dPartyServicewsdl描述根据传入的卡号和有效截止时间更新相关联所有卡片可视对讲功能的有效截止日期参数名称类型含义cardNumberString卡号endDateStringString物业费缴纳的有效截止日期，格式：2015-02-15返回int，更新成功返回1,更新失败返回0? 调用示例：updateIntercomCardAvailableDate（ “586D5F4” 2015-02-15 ”获取停车场车位总数和余位总数接口名称getParkingSpotCount接口描述获取停车场车位总数和余位总数WSDL:端口 /admin/services/ThirdPartySe

35、rvicewsdl接口方式webservice数据频度实时输入参数字段代码字段名称数据类型非空字段说明无输岀结果（json）字段代码字段名称数据类型非空字段说明totalSpots车位总数NumberYidleSpots余位总数NumberY入参：无返回："totalSpots":100,"idleSpots":1停车信息查询接口接口queryPark inglnfo描述根据传入的车牌号码查询相关车辆停车产生的信息参数名称类型含义carNumJson字符串车牌号码"carNum":"浙 A123456"返回Stri

36、ng ,（标准的json的字符串）对应车辆的停车信息参数字段说明:carNum :车牌号码? 调用示例：queryParkinglnfo（对应的 json 字符串）? 返回值示例："parkCode":"1001",停车场编码"parkName":"XX停车场",停车场名称、"carNum":"浙 A123456",车牌号码"in ParkTime":"2016-4-20",进场时间"parkTime":"

37、123",停车时长"receiableMo ney""20",应缴费用"carI nPicUrl":III!5车辆进场图片"carI nNumPicUrl".III!J车牌号图片"payedMo ney""20"本次停车已缴费用?查询错误时返回为第三方缴费成功的通知接口接口queryPay Info描述传入的参数为车辆缴费的信息参数名称类型含义payInfoJson字符串缴费信息'carNum':'浙 A123456','pa

38、yMo ney':'20','receivableMo ney':'20','queryTime':'2016-05-0112:00:00', 'serialNum':'1OO1'返回String ，（标准json字符串），是否缴费的字符串参数字段说明:carNum :车牌号码， payMo ney:支付金额 receivableMoney:应收金额 queryTime: 缴费时间 serialNum:订单号?调用示例：queryPaylnfo(相应的 json)通知成功时返回值示例:"1","true","