省市联动json怎么写

省市联动JSON数据格式详解与实例指南

在Web开发中,省市联动（即省级与市级数据的级联选择）是常见的交互场景，而JSON作为轻量级的数据交换格式，因其结构清晰、易于解析，成为省市联动的首选数据载体，本文将详细介绍省市联动JSON的编写规范、结构设计、实例展示及注意事项，帮助开发者快速这一技能。

省市联动JSON的核心设计原则

省市联动JSON的核心目标是清晰表达层级关系（省→市）并便于前端解析调用，在设计时需遵循以下原则：

1. 层级明确：通过嵌套结构体现省级与市级数据的从属关系，避免平铺导致的数据混乱。
2. 字段规范：统一使用code（唯一标识）、name（显示名称）等关键字段，确保前后端字段一致。
3. 易于扩展：预留“区县联动”的扩展空间，支持未来通过嵌套市级数据下的区县数据实现多级联动。
4. 数据完整：省级数据需包含所有省级行政区（含省、自治区、直辖市、特别行政区），市级数据需对应所属省的所有地级市（含自治州、地区等）。

省市联动JSON的标准结构

省市联动JSON通常采用“省级数组+市级嵌套”的结构：

• 最外层是一个省级数据数组，每个省级对象是一个独立的省级行政区数据。
• 省级对象内包含省级基础信息（code、name）和一个市级数据数组，市级数组存储该省下的所有地级市数据。
• 市级对象内包含市级基础信息（code、name），若需扩展区县联动，可在此基础上嵌套“区县数组”。

字段定义说明

市级对象结构（嵌套在省级cities中）

{
  "code": "110100",  // 市级唯一标识码（如“110100”代表北京市辖区）
  "name": "北京市辖区" // 市级显示名称
}

完整实例展示

以下以“北京市”“上海市”“广东省”为例，展示省市联动JSON的完整结构（实际使用时需补充全国所有省级行政区数据）：

示例1：基础版省市联动JSON（仅省+市）

[
  {
    "code": "110000",
    "name": "北京市",
    "cities": [
      {
        "code": "110100",
        "name": "北京市辖区"
      },
      {
        "code": "110101",
        "name": "东城区"
      },
      {
        "code": "110102",
        "name": "西城区"
      }
      // ... 其他北京市辖区（注：北京市不设地级市，直接辖区和县，此处为简化示例）
    ]
  },
  {
    "code": "120000",
    "name": "天津市",
    "cities": [
      {
        "code": "120100",
        "name": "天津市辖区"
      },
      {
        "code": "120101",
        "name": "和平区"
      },
      {
        "code": "120102",
        "name": "河东区"
      }
      // ... 其他天津市辖区
    ]
  },
  {
    "code": "440000",
    "name": "广东省",
    "cities": [
      {
        "code": "440100",
        "name": "广州市"
      },
      {
        "code": "440200",
        "name": "深圳市"
      },
      {
        "code": "440300",
        "name": "珠海市"
      },
      {
        "code": "440400",
        "name": "汕头市"
      }
      // ... 其他广东省地级市
    ]
  }
]

示例2：扩展版（含区县联动，市级对象嵌套districts字段）

若需实现“省→市→区县”三级联动，可在市级对象中嵌套districts数组（区县数据），结构如下：

[
  {
    "code": "440000",
    "name": "广东省",
    "cities": [
      {
        "code": "440100",
        "name": "广州市",
        "districts": [
          {
            "code": "440103",
            "name": "荔湾区"
          },
          {
            "code": "440104",
            "name": "越秀区"
          },
          {
            "code": "440105",
            "name": "海珠区"
          }
          // ... 其他广州市辖区
        ]
      },
      {
        "code": "440200",
        "name": "深圳市",
        "districts": [
          {
            "code": "440303",
            "name": "罗湖区"
          },
          {
            "code": "440304",
            "name": "福田区"
          },
          {
            "code": "440305",
            "name": "南山区"
          }
          // ... 其他深圳市辖区
        ]
      }
    ]
  }
]

关键注意事项

标识码规范

推荐使用《中华人民共和国行政区划代码》（GB/T 2260）中的6位数字代码：

• 省级代码：前2位为省级行政区划码（如“11”代表北京市，“44”代表广东省），后4位为“00”（如“110000”）。
• 市级代码：前2位与省级一致，后4位为市级码（如“110100”代表北京市辖区，“440100”代表广州市）。
• 区县级代码：前6位与市级一致，后6位为区县码（如“440103”代表广州市荔湾区）。

优势：标识码具有唯一性和层级性，便于数据校验和前端逻辑处理（如通过截取前2位判断所属省份）。

数据完整性

• 省级数据：需包含全国34个省级行政区（23个省、5个自治区、4个直辖市、2个特别行政区）。
• 市级数据：需包含对应省下的所有地级市（如新疆维吾尔自治区需包含5个自治州、7个地区、4个直辖市）。
• 名称规范：使用国务院公布的规范名称（如“新疆维吾尔自治区”不可简写为“新疆”，“广西壮族自治区”不可简写为“广西”）。

前端解析建议

• 数据加载：首次加载时仅解析省级数据，渲染省级下拉菜单；当用户选择某省时，动态遍历该省的cities数组，渲染市级下拉菜单。
• 联动逻辑：通过省级code匹配市级数据（如选择“广东省”code=440000，则显示cities数组中所有市级数据）。
• 错误处理：若某省暂无市级数据（如特别行政区），需在cities数组中提示“暂无数据”，避免前端报错。

性能优化

• 数据压缩：若数据量较大（如全国省市数据），可启用Gzip压缩减少传输体积。
• 异步加载：采用AJAX异步请求省市数据，避免阻塞页面渲染（尤其适合移动端）。
• 缓存策略：将省市数据缓存在localStorage中，减少重复请求（数据更新频率较低时适用）。

省市联动JSON的设计核心是“层级清晰、字段规范、易于扩展”，通过标准的嵌套结构和统一的标识码，不仅能高效表达省市级数据关系，还能为后续区县联动、数据校验等场景奠定基础，开发者在实际编写时，需注意数据完整性、名称规范及前端解析友好性，确保省市联动功能稳定、高效运行。

附：全国省级行政区代码速查表（部分）
| 省级名称 | 代码 | 省级名称 | 代码 | |----------|--------|----------|--------| | 北京市 | 110000 | 上海市 | 310000 | | 天津市 | 120000 | 重庆市 | 500000 | | 河北省 | 130000 | 河南省 | 410000 | | 广东省 | 440000 | 新疆维吾尔自治区 | 650