2.1查询附近停车场信息（车主平台到泊链）

## 一、接口信息

- **测试环境接口地址**：https://beta.bolink.club/unionapi/newpark/queryparks
- **正式环境接口地址**：https://s.bolink.club/unionapi/newpark/queryparks
- **接口方向**：车主平台 → 泊链
- **用途**：车主平台调用 2.1 接口向泊链发送请求消息。通过传送参数经纬度、距离、联盟身份 ID 等参数来请求泊链查找在该参数范围内的停车场，泊链返回查找到的信息。

## 二、请求格式

### 请求字段

| 名称 | 类型 | 说明 | 是否必传 | 示例 |
| --- | --- | --- | --- | --- |
| lng | String | 经度 | 是 | 保留 6 位小数：如 123.8744332 |
| lat | String | 纬度 | 是 | 保留 6 位小数：如 40.883323 |
| distance | Number | 距离 | 是 | 单位：米，如 1000，查 1 公里范围内车场，取值范围（100-2000）米 |
| union_id | Number | 联盟身份 ID | 是 | 联盟成员 ID |
| rand | String | 随机数，32 位以内整数或小数，与上次请求不能重复，否则认为是非法请求 | 是 | 0.99993232345436 |

### 请求示例

```json
{
  "data": {
    "rand": "15516731203246",
    "lng": "123.999999",
    "distance": 2000,
    "union_id": 200279,
    "lat": "32.444444"
  },
  "sign": "830498659168C933AE53E32C525EEA46"
}
```

## 三、同步返回格式

### 返回字段

| 名称 | 类型 | 说明 | 是否必传 | 示例 |
| --- | --- | --- | --- | --- |
| state | Number | 状态：0 失败，1 成功 | 是 | 1 |
| count | Number | 数量 | 是 | 返回条数 |
| errmsg | String | 提示信息 | 是 | 查询成功 |
| parks | Json | 车场信息 | 是 | — |
| com_id | Number | 泊链车场编号 | 是 | 308432 |
| name | String | 车场名称 | 是 | 北京上地三街 9 号院停车场 |
| address | String | 地址 | 是 | 北京上地三街 9 号 |
| phone | String | 联系电话 | 是 | 13900944433 |
| lng | string | 经度 | 是 | 保留 6 位小数：如 123.8744332 |
| lat | String | 纬度 | 是 | 保留 6 位小数：如 40.883323 |
| total_plot | Number | 总车位数 | 是 | 120 |
| empty_plot | Number | 空闲车位数 | 是 | 83 |
| price_desc | String | 价格描述 | 是 | 2 元每小时 |
| remark | String | 备注 | 否 | 简要说明 |
| park_union_id | Number | 车场所属厂商编号 | 否 | 200001 |
| park_id | String | 第三方车场编号 | 是 | asw_12121 |

### 返回示例（查询成功）

```json
{
  "parks": [
    {
      "com_id": 308432,
      "park_id": "asw_12121",
      "park_union_id": 200002,
      "name": "北京上地大厦停车场 2",
      "address": "北京上地三街 9 号",
      "phone": "18800001111",
      "lng": "123.999999",
      "lat": "32.444444",
      "total_plot": 122,
      "empty_plot": 34,
      "price_desc": "2 元每小时",
      "remark": "简要说明"
    },
    {
      "com_id": 308828,
      "park_id": "10006",
      "park_union_id": 200301,
      "name": "北京上地三街 9 号院停车场",
      "address": "北京上地三街 9 号",
      "phone": "15258697353",
      "lng": "123.999999",
      "lat": "32.444444",
      "total_plot": 122,
      "empty_plot": 199,
      "price_desc": "2 元每小时",
      "remark": "简要说明"
    },
    {
      "com_id": 307851,
      "park_id": "FE9B5A94815311E6A2FD00163E0024D9",
      "park_union_id": 200122,
      "name": "慧泊社区",
      "address": "深圳市光明新区",
      "phone": "18138126297",
      "lng": "123.999999",
      "lat": "32.444444",
      "total_plot": 1000,
      "empty_plot": 922,
      "price_desc": "首 3 小时 5 元，之后每 1 小时 1 元，最高 10 元。前 1 小时不收费",
      "remark": "慧泊社区，懂你的社区"
    },
    {
      "com_id": 308831,
      "park_id": "9df53031757541cd8398f56c3115de61",
      "park_union_id": 200301,
      "name": "测试停车场 20180818",
      "address": "20180818 测试地址",
      "phone": "15258697353",
      "lng": "123.999999",
      "lat": "32.444444",
      "total_plot": 213,
      "empty_plot": 202,
      "price_desc": "",
      "remark": "测试简历"
    }
  ],
  "count": 4,
  "errmsg": "查询成功",
  "state": 1
}
```

### 返回示例（查询失败）

```json
{
  "count": 0,
  "parks": [],
  "state": 0,
  "errmsg": "附近没有车场"
}
```

## 四、注意事项

1. `lng`、`lat` 均为字符串类型，需保留 6 位小数。
2. `distance` 为数字类型，单位为米，取值范围为 100-2000 米。
3. `union_id` 为联盟身份 ID，是必传字段。
4. `rand` 为随机数，32 位以内整数或小数，与上次请求不能重复，否则认为是非法请求。
5. 返回字段中 `state` 为数字类型：`0` 表示失败，`1` 表示成功。
6. `count` 为返回条数，`parks` 为车场信息数组。
7. `parks` 数组元素包含 `com_id`、`name`、`address`、`phone`、`lng`、`lat`、`total_plot`、`empty_plot`、`price_desc`、`remark`、`park_union_id`、`park_id` 等字段。
8. `remark`、`park_union_id` 为非必传字段。
9. 查询失败时，`count` 为 0，`parks` 为空数组，`state` 为 0，`errmsg` 提示「附近没有车场」。
10. 请求示例中 `sign` 为签名值，实际对接时需按泊链签名规则生成。