请参阅使用实体店地址搜索提高店内销售量。

使用 Retail React 应用模板，可以在 Progressive Web App （PWA） Kit 站点上包含商店定位器，从而缩短实施时间。购物者可以根据邮政编码、城市等查找全球商店位置。轻松扩展 Business Manager 中的商店信息，以自定义您网站上显示的位置元数据。

本指南介绍如何配置和使用实体店定位器。

前提条件

要包含实体店定位符，请执行以下作：

使用以下命令构建站点：
- 零售 React 应用模板
- Retail React App 版本 4.0 或更高版本
- Commerce SDK React 版本 2.0.1 或更高版本
使用范围 sfcc.shopper-stores为的购物者登录和 API 访问（SLAS）客户端。按照购物者 API 授权中的步骤作，或使用 registerClient API 端点创建或更新 SLAS 公共或私有客户端。
- 在“范围 ”字段中，包括以下范围： sfcc.shopper-stores。
与公共客户端相比，SLAS 专用客户端具有多项优势。请参阅使用 SLAS 私人客户端。

在 Business Manager 中：
- 添加您希望购物者在您的网站上找到的国家/地区。请参阅在 B2C Commerce 中存储地理定位数据。
- 添加您希望购物者在您的站点上找到的实体店。您可以编辑已添加的实体店信息。此外，还可以批量导入商店。请参阅在 B2C Commerce 中创建商店。
在 app/constants.js
- STORE_LOCATOR_IS_ENABLED 将常量 true设置为。
- SUPPORTED_STORE_LOCATOR_COUNTRIES 在常量中，添加您希望购物者在“国家/地区”下拉列表中查看的国家/地区列表。
  
  您添加的国家/地区代码必须与您在 Business Manager 中添加的商店的国家代码相匹配。
  
  如果常 SUPPORTED_STORE_LOCATOR_COUNTRIES 数为空，则当购物者搜索实体店时，实体店定位器将使用该购物者输入的邮政编码。商店定位器在中定义的常量中 DEFAULT_STORE_LOCATOR_COUNTRY 指定的 app/constants.js国家/地区进行搜索。

对于已在设备上启用位置共享的购物者，实体店定位器会显示购物者设备的 GPS 位置周围的结果。

对于未在设备上启用位置共享的购物者，实体店定位器的初始呈现将显示中这些常量 app/constants.js中指定的默认地理位置的结果。

实体店地址搜索

一次最多可返回 200 家实体店
搜索最大半径 100 公里内的商店

默认单位为 km （km），如中的 app/constants.js常量所 STORE_LOCATOR_DISTANCE_UNIT 指定。（可选）要使用英里作为单位，可以设置为 STORE_LOCATOR_DISTANCE_UNIT mi。

默认最大半径为 100，如中的 app/constants.js常量所指定 STORE_LOCATOR_DISTANCE。或者，您可以设置为 STORE_LOCATOR_DISTANCE 所选的最大半径。

本部分针对使用实体店定位器时可能遇到的常见错误提供建议的解决方案。

潜在原因： 您在 Business Manager 中的位置数据不准确。

建议的解决方案： 确保您的实体店位置信息准确无误，并反映地址、电话号码、营业时间或其他实体店数据的任何更改。请参阅在 B2C Commerce 中管理实体店。