## 全国停车场实时数据查询 ![](https://img.kancloud.cn/ff/39/ff3970b5eae1bd8e774cd0b24dff2191_200x200.png) > 提供全国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": [ "成都市", "徐州市", "厦门市", "洛阳市", "常州市", "长春市", "三亚市", "扬州市", "广州市", "南通市", "秦皇岛市", "南京市", "珠海市", "哈尔滨市", "大连市", "吉林市", "苏州市", "银川市", "海口市", "昆明市", "石家庄市", "湛江市", "佛山市", "武汉市", "汕头市", "南昌市", "芜湖市", "太原市", "福州市", "西宁市", "九江市", "东莞市", "贵阳市", "临沂市", "马鞍山市", "青岛市", "潍坊市", "合肥市", "河池市", "无锡市", "唐山市", "沈阳市", "宜昌市", "南宁市", "淄博市", "柳州市", "温州市", "济南市", "呼和浩特市", "西安市", "中山市", "杭州市", "郑州市", "长沙市", "桂林市", "惠州市", "深圳市", "兰州市", "宁波市", "梧州市", "上海市", "天津市", "重庆市", "北京市" ] } } ```