Flutter美国邮编地址查询插件usa_zipcode_address_lookup的使用

Flutter美国邮编地址查询插件usa_zipcode_address_lookup的使用

United States Zip Code Lookup

一个用于根据美国邮政编码检索详细位置信息的Flutter包。该插件通过向云端服务器发送请求来获取与给定邮政编码相关的地址、州名、城市名、本地名、区号和州代码。

该插件适用于需要准确美国邮政编码位置信息的应用程序。

Gallery

Features

• 根据美国邮政编码检索位置详情。
• 返回的信息包括：
  • 地址
  • 州名
  • 城市名
  • 本地名
  • 区号
  • 州代码

Supported Devices

Installation

在你的项目pubspec.yaml文件中添加此包：

dependencies:
  usa_zipcode_address_lookup: ^1.0.0

然后运行：

flutter pub get

Usage

Import the Package

import 'package:usa_zipcode_address_lookup/usa_zipcode_address_lookup.dart';

Example

要检索位置详情，创建USAZipCodeAddressLookup类（或类似）的一个静态实例，并调用带有邮政编码参数的searchZipcode方法。

示例如下：

ZipCodeLocation locationModel = await USAZipCodeAddressLookup.searchZipcode(randomZipCode);

Sample Output

给定一个邮政编码，输出将包含以下信息：

Address: 320 MAIN ST
State Name: Kansas
City Name: SUMMERFIELD
Local Name: SUMMERFIELD
Area Code: 4J
State Code: KS

License

MIT License

Contributions

欢迎贡献！请提交拉取请求或报告问题。

完整示例Demo

import 'dart:math';
import 'package:flutter/material.dart';
import 'package:usa_zipcode_address_lookup/usa_zipcode_address_lookup.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: '美国邮政编码地址示例',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      themeMode: ThemeMode.system,
      home: const Home(),
    );
  }
}

class Home extends StatefulWidget {
  const Home();

  [@override](/user/override)
  State<Home> createState() => _HomeState();
}

class _HomeState extends State<Home> {
  // 邮政编码列表
  List<String> zipcodes = [
    "66541",
    "54433",
    "00601",
    "66543",
    "72122",
    "55424",
    "62345"
  ];

  String randomZipCode = "";
  String zipcodeInformation = "[无信息（点击刷新）]";
  bool isLoading = false;

  [@override](/user/override)
  Widget build(BuildContext context) {
    Size size = MediaQuery.of(context).size;

    return Scaffold(
      appBar: AppBar(title: const Text("美国邮政编码地址查询")),
      body: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        crossAxisAlignment: CrossAxisAlignment.center,
        children: [
          SizedBox(
            width: size.width,
            child: const Text(
              "查询任何美国邮政编码",
              textAlign: TextAlign.center,
              style: TextStyle(fontSize: 22),
            ),
          ),
          SizedBox(
            width: size.width,
            child: const Text(
              "美国邮政编码地址查找器",
              textAlign: TextAlign.center,
              style: TextStyle(fontSize: 10),
            ),
          ),
          const SizedBox(height: 20),
          isLoading
              ? const CircularProgressIndicator()
              : Column(
                  children: [
                    const SizedBox(height: 3),
                    Text(
                      randomZipCode.toString(),
                      style: const TextStyle(
                          fontSize: 20, fontWeight: FontWeight.bold),
                    ),
                    const Text(
                      "邮政编码信息",
                      style:
                          TextStyle(fontSize: 16, fontWeight: FontWeight.bold),
                    ),
                    const SizedBox(height: 10),
                    Text(
                      zipcodeInformation,
                      style: const TextStyle(
                          fontSize: 18, fontWeight: FontWeight.normal),
                    ),
                  ],
                ),
          const SizedBox(height: 20),
          ElevatedButton(
              onPressed: () async {
                setState(() {
                  isLoading = true;
                });

                // 从列表中随机选择邮政编码
                Random random = Random();
                randomZipCode = zipcodes[random.nextInt(zipcodes.length)];

                ZipCodeLocation objec =
                    await USAZipCodeAddressLookup.searchZipcode(randomZipCode);
                updateScreen(objec);
              },
              // 设置字体大小为20
              style: ButtonStyle(
                foregroundColor: MaterialStateProperty.all(Color.fromARGB(255, 12, 115, 199)),
                padding: MaterialStateProperty.all(const EdgeInsets.all(13)),
                textStyle: MaterialStateProperty.all(
                    const TextStyle(fontSize: 18, fontWeight: FontWeight.bold)),
              ),
              child: const Text("查询邮政编码地址")),
        ],
      ),
    );
  }

  void updateScreen(ZipCodeLocation objec) {
    setState(() {
      zipcodeInformation = "";
      zipcodeInformation += "邮政编码 : ${objec.zipCode}\n";
      zipcodeInformation += "城市 : ${objec.city}\n";
      zipcodeInformation += "州代码 : ${objec.stateCode}\n";
      zipcodeInformation += "州名 : ${objec.stateName}\n";
      zipcodeInformation += "本地名 : ${objec.localName}\n";
      zipcodeInformation += "地址 : ${objec.address}\n";
      zipcodeInformation += "区号 : ${objec.areaCode}\n";

      isLoading = false;
    });
  }
}