[关闭]
@zushuxin 2017-07-13T09:33:11.000000Z 字数 7707 阅读 192

logo

北京停简单信息技术有限公司

xlshlr

停简单-停车场基本信息接口文档-高德机车

约定

接口如无特殊说明，遵照以下规范。

1. 时间格式约定 "yyyy-MM-dd HH:mm:ss SSS"、"yyyy-MM-dd HH:mm:ss"、"yyyy-MM-dd"、"HH:mm:ss"
2. 金额格式统一为:(最大9位).(最多2位)。需要通过此正则表达式^((([1-9]{1}\d{0,9}))|([0]{1}))((\.(\d){2}))?$。
3. 需要分页时，分页参数start、limit都必须传递，传递一个不会生效

开放平台

开放平台接入规范

签名生成的通用步骤如下:

设所有发送或者接收到的数据为集合M，将集合M内非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA。 特别注意以下重要规则:
* 参数名ASCII码从小到大排序（字典序）；
* 参数名区分大小写；
* sign和signType和空值参数不参与签名
* 传递参数的值中如果存在特殊字符（如:&、@等），那么该值需要做URL Encoding，这样请求接收方才能接收到正确的参数。此时，待签名数据应该是原始值而不是encoding之后的值。 举例:

例:假设传送的参数如下: appid: tjd930ea5d5a258f4f charset:utf-8 service:tcwindows.Park.getParkInfo timestamp:2016-04-01 12:11:11 version:1.0
1. 对参数按照key=value的格式，并按照参数名ASCII字典序排序如下: stringA="appid=tjd930ea5d5a258f4f&charset=utf-8&service=tcwindows.Park.getParkInfo=1000×tamp=2016-04-01 12:11:11&version=1.0&.............";
2. 拼接API密钥: stringSignTemp="stringA192006250b4c09247ec02edce69f6a2d"
3. md5签名得到最终sign sign=MD5(stringSignTemp)="9A0A8659F005D6984697E2CA0A9CF3B7"

开放平台接入接口

  1. 描述
  2. URL
  3. 请求参数列表
参数 类型 长度 是否必须 名称 备注
version string Y 调用的接口版本 固定为:1.0
sign string Y 请求参数的签名串 详见签名
partner string Y 合作者key
timestamp string Y 发送请求时间 格式" yyyy-MM-dd HH:mm:ss"
charset string Y 字符集 如utf-8,gbk
signType string Y 签名类型 目前仅支持md5
service string Y 接口名称 需要调用的接口名称

4. 响应参数列表

参数 类型 长度 是否必须 名称 备注
timestamp string Y 响应时间 格式"yyyy-MM-dd HH:mm:ss"
returnCode string Y 开放平台返回状态码 T代表成功，F代表失败
returnMsg string Y 开放平台返回信息 OK代表成功，其它为开放平台失败信息
isSuccess string Y 实际业务处理结果 true代表成功，false代表失败
msg string N 实际业务处理结果备注 业务失败时会描述失败原因

服务器调用事例：

  1.         String key="e1bbd6c374dc428697fe4a6d9fb16dd5";  --开发者秘钥
  2.         SortedMap<String, String> map = new TreeMap<String, String>();
  3.         map.put("signType","md5");
  4.         map.put("partner","ef4f7deba25941fcab5709f1f865ca3c");
  5.         map.put("service","tcpark.pmPark.getParkInfoListByGeo");
  6.         map.put("charset","utf-8");
  7.         map.put("version","1.0");
  8.         map.put("start","0");
  9.         map.put("limit","5");
  10.         map.put("timestamp", DateUtils.currentDatetime());
  11.         /*签名*/
  12.         String sign= SignUtil.md5Sign(map, key, "UTF-8");
  13.         String url="http://prep.tingjiandan.com/openapi/gateway"; --测试环境开放平台访问地址
  14.         map.put("sign",sign);
  15.         String result= HttpClient.sendRequestByPost(url, JsonUtil.objectToJson(map), true);
  16.         System.out.println(result);

分页查询停车场基本信息列表

参数 类型 长度 是否必须 名称 备注
start string N 分页参数，数据开始位置 pmParkId为空时该参数必传
limit string N 分页参数，数据结束位置，最多查询1000条 pmParkId为空时该参数必传
pmParkId string N 停车场ID
pmParkName string N 停车场名称 精确查询
pmParkNameLike string N 停车场名称 模糊查询

* 响应参数列表

参数 类型 长度 是否必须 名称 备注
timestamp string 响应时间
returnCode string 响应码
returnMsg string 响应描述
isSuccess string 请求是否成功 true 成功，false 失败
totalCount string 记录总条数
parkList array{object} 停车场列表
pmParkId string 停车场ID
parkName string 停车场名称
provinnce string 所在省份
city string 所在城市
district string 所在区县
parkType string 停车场类型 停车场车位类型(1、占道 2、路外开放 3、路外封闭 4、地下)
category string 停车场收费类型 0、免费 1、收费 2、限免
isOnlinePay string 是否支持在线支付 0是，1否
standardCount string 停车场备案车位数
maxCount string 停车场划线车位数
restCount string 停车场剩余车位数
address string 地址
longitude string 停车场经度-百度地图
latitude string 停车场纬度-百度地图
wLongitude string 停车场经度-W84坐标
wLatitude string 停车场纬度-W84坐标
parkExits array{object} 出入口列表
longitude string 停车场出入口经度-百度地图
latitude string 停车场出入口纬度-百度地图
wLongitude string 停车场出入口经度-W84坐标
wLatitude string 停车场出入口纬度-W84坐标
exitNo string 停车场出入口名称
exitType string 停车场出入口类型 0、出口 1、入口 2、出入口
parktolls array{object} 停车场收费规则集合
carNumColor string 车牌号颜色 blue 蓝色，black 黑色，yellow 黄色
dayFeeStartTime string 白天收费开始时间
dayFeeEndTime string 白天收费结束时间
dayFirstTime string 日间首个收费区间时长 单位：分钟
dayFirstHour string 日间首个收费区间计费 单位：元
dayFirstMinTime string 日间首个收费区间内最小收费区间时长 单位：分钟
dayFirstMinAmount string 日间首个收费区间内最小收费区间计费 单位：元
dayOtherHour string 日间首个收费区间外计费 单位：元
dayOtherMinTime string 日间首个收费区间外最小收费区间时长 单位：分钟
dayOtherMinAmount string 日间首个收费区间外最小收费区间计费 单位：元
nightFeeStartTime string 夜间收费开始时间
nightFeeEndTime string 夜间收费结束时间
nightFirstTime string 夜间首个收费区间时长 单位：分钟
nightFirstHour string 夜间首个收费区间计费 单位：元
nightFirstMinTime string 夜间首个收费区间内最小收费区间时长 单位：分钟
nightFirstMinAmount string 夜间首个收费区间内最小收费区间计费 单位：元
nightOtherHour string 夜间首个收费区间外计费 单位：元
nightOtherMinTime string 夜间首个收费区间外最小收费区间时长 单位：分钟
nightOtherMinAmount string 夜间首个收费区间外最小收费区间计费 单位：元
maxAmount string 收费金额上限 单位：元

* 响应参数事例：

  1. {
  2.     "timestamp": "2017-05-11 16:00:38 255",
  3.     "returnCode": "T",
  4.     "totalCount": "3",
  5.     "returnMsg": "OK",
  6.     "isSuccess": "true",
  7.     "parkList": [
  8.         {
  9.             "pmParkId": "053b6f4dadda4ab7a859d6a085d2ccf1",
  10.             "parkName": "青岛市市级机关新浦路停车场",
  11.             "category": "1",
  12.             "isOnlinePay": "0",
  13.             "maxCount": "300",
  14.             "standardCount": "260",
  15.             "restCount": "241",
  16.             "provinnce": "山东省",
  17.             "city": "青岛市",
  18.             "district": "市南区",
  19.             "address": "青岛市市南区新浦路9号",
  20.             "longitude": "120.391093",
  21.             "latitude": "36.073982",
  22.             "parkType": "3",
  23.             "wLongitude": "120.384631",
  24.             "wLatitude": "36.067883",
  25.             "parktolls": [
  26.                 {
  27.                     "carNumColor": "blue",
  28.                     "dayFeeStartTime": "070000",
  29.                     "dayFeeEndTime": "210000",
  30.                     "dayFirstTime": "60",
  31.                     "nightFirstTime": "60",
  32.                     "dayFirstHour": "4.0",
  33.                     "dayFirstMinTime": "60",
  34.                     "dayFirstMinAmount": "4.0",
  35.                     "dayOtherHour": "4.0",
  36.                     "dayOtherMinTime": "60",
  37.                     "dayOtherMinAmount": "4.0",
  38.                     "nightFeeStartTime": "210000",
  39.                     "nightFeeEndTime": "070000",
  40.                     "nightFirstHour": "4.0",
  41.                     "nightFirstMinTime": "60",
  42.                     "nightFirstMinAmount": "4.0",
  43.                     "nightOtherHour": "4.0",
  44.                     "nightOtherMinTime": "60",
  45.                     "nightOtherMinAmount": "4.0",
  46.                     "maxAmount": "20.0"
  47.                 }
  48.             ],
  49.             "parkExits": [
  50.                 {
  51.                     "exitNo": "青岛市市级机关新浦路停车场中门出入口",
  52.                     "exitType": "2",
  53.                     "longitude": "120.391093",
  54.                     "latitude": "36.073982",
  55.                     "wLongitude": "120.384631",
  56.                     "wLatitude": "36.067883"
  57.                 },
  58.                 {
  59.                     "exitNo": "青岛市市级机关新浦路停车场东门出入口",
  60.                     "exitType": "2",
  61.                     "longitude": "120.391748",
  62.                     "latitude": "36.073698",
  63.                     "wLongitude": "120.385282",
  64.                     "wLatitude": "36.067611"
  65.                 },
  66.                 {
  67.                     "exitNo": "青岛市市级机关新浦路停车场西门出入口",
  68.                     "exitType": "2",
  69.                     "longitude": "120.390446",
  70.                     "latitude": "36.073829",
  71.                     "wLongitude": "120.383987",
  72.                     "wLatitude": "36.067719"
  73.                 }
  74.             ]
  75.         },
  76.         {
  77.             "pmParkId": "09dd128d287743d7809076a70ff9b81c",
  78.             "parkName": "青岛市中海国际社区商业网点A区停车场",
  79.             "category": "1",
  80.             "isOnlinePay": "0",
  81.             "maxCount": "150",
  82.             "standardCount": "260",
  83.             "restCount": "14",
  84.             "provinnce": "山东省",
  85.             "city": "青岛市",
  86.             "district": "李沧区",
  87.             "address": "青岛市李沧区玉液泉路",
  88.             "longitude": "120.436535",
  89.             "latitude": "36.160337",
  90.             "parkType": "3",
  91.             "wLongitude": "120.429752",
  92.             "wLatitude": "36.154555",
  93.             "parktolls": [
  94.                 {
  95.                     "carNumColor": "blue",
  96.                     "dayFeeStartTime": "070000",
  97.                     "dayFeeEndTime": "210000",
  98.                     "dayFirstTime": "60",
  99.                     "nightFirstTime": "60",
  100.                     "dayFirstHour": "4.0",
  101.                     "dayFirstMinTime": "60",
  102.                     "dayFirstMinAmount": "4.0",
  103.                     "dayOtherHour": "4.0",
  104.                     "dayOtherMinTime": "60",
  105.                     "dayOtherMinAmount": "4.0",
  106.                     "nightFeeStartTime": "210000",
  107.                     "nightFeeEndTime": "070000",
  108.                     "nightFirstHour": "4.0",
  109.                     "nightFirstMinTime": "60",
  110.                     "nightFirstMinAmount": "4.0",
  111.                     "nightOtherHour": "4.0",
  112.                     "nightOtherMinTime": "60",
  113.                     "nightOtherMinAmount": "4.0",
  114.                     "maxAmount": "20.0"
  115.                 }
  116.             ],
  117.             "parkExits": []
  118.         },
  119.         {
  120.             "pmParkId": "0c43fccf36374f1983dc8455b30e63b6",
  121.             "parkName": "青岛市东方花园停车场",
  122.             "category": "1",
  123.             "isOnlinePay": "0",
  124.             "maxCount": "128",
  125.             "standardCount": "260",
  126.             "restCount": "71",
  127.             "provinnce": "山东省",
  128.             "city": "青岛市",
  129.             "district": "市南区",
  130.             "address": "青岛黄岛区经济技术开发区阿里山路138号",
  131.             "longitude": "120.200318",
  132.             "latitude": "35.965108",
  133.             "parkType": "3",
  134.             "wLongitude": "120.193753",
  135.             "wLatitude": "35.959383",
  136.             "parktolls": [
  137.                 {
  138.                     "carNumColor": "blue",
  139.                     "dayFeeStartTime": "090000",
  140.                     "dayFeeEndTime": "210000",
  141.                     "dayFirstTime": "60",
  142.                     "nightFirstTime": "60",
  143.                     "dayFirstHour": "0.0",
  144.                     "dayFirstMinTime": "60",
  145.                     "dayFirstMinAmount": "0.0",
  146.                     "dayOtherHour": "0.0",
  147.                     "dayOtherMinTime": "60",
  148.                     "dayOtherMinAmount": "0.0",
  149.                     "nightFeeStartTime": "210000",
  150.                     "nightFeeEndTime": "090000",
  151.                     "nightFirstHour": "1.0",
  152.                     "nightFirstMinTime": "60",
  153.                     "nightFirstMinAmount": "1.0",
  154.                     "nightOtherHour": "1.0",
  155.                     "nightOtherMinTime": "60",
  156.                     "nightOtherMinAmount": "1.0",
  157.                     "maxAmount": "0.0"
  158.                 }
  159.             ],
  160.             "parkExits": [
  161.                 {
  162.                     "exitNo": "A出入口",
  163.                     "exitType": "2",
  164.                     "longitude": "120.200322",
  165.                     "latitude": "35.965111",
  166.                     "wLongitude": "120.193765",
  167.                     "wLatitude": "35.959375"
  168.                 }
  169.             ]
  170.         }
  171.     ]
  172. }

根据停车场id查询停车场实时车位信息

参数 类型 长度 是否必须 名称 备注
pmParkId string Y 停车场id

* 响应参数列表

参数 类型 长度 是否必须 名称 备注
timestamp string 响应时间
returnCode string 响应码
returnMsg string 响应描述
isSuccess string 请求是否成功 true 成功，false 失败
totalCount string 记录数总数量
pmRealTimePark Map{object} 实时车位数信息
pmParkId string 停车场ID
standardCount string 停车场备案车位数
maxCount string 停车场划线车位数
restCount string 停车场剩余车位数

* 响应参数事例：

  1. {
  2.     "timestamp": "2017-05-11 16:00:38 255",
  3.     "returnCode": "T",
  4.     "returnMsg": "OK",
  5.     "isSuccess": "true",
  6.     "pmRealTimePark": 
  7.         {
  8.             "restCount": "14",
  9.             "pmParkId": "09dd128d287743d7809076a70ff9b81c",
  10.             "standardCount": "150",
  11.             "maxCount": "150"
  12.         }
  13. }
添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注