2 分钟阅读 Store Locator

门店定位器 HTML 代码:需要哪些内容

简单说明门店定位器的 HTML 代码到底包含什么,地理定位和商品搜索如何融入其中,以及在每个平台上把它粘贴到哪里。

门店定位器的 HTML 代码是一个小小的嵌入代码:一个容器元素加一个脚本标签,用来加载地图、读取你的地址数据,并按距离对结果进行排序。地图服务商、定位方法,以及购物者是否可以按商品搜索,是在这个基础之上另外做出的独立选择。

商家很少亲自手写这段代码。通常由一个插件、应用或 SaaS 组件生成,并交给你一段可以直接粘贴的代码。但了解其中包含的内容仍然有帮助,因为它能让你知道哪些地方可以自定义。

这段代码到底包含什么

一个可以正常工作的门店定位器由三部分组成。地图库负责渲染地图瓦片和图钉,可以使用 Google Maps、Mapbox、搭配 OpenStreetMap 瓦片的 Leaflet,或者服务商自己的矢量渲染引擎。

地址数据来源提供地址和坐标,可以是静态的 JSON 数组、由 CSV 转换成的 JSON,或者实时的 API 调用。距离函数,几乎总是基于纬度和经度的 haversine 公式,按到购物者距离的远近对地址进行排序。

地理定位需要备案方案,而不只是一个授权请求

定位器可以通过两种方式找到购物者。浏览器地理定位会请求授权,并返回精准的设备位置;而基于 IP 的估算会跳过该请求,转而返回城市级别的估算位置。

拒绝该请求的购物者仍然希望手机上的附近搜索能正常使用。一个实用的做法是,当购物者拒绝该请求时,回退到基于 IP 的估算或手动地址搜索。

按平台看,你究竟把代码粘贴在哪里

在 Shopify 上,商家很少直接粘贴 HTML。主题架构通过 app blocks 来渲染第三方应用的内容,允许应用在不修改主题代码的情况下向主题添加内容,所以定位器是以模块的形式安装,而不是复制粘贴的代码段。

WordPress 则通过其区块编辑器工作:在任何区块中放入短代码,就能在该页面上渲染出定位器,不需要任何 HTML。我们的 WordPress 指南 介绍了某个插件的完整设定步骤。

Squarespace 的 Code Block 是官方记载的自定义 HTML 位置,但其内的 JavaScript 和 iframe 需要 Core 或更高级别的计划。Wix 则提供用于粘贴代码段的 Embed HTML 组件,或从其 App Market 安装定位器应用;我们的 Wix 指南 介绍了这个流程。

很多其他建站平台,包括 Webflow、BigCommerce 和 Elementor,都提供了用于同样目的的类似嵌入或 HTML 组件。

构建前的清单,自建代码或组件

在自建和使用现成组件之间做决定,可以归结为四个检查点:

  1. 确认你的平台允许在哪里添加自定义代码:是一个模块、一个组件,还是一个应用安装。
  2. 单独核对地图服务商的密钥需求;Google Maps 和 Mapbox 都需要商家自己的凭证,而 Google Maps 还需要绑定结算账户。
  3. 决定地址数据如何保持最新:是手动编辑、同步的表格,还是来自你电商平台的实时数据流。
  4. 在真实手机上测试地理定位,要测试拒绝授权的情形,而不是只测试允许授权的情形,因为附近搜索通常就是在那里失败。

商品级搜索究竟需要什么

门店定位器找的是地点。商品定位器回答的是一个更精准的问题:你哪个地址现在有某个商品,这需要绑定到每个地址的库存数据,而不仅仅是一幅地图。

需求作用Shopify 数据来源
地址记录门店或取货点Location object
每地库存每个商品的库存inventoryLevels
商品筛选显示有库存的商品storeAvailability

地址和库存这两行数据来自 Shopify 自己的 Location API,不论你安装什么应用都会存在。某个变体按地址的可用性,也通过 Storefront API 的 storeAvailability 字段 原生暴露,该字段是为门店取货设计的,但将它转化为地图筛选器仍然是应用自己的工作。

决定之前,向服务商问这两个问题:

  1. 商品可用性是否根据库存自动更新,还是需要有人手动维护?
  2. 当附近所有地址都缺货时,页面会显示什么?

总结

当地图能干净地加载、在拒绝授权的情况下地理定位测试仍能返回附近结果,并且如果你构建了商品搜索、它能排除你知道已缺货的地址,那么门店定位器就算完成了。剩下的全都是打磨。

这个决定大部分都是关于数据,而不是关于设计:你的地址数据存在哪里,它们有多新,以及商品可用性是否在接近实时的某个地方被跟踪。先把这些做对,其余的地图部分就是简单的部分了。

常见问题

门店定位器的 HTML 代码需要 Google Maps API 密钥吗?

只有当你选择 Google Maps 时才需要,这需要商家自己的 API 密钥和绑定结算账户。Mapbox 则需要其自己的访问令牌,而基于 OpenStreetMap 风格数据构建的地图 完全不需要密钥。

门店定位器和商品定位器有什么区别?

门店定位器显示你的地址在哪里。商品定位器显示这些地址中哪一个现在有某个商品在库,这需要地图背后的库存数据。

我可以不写代码就添加门店定位器吗?

可以:应用、插件和 SaaS 组件会为你生成该嵌入代码。Progus Store Locator 就是其中一个选择:在 Shopify 上是主题模块,在 WordPress 上是短代码,在 Wix 上通过 App Market 安装,可以从 Shopify 应用或网页仪表盘管理;在其他地方则是一段嵌入代码。

地理定位总是会请求购物者的授权吗?

不会。基于 IP 的估算可以在没有任何请求的情况下,将购物者定位到城市级别。这让它成为拒绝浏览器请求的购物者的一个合理备案方案。

为您的网站添加门店定位器. 了解 Store Locator ›