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
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 ›