功能概述

• 智能地址补全：用户在结算页面输入地址时，自动从 Google Places API 获取地址建议，支持实时下拉选择

• 自动填充表单：选择地址后，自动填充 Address 1、City、Zip Code、Country/Region、Zone 等字段

• 多语言支持：自动适配 BeikeShop 前台语言（中文、英文、德文、法文、西班牙文、俄文、韩文、日文、印尼文、意大利文）

• 焦点切换体验：点击地址输入框显示 Google 组件，选择地址后自动切回原始输入框，体验流畅

• 无需额外按钮：即输即提示，无需点击"获取地址"按钮

技术特性

• 使用 Google Places API (New) Web Components

• 支持中英文国家名称自动匹配

• 自动触发表单验证，无缝集成 Element UI

• 轻量级设计，不影响网站性能

适用场景

• 跨境电商独立站

• 多语言外贸商城

• 需要提升地址填写效率的各类 B2C 站点

安装配置

系统要求

• BeikeShop ≥ 1.5.0

• PHP ≥ 7.4

• Google Cloud 项目必须在 2025年3月1日之后创建（本项目使用新版 Places API）

配置步骤

1. 在 Google Cloud Console 创建新项目（或使用 2025年3月1日之后创建的项目）

2. 启用 Places API (New) 和 Maps JavaScript API

3. 生成 API Key，并添加域名限制（如 https://yourdomain.com/*）

4. 在 BeikeShop 后台 → 插件管理 → 地址自动填充 → 填入 API Key

5. 启用插件，即可生效

常见问题

Q：需要付费吗？
A：插件本身一次性付费，Google Places API 有免费额度（每月 $200 免费额度，通常足够中小型站点使用）。

Q：我的 Google Cloud 项目是旧项目（2025年3月1日之前创建的），可以用吗？
A：不可以。旧项目使用的是旧版 Places API，本插件基于新版 API 开发，不兼容。请创建新项目使用。

Q：会影响网站速度吗？
A：不会，Google API 异步加载，不影响页面渲染。

Q：国内可以使用吗？
A：需要翻墙使用，国内网络访问不了google，请自行斟酌。自动填充对海外客户的地址友好，对大陆支持的不是很规范，慎者勿拍