Flutter越南行政区划数据插件dvhcvn的使用

越南行政区划数据插件介绍

dvhcvn 插件提供了一种方便的方式来访问和操作越南的行政单位信息。这些数据是从 daohoangson/dvhcvn 获取并保持更新的。

使用示例

Dart 示例代码

在 Dart 中，您可以轻松地通过 id 或者 name 来查找不同级别的行政区划。下面是一个简单的例子，展示了如何获取从省级到乡级的信息：

import 'package:dvhcvn/dvhcvn.dart' as dvhcvn;

void main() {
  // 查找ID为'01'的一级行政区（如：省或直辖市）
  final haNoi = dvhcvn.findLevel1ById('01');
  // 在找到的Ha Noi中，查找ID为'001'的二级行政区（如：区）
  final baDinh = haNoi?.findLevel2ById('001');
  // 在找到的Ba Dinh中，查找ID为'00001'的三级行政区（如：乡）
  final phucXa = baDinh?.findLevel3ById('00001');

  print(phucXa); // 输出: Thành phố Hà Nội > Quận Ba Đình > Phường Phúc Xá
}

这段代码将输出 “Thành phố Hà Nội > Quận Ba Đình > Phường Phúc Xá”，表示已经成功找到了从河内市到巴亭区再到福霞坊的具体路径。

Flutter 示例应用

对于 Flutter 开发者来说，也有一个现成的例子可以参考。这个例子位于 GitHub 上的 flutter-dvhcvn 项目，并且包含了一个演示 GIF 图片，显示了插件在实际应用中的工作情况。

API 参考

以下是 dvhcvn 插件提供的主要 API 方法：

• const level1s
  这是一个包含所有一级行政区（例如，直辖市或省份）的列表。

• findLevel1ById(String)
  根据给定的 ID 查找一级行政区。

• findLevel1ByName(String)
  根据名称查找一级行政区。

• class Level1, Level2, Level3
  每个类分别代表不同级别的行政区划。它们有以下字段：

  • String id: 区域唯一标识符。
  • String name: 区域名称。
  • Type type: 行政级别类型。

  此外，Level2 和 Level3 类还包含了指向其上级区域的 parent 字段；而 Level1 和 Level2 则具有子项集合 children 以及相应的查找方法 findLevelXById 和 findLevelXByName。

通过这些API，开发者可以在自己的应用程序中快速集成并利用越南全国范围内的详细行政区划信息。