Vietnam Provinces

A Flutter package for managing Vietnam's administrative divisions: provinces, districts, and wards.

📄 Data source

The data for this package is sourced from the Vietnam Provinces Open API

✨ Features

• Retrieve provinces, districts, and wards.
• Search by name (query) or code.
• Lightweight and simple to integrate.

🚀 Getting Started

1. Add the package to your pubspec.yaml:

   dependencies:
     vietnam_provinces: ^1.0.2
   

2. Load the data in your app:

   import 'package:vietnam_provinces/vietnam_provinces.dart';
   
   void main() async {
    WidgetsFlutterBinding.ensureInitialized();
    await VietnamProvinces.initialize();
   }
   

🔧 Usage

• Get provinces or query:

  final provinces = VietnamProvinces.getProvinces(code: 1);
  

  final provinces = VietnamProvinces.getProvinces(query: "Hà");
  

• Get districts by province code, and query:

  final districts = VietnamProvinces.getDistricts(
    provinceCode: 1,
    query: "Quận",
  );
  

• Get wards by provinceCode, districtCode, and query:

  final wards = VietnamProvinces.getWards(
    provinceCode: 1,
    districtCode: 10,
    query: "Phường",
  );
  

📱 Example

To see vietnam_provinces in action, check out the example project in the example.

🛠️ Contributions

We welcome contributions! If you have ideas for features, bug fixes, or improvements, feel free to open an issue or submit a pull request.

🐞 Issues and feedback

Please file issues to send feedback or report a bug. Thank you!

📜 License

MIT License