1. 总述

1.1 功能说明

组件通过组合省市区地址的选择框和详细地址的输入框获取地址数据。省市区选择框拥有级联样式与选择器样式，可以通过配置面板设置

省市区组件使用步骤如下：

1. 如果有，加载上一次保存的地址数据，否则展示空白内容
2. 通过配置的省市区选择框样式选择省市区内容，在选择到最子级地址后保存省市区数据
3. 在下方的详细地址输入框输入详细地址
4. 点击保存按钮存储数据

1.2 支持场景

各地区地址位置的选择与输入，可以自由适配国内或世界范围的地址接口

2. 组件构成

主要由两部分构成，分别是

• ① 位于上部的省市区地址的选择框
• ② 位于下部的详细地址的输入框

2.1 省市区地址选择框

有 ①级联样式 与 ②选择器样式 两种，存储行政区域数据

在选择完最子级的地址后才能将选择的数据存储下来

2.2 详细地址的输入框

是一个多行文本框，存储详细地址数据

注：文本内容不允许输入英文逗号，会影响字段的分割

3. 配置

除了表单元素通用配置以外，省市区组件还有选择模式和接口地址两个配置属性

3.1 选择模式配置

选择模式可以通过开关选择

• ① 级联样式
• ② 选择器样式

3.2 接口地址配置

接口地址的默认测试地址为/v3/config/district
中间层转发地址为/apis/common/proxy/lcpGw/tz_api/data_amap
网络请求地址由二者组合拼成

4 接口参数

4.1 请求参数

请求方式: GET

请求参数:

请求示例：

{
    keywords: 广州,
    subdistrict: 1,
    filter: 广东
}

4.2 响应参数

响应参数:

响应结果示例：

  {
      status: '1',
      info: 'OK',
      infocode: '10000',
      count: '1',
      districts: [
        {
          citycode: '020',
          adcode: '440100',
          name: '广州市',
          level: 'city',
          isLeaf: false,
          districts: [
            {
              citycode: '020',
              adcode: '440115',
              name: '南沙区',
              level: 'district',
              districts: [],
              isLeaf: false,
            },
            {
              citycode: '020',
              adcode: '440113',
              name: '番禺区',
              level: 'district',
              districts: [],
              isLeaf: false,
            },
            {
              citycode: '020',
              adcode: '440105',
              name: '海珠区',
              level: 'district',
              districts: [],
              isLeaf: false,
            },
            // ...省略其他区
          ],
        },
      ],
  }

5. 预览效果

5.1 级联选择模式

5.2 选择器模式