全国停车场实时数据查询
最后更新于：2022-04-02 08:23:26
## 全国停车场实时数据查询（停售）
> 提供全国60个城市10万个停车场实时数据的查询（包含停车场位置，车位数，剩余车位、费用等信息） 共包含四个接口：查询指定城市停车场信息列表、查询周边停车场信息列表、获取停车场详情信息以及获取开放停车场查询的城市列表。
### 功能介绍/ Introduction
1. 根据经纬度查询周边停车场实时数据
2. 覆盖全国60个城市10万个停车场实时数据
3. 数据包含停车场位置，车位数，剩余车位、费用等信息
适用于共享出行、货运平台、车主服务平台等提供给用户查询附近停车场信息，作为增值服务提升活跃度与粘性。
## 接口费用（ [点击购买](https://market.topthink.com/product/313)）
> 最低 0.1元/次
## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)）
## 接口1：查询指定城市停车场信息列表
### 请求地址
```
GET https://api.topthink.com/park/query
```
### 请求参数
| 名称 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| appCode| 是| string|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) |
| cityName | 是 | string | 城市名称(名称严格匹配，目前支持如下城市：成都市, 徐州市, 厦门市, 洛阳市, 常州市, 长春市, 三亚市, 扬州市, 广州市, 南通市, 秦皇岛市, 南京市, 珠海市, 哈尔滨市, 大连市, 吉林市, 苏州市, 银川市, 海口市, 昆明市, 石家庄市, 湛江市, 佛山市, 武汉市, 汕头市, 南昌市, 芜湖市, 太原市, 福州市, 西宁市, 九江市, 东莞市, 贵阳市, 临沂市, 马鞍山市, 青岛市, 潍坊市, 合肥市, 河池市, 无锡市, 唐山市, 沈阳市, 宜昌市, 南宁市, 淄博市, 柳州市, 温州市, 济南市, 呼和浩特市, 西安市, 中山市, 杭州市, 郑州市, 长沙市, 桂林市, 惠州市, 深圳市, 兰州市, 宁波市, 梧州市, 上海市, 天津市, 重庆市, 北京市) |
| currentPage | 是 | int | 当前页码 |
| pageSize | 是 | int | 分页大小（单次最多返回100条记录） |
### 返回`data`参数
| 名称 | 类型 | 说明 |
|---|---|---|
| parkInfoList | array | 停车场信息列表 |
| parkId | int | 停车场Id |
| parkUUId | string | 停车场UUID |
| name | string | 停车场名称 |
| parkType | string | 停车场类型 |
| provinceName | string | 省份名 |
| cityName | string | 城市名 |
| areaName | string | 区域名 |
| address | string | 地址 |
| longitude | double | 经度 |
| latitude | double | 纬度 |
| total | int | 总车位数 |
| leftNum | int | 剩余车位数 |
| price | double | 价格 |
| priceUnit | string | 价格单位 |
| priceDesc | string | 收费描述 |
| picUrlList | array | 停车场图片列表 |
| isDestine | string | 是否可预订，1-可预订，2-不可预订 |
| reservePrice | double | 预订价格 |
| page | object | 分页对象 |
| currentPage | int | 当前页码 |
| pageSize | int | 分页大小 |
| totalCount | int | 总记录数 |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->parkQuery()
->withCityName('苏州市')
->withCurrentPage(1)
->withPageSize(10)
->request();
dump($result);
```
返回结果示例:
```
{
"code": 0,
"message": "成功",
"data":{
"parkInfoList": [
{
"parkId": 136548,
"parkUUId": "ff80808147ba04020147ba69feb5213f",
"name": "江宙路停车场",
"parkType": "商业",
"provinceName": "江苏省",
"cityName": "苏州市",
"areaName": "吴中区",
"address": "江苏省苏州市吴中区新苏路18号",
"longitude": 120.655068,
"latitude": 31.340772999999999,
"total": 66,
"leftNum": 3,
"price": 6,
"priceUnit": "元/首小时",
"priceDesc": "10分钟内免费，首小时6元，后每小时4元。最高34元。",
"picUrlList": [
],
"isDestine": "2",
"reservePrice": null
},
{
"parkId": 136649,
"parkUUId": "ff80808147ba04020147ba6a02a22209",
"name": "苏州海宁皮革城地下停车场",
"parkType": "商业",
"provinceName": "江苏省",
"cityName": "苏州市",
"areaName": "吴中区",
"address": "江苏省苏州市吴中区糖坊湾支路",
"longitude": 120.648968,
"latitude": 31.334844,
"total": 125,
"leftNum": 10,
"price": 6,
"priceUnit": "元/首小时",
"priceDesc": "半小时内免费，首小时6元，后每小时4元，最高34元。",
"picUrlList": [
"http://api.soargift.com:8998/photo/park/ff80808146f680790146fae491602116.jpg",
"http://api.soargift.com:8998/photo/park/ff80808146f680790146fb6858f13b99.jpg"
],
"isDestine": "2",
"reservePrice": null
}
],
"page": {
"currentPage": 1,
"pageSize": 2,
"totalCount": 1365
}
}
```
## 接口2：查询周边停车场信息列表
### 请求地址
```
GET https://api.topthink.com/park/nearby
```
### 请求参数
| 名称 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| appCode| 是| string|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) |
| longitude | 是 | double | 经度（采用百度地图坐标系） |
| latitude | 是 | double | 纬度（采用百度地图坐标系） |
| distance | 是 | int | 距离，单位：米 |
| currentPage | 是 | int | 当前页码 |
| pageSize | 是 | int | 分页大小（单次最多返回100条记录） |
### 返回`data`参数
| 名称 | 类型 | 说明 |
| --- | --- | --- |
| parkDistanceList | array | 停车场及距离信息列表 |
| parkId | int | 停车场Id |
| parkUUId | string | 停车场UUID |
| name | string | 停车场名称 |
| parkType | string | 停车场类型 |
| provinceName | string | 省份名 |
| cityName | string | 城市名 |
| areaName | string | 区域名 |
| address | string | 地址 |
| longitude | double | 经度 |
| latitude | double | 纬度 |
| total | int | 总车位数 |
| leftNum | int | 剩余车位数 |
| price | double | 价格 |
| priceUnit | string | 价格单位 |
| priceDesc | string | 收费描述 |
| picUrlList | array | 停车场图片列表 |
| isDestine | string | 是否可预订，1-可预订，2-不可预订 |
| reservePrice | double | 预订价格 |
| distance | double | 停车场距离请求坐标点的距离，单位：米 |
| page | object | 分页对象 |
| currentPage | int | 当前页码 |
| pageSize | int | 分页大小 |
| totalCount | int | 总记录数 |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->parkNearBy()
->withLongitude(120.65)
->withLatitude(31.34)
->withDistance(500)
->withCurrentPage(1)
->withPageSize(10)
->request();
dump($result);
```
返回结果示例:
```
{
"code": 0,
"message": "成功",
"data":{
"parkDistanceList": [
{
"parkId": 136548,
"parkUUId": "ff80808147ba04020147ba69feb5213f",
"name": "江宙路停车场",
"parkType": "商业",
"provinceName": "江苏省",
"cityName": "苏州市",
"areaName": "吴中区",
"address": "江苏省苏州市吴中区新苏路18号",
"longitude": 120.655068,
"latitude": 31.340772999999999,
"total": 66,
"leftNum": 3,
"price": 6,
"priceUnit": "元/首小时",
"priceDesc": "10分钟内免费，首小时6元，后每小时4元。最高34元。",
"picUrlList": [
"http://api.soargift.com:8998/photo/park/ff80808146f680790146fae491602116.jpg",
"http://api.soargift.com:8998/photo/park/ff80808146f680790146fb6858f13b99.jpg"
],
"isDestine": "2",
"reservePrice": null,
"distance": 489
}
],
"page": {
"currentPage": 1,
"pageSize": 10,
"totalCount": 1
}
}
}
```
## 接口3：获取停车场详情信息
### 请求地址
```
GET https://api.topthink.com/park/info
```
### 请求参数
| 名称 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| appCode| 是| string|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) |
| parkId | 否 | int | 停车场Id，(parkId,parkUUId二选一) |
| parkUUId | 否 | string | 停车场UUID，(parkId,parkUUId二选一) |
### 返回`data`参数
| 名称 | 类型 | 说明 |
| --- | --- | --- |
| parkInfo | object | 停车场信息 |
| parkId | int | 停车场Id |
| parkUUId | string | 停车场UUID |
| name | string | 停车场名称 |
| parkType | string | 停车场类型 |
| provinceName | string | 省份名 |
| cityName | string | 城市名 |
| areaName | string | 区域名 |
| address | string | 地址 |
| longitude | double | 经度 |
| latitude | double | 纬度 |
| total | int | 总车位数 |
| leftNum | int | 剩余车位数 |
| price | double | 价格 |
| priceUnit | string | 价格单位 |
| priceDesc | string | 收费描述 |
| picUrlList | array | 停车场图片列表 |
| isDestine | string | 是否可预订，1-可预订，2-不可预订 |
| reservePrice | double | 预订价格 |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->parkInfo()
->withParkId(136548)
->withParkUUId('ff80808147ba04020147ba69feb5213f')
->request();
dump($result);
```
返回结果示例:
```
{
"code": 0,
"message": "成功",
"data":{
"parkInfo": {
"parkId": 136548,
"parkUUId": "ff80808147ba04020147ba69feb5213f",
"name": "江宙路停车场",
"parkType": "商业",
"provinceName": "江苏省",
"cityName": "苏州市",
"areaName": "吴中区",
"address": "江苏省苏州市吴中区新苏路18号",
"longitude": 120.655068,
"latitude": 31.340772999999999,
"total": 66,
"leftNum": 3,
"price": 6,
"priceUnit": "元/首小时",
"priceDesc": "10分钟内免费，首小时6元，后每小时4元。最高34元。",
"picUrlList": [
"http://api.soargift.com:8998/photo/park/ff80808146f680790146fae491602116.jpg",
"http://api.soargift.com:8998/photo/park/ff80808146f680790146fb6858f13b99.jpg"
],
"isDestine": "2",
"reservePrice": null
}
}
}
```
## 接口4：获取开放停车场查询的城市列表
### 请求地址
```
GET https://api.topthink.com/park/city_list
```
### 请求参数
无
### 返回`data`参数
| 名称 | 类型 | 说明 |
| --- | --- | --- |
| cityList| array| 城市列表|
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->parkCityList()
->request();
dump($result);
```
返回结果示例:
```
{
"code": 0,
"message": "成功",
"data":{
"cityList": [
"成都市",
"徐州市",
"厦门市",
"洛阳市",
"常州市",
"长春市",
"三亚市",
"扬州市",
"广州市",
"南通市",
"秦皇岛市",
"南京市",
"珠海市",
"哈尔滨市",
"大连市",
"吉林市",
"苏州市",
"银川市",
"海口市",
"昆明市",
"石家庄市",
"湛江市",
"佛山市",
"武汉市",
"汕头市",
"南昌市",
"芜湖市",
"太原市",
"福州市",
"西宁市",
"九江市",
"东莞市",
"贵阳市",
"临沂市",
"马鞍山市",
"青岛市",
"潍坊市",
"合肥市",
"河池市",
"无锡市",
"唐山市",
"沈阳市",
"宜昌市",
"南宁市",
"淄博市",
"柳州市",
"温州市",
"济南市",
"呼和浩特市",
"西安市",
"中山市",
"杭州市",
"郑州市",
"长沙市",
"桂林市",
"惠州市",
"深圳市",
"兰州市",
"宁波市",
"梧州市",
"上海市",
"天津市",
"重庆市",
"北京市"
]
}
}
```
';