Google 致力于为黑人社区推动种族平等。查看具体举措

使用 ShipEngine 来验证地址

ShipEngine
Made by ShipEngine

根据写入指定 Cloud Firestore 集合的文档内容来验证地址。

此扩展程序的运作方式

使用此扩展程序,借助 ShipEngine ShipEngine 确保全球各地的邮寄地址有效。ShipEngine 交叉引用多个数据库,以验证地址并识别发货的潜在配送问题。这有助于品牌、电子商务平台、第三方物流避免不必要的退货和额外的运输公司费用。

几乎支持全球所有国家/地区,包括美国、加拿大、英国、澳大利亚、德国、法国、挪威、西班牙、瑞典、以色列、意大利和其他 160 多个国家/地区。为不同的国家/地区提供不同的验证级别。例如,一个国家/地区的验证可能精确到公寓/单元号,而另一个国家/地区的验证可能只精确到城市。查看国家/地区及其验证级别的完整列表

下面是会触发此扩展程序的基本文档内容示例:

admin
  .firestore()
  .collection('addresses')
  .add({
    address: {
      name: 'John Smith',
      addressLine1: '200 Sunrise Mall',
      cityLocality: 'Massapequa',
      stateProvince: 'NY',
      postalCode: '11758',
      countryCode: 'US',
    },
  });

额外设置

在安装此扩展程序之前,请确保您已经在 Firebase 项目中设置了一个 Cloud Firestore 数据库

在配置此扩展程序时,您还必须创建一个 ShipEngine 帐号或使用您的现有帐号,并从 ShipEngine API 管理页面提供您的 ShipEngine API 密钥

结算

若要安装扩展程序,您的项目必须采用 Blaze(随用随付)方案

  • 您需要为此扩展程序所需的 Firebase 资源支付少量费用(通常约为 $0.01/月),即使没有使用此扩展程序也要支付。
  • 此扩展程序用到了其他 Firebase 和 Google Cloud Platform 服务,如果超出这些服务的免费层级,则会产生相关费用:
  • Cloud Firestore
  • Cloud Functions(Node.js 15+ 运行时。查看常见问题解答)
  • Cloud Secret Manager

使用此扩展程序还需要您拥有 ShipEngine 帐号。您需要自行承担与使用 ShipEngine 帐号相关的任何费用。

如何安装此扩展程序

使用 Firebase 控制台

要安装和管理扩展程序,您可以使用 Firebase 控制台。

使用控制台安装

使用 Firebase CLI

要安装和管理扩展程序,您还可以使用 Firebase CLI:

步骤 1:运行以下 npm 命令来安装 CLI 或将 CLI 更新到最新版本。

npm install -g firebase-tools
不能运行?请参阅 Firebase CLI 参考文档或者更改您的 npm 权限

第 2 步设置一个新的 Firebase 项目目录或转到现有目录

第 3 步:将此扩展程序添加到扩展程序清单

firebase ext:install shipengine/validate-addresses --local --project=projectId_or_alias

第 4 步(可选):使用 Firebase Emulator Suite 在本地测试此扩展程序

firebase emulators:start

第 5 步:将清单中的扩展程序部署到项目中

firebase deploy --only extensions --project=projectId_or_alias
支持
Cloud Firestore
许可
Apache-2.0
版本
0.0.3