@googlemaps/addressvalidation

中文文档
4.1.0发布于 2026/10/13Apache-2.0TypeScriptCommonJS近 30 天下载 45万

节点客户端js

中文使用文档
文档目录10 节
  1. 快速启动
  2. 在你开始之前
  3. 安装客户端库
  4. 服务条件
  5. 欧洲经济区开发者
  6. 样本
  7. 支持的节点.js版本
  8. 版本
  9. 捐款
  10. 许可证

Google Cloud Platform logo

地址验证 API: 节点客户端

这个图书馆被认为是 稳定。代码表面不会改变向后兼容的方式 除非绝对必要(例如,由于关键的安全问题)或 大量贬值期。 问题和要求 稳定 图书馆 以最高优先处理

npm version

节点的 API 客户端

各版本的更改一览表载于 变化。 。 。 .

更多信息,请访问Cloud APIs的客户端库,包括老年人 Google APIs 客户端图书馆, in 客户端图书馆解释。 。 。 .

目录 :

快速启动

在你开始之前

  1. 选择或创建云平台项目。 。 。 .
  2. 启用您的工程计费。 。 。 .
  3. 启用地址验证 API API。 。 。 .
  4. 设置认证 这样你就可以访问 当地工作站的API.

安装客户端库

npm install @googlemaps/addressvalidation

服务条件

@google-cloud/addressvalidation 使用Google地图平台服务. 谷歌的使用 通过此库的映射平台服务受 谷歌地图平台服务条款。 。 。 .

这个库不是谷歌地图平台核心服务. 因此,Google地图平台服务条款(例如: 支助服务、服务级协议和折旧政策) 不适用于此图书馆.

欧洲经济区开发者

如果你的账单地址在欧洲经济区,则生效 2025年7月8日,日内瓦 谷歌地图平台 EEA 服务条款 您将申请使用服务。 功能因区域而异. 学多点。 。 。 .

样本

样本在 samples/ 目录。 每个样本 README.md 有运行样本的指示.

样本源代码
提供验证反馈源代码
验证地址源代码

支持的节点.js版本

我们的客户端图书馆跟着 节点.js发布时间表。 。 。 . 图书馆兼容所有当前 活动 财务报告和审定财务报表 维修 版本 节点.js. 如果你在使用"节点"(Node.js)的报废版本,我们建议你更新 尽快到积极支持的LTS版本.

Google 的客户端库支持在 a 上的 Node.js runtimes 的遗留版本 以下列警告为依据:

  • 后遗症版本不进行连续整合测试.
  • 一些安全补丁和特性不能被后移植.
  • 依赖关系不能不断更新.

设有针对Node.js的一些报废版本的客户端图书馆,以及 可以通过 npm 安装 秒数。 。 。 . 立面遵循命名惯例 legacy-(version)。 。 。 . 譬如说, npm install @googlemaps/addressvalidation@legacy-8 安装客户端库 用于兼容Node.js 8的版本.

版本

这个图书馆跟随 语义版本。 。 。 .

更多信息 : 谷歌云平台启动阶段

捐款

欢迎捐款! 见 贡献指南。 。 。 .

请注意: README.md 和该寄存器中的各种配置文件(包括 .nycrc 财务报告和审定财务报表 tsconfig.json(中文(简体) ) 从中央模板生成.

许可证

Apache 版本 2.0

见 自由主义

版本与发布记录

@googlemaps/addressvalidation 共发布 19 个版本,首次发布于 2022/11/11;过去 12 个月发布了 4 个版本。

版本发布日期距今
4.1.0latest2026/10/131 个月前
4.0.12026/09/291 个月前
4.0.02026/08/113 个月前
3.2.2legacy-182026/05/026 个月前
3.2.12025/10/141.1 年前
3.2.02025/07/231.3 年前

其他发布通道:legacy-12 → 1.0.2,legacy-18 → 3.2.2。

关于 @googlemaps/addressvalidation 的常见问题

@googlemaps/addressvalidation 是什么?

节点客户端js

如何安装 @googlemaps/addressvalidation?

在项目目录运行 npm install @googlemaps/addressvalidation,或使用 pnpm add / yarn add / bun add。

@googlemaps/addressvalidation 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@googlemaps/addressvalidation 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@googlemaps/addressvalidation 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@googlemaps/addressvalidation 可以商用吗?

@googlemaps/addressvalidation 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@googlemaps/addressvalidation 的下载量有多少?

根据 npm 官方下载统计,@googlemaps/addressvalidation 在 2026/10/17 – 2026/11/15 这 30 天内被下载 449,708 次,日均约 14,990 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@googlemaps/addressvalidation 还在维护吗?

最新版本 4.1.0 发布于 2026/10/13(1 个月前);至今共发布 19 个版本,其中过去 12 个月发布了 4 个;首次发布于 2022/11/11。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。