## 全國停車場實時數據查詢（停售）  > 提供全國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": [ "成都市", "徐州市", "廈門市", "洛陽市", "常州市", "長春市", "三亞市", "揚州市", "廣州市", "南通市", "秦皇島市", "南京市", "珠海市", "哈爾濱市", "大連市", "吉林市", "蘇州市", "銀川市", "海口市", "昆明市", "石家莊市", "湛江市", "佛山市", "武漢市", "汕頭市", "南昌市", "蕪湖市", "太原市", "福州市", "西寧市", "九江市", "東莞市", "貴陽市", "臨沂市", "馬鞍山市", "青島市", "濰坊市", "合肥市", "河池市", "無錫市", "唐山市", "沈陽市", "宜昌市", "南寧市", "淄博市", "柳州市", "溫州市", "濟南市", "呼和浩特市", "西安市", "中山市", "杭州市", "鄭州市", "長沙市", "桂林市", "惠州市", "深圳市", "蘭州市", "寧波市", "梧州市", "上海市", "天津市", "重慶市", "北京市" ] } } ```