2 分钟阅读 Store Locator

Google Maps API 报错:修复或改用无密钥地图

诊断准确的 Google Maps API 错误,修复密钥或结算配置,或将门店定位器迁移到无需商家密钥的地图。

Google Maps API 报错通常由密钥缺失或受限、API 未启用,或项目未启用结算造成。先在浏览器控制台读取准确的错误代码,再修复配置,或换用不要求商家自备 API 密钥的地图提供商。

查找准确的 Google Maps API 错误

打开出错页面和浏览器开发者工具,然后选择控制台。Google 将消息格式记录为“Google Maps API error: [ERROR CODE]”,并为每个代码提供原因和修复方法。

不要仅凭空白地图判断问题。高度为零的地图容器、被拦截的脚本、无效密钥和未启用结算在页面上可能看起来相同,但修复方法不同。

常见错误和正确检查方法

BillingNotEnabledMapError

地图所用的 Google Cloud 项目未启用结算。为该项目启用结算,然后重新加载页面。Google 要求 Maps JavaScript API 请求启用结算,并使用 API 密钥或 OAuth 令牌。

ApiNotActivatedMapError

与密钥关联的项目未启用 Maps JavaScript API。请在 Google Cloud Console 中启用该 API,并确认页面加载的是同一项目的密钥。

ApiTargetBlockedMapError

密钥被禁止使用所需 API。检查 API 限制并允许 Maps JavaScript API。限制范围应足以保护密钥,同时包含页面实际调用的每个 API。

RefererNotAllowedMapError

当前网站地址不在密钥允许的引荐来源列表中。使用准确的 HTTP 引荐来源模式添加生产环境主机名及所需子域名。

InvalidKeyMapError 或 MissingKeyMapError

页面发送了无法识别的密钥,或没有发送密钥。检查脚本 URL、部署环境、复制的值,以及主题或插件是否仍在注入旧密钥。

修复 Google Maps,还是取消密钥依赖?

如果网站依赖 Google 特有服务,或配置错误明确且可以单独修复,就修复现有设置。如果门店定位器只需要位置搜索、路线、标记和地图,而团队不想维护 Google Cloud 项目及密钥,就更换地图。

无密钥设置不代表所有提供商都无需密钥。在本文所述定位器中,内置地图、两种 OpenStreetMap 样式和三种 Apple Maps 样式无需商家提供密钥。Google Maps 和 Mapbox 仍可选,但需要商家自己的密钥。

产品代码中已验证的地图选项

  • 内置地图:五种样式,无需商家 API 密钥。
  • OpenStreetMap:两种样式,无需商家 API 密钥。
  • Apple Maps:目前有三种样式,无需商家 API 密钥。
  • Google Maps:四种样式及其样式目录,使用商家密钥。
  • Mapbox:六种样式,使用商家密钥。

共有十种已验证样式不需要商家密钥。此前关于超过 23,000 种样式的说法没有代码支持,因此已删除。

如何迁移门店定位器

1. 导出并清理位置列表

每个位置保留一行,并核对地址、名称、电话、营业时间和网站字段。导入前删除重复项。

2. 导入位置

产品代码支持 CSV、XLS、XLSX、Numbers 文件和 Google Sheets 作为位置来源。将每个来源列映射到对应的位置字段,并检查失败的行。

3. 选择地图提供商

如果目标是取消 API 管理,先选无需密钥的提供商。只有确实需要 Google Maps 或 Mapbox 的地图体验且已配置密钥时,才选择它们。

4. 替换旧定位器

在 Shopify 中添加主题块。在 WordPress 中使用 [progus-store-locator] 短代码。Wix 有专用应用,其他网站可使用托管嵌入代码。

5. 删除旧地图前进行测试

测试地址搜索、地理位置回退、移动端布局、路线、标记点击和多个已知位置。在新定位器通过这些检查前,保留旧定位器。

更完整的设置步骤请参阅无需 Google Maps API 密钥的门店定位器指南。

地图无需商家密钥时的价格

Free 方案支持一个位置。Shopify 付费方案包括:Basic 每月 9.99 美元,支持 100 个位置;Standard 每月 19.99 美元,支持 500 个;Premium 每月 29.99 美元,支持 2,000 个。

付费方案提供 14 天试用,按年结算便宜 10%。WordPress 和 Wix 还提供 Starter 方案,每月 3.99 美元,支持 10 个位置。

这些是应用方案的位置上限,不是地图加载配额。更大的位置列表有更高方案,选择前请查看当前平台页面。

常见问题

为什么我的 Google 地图是空白的?

请检查浏览器控制台。原因可能是结算、API 限制、引荐来源限制、密钥缺失、脚本被拦截,或地图容器没有高度。

可以在没有 Google Maps API 密钥时使用门店定位器吗?

可以。请选择不要求自备密钥的提供商。内置地图、OpenStreetMap 和 Apple Maps 选项提供十种已验证的无密钥样式。

可以保留 Google Maps 选项吗?

可以。Google Maps 仍然可用,但需要自己的 Google Maps API 密钥,并正确配置结算和限制。

可以导入现有位置吗?

可以。已验证的导入格式包括 CSV、XLS、XLSX、Numbers 和 Google Sheets。

同一个定位器能在 Shopify 以外使用吗?

可以。已验证的方式包括 Shopify、WordPress、Wix,以及供其他网站使用的托管嵌入代码。

结论

先确定控制台中的准确错误。如果定位器不需要 Google Cloud,Store Locator 应用提供已验证的无密钥地图选项,以及支持一个位置的免费方案。

无需 Google Maps API,在地图上展示您的门店. 了解 Store Locator ›