Nearby 模板基于 Instant Apps 中的 Nearby Web 应用程序模板。 此模板提供原生应用程序体验以发现附近位置，并包含过滤器以按距离或要素类别缩小搜索范围。
要求
Nearby 模板使用要求如下：
- 提供一个或多个 Nearby web 应用程序。 此类应用程序可以是单个有效项目 ID、包含多个 Nearby web 应用程序的群组的 ID 或包含多个项目 ID 的搜索查询。
- Nearby web 应用程序可以为公共应用程序或受保护应用程序。 要通过 OAuth2 访问 ArcGIS Online 组织或 ArcGIS Enterprise 门户中的受保护 Web 应用程序，请注册应用程序并提供一个客户端 ID。 有关详细信息，请参阅注册应用程序。默认情况下，Nearby 库中仅显示公共 Nearby web 应用程序。 要访问受保护 Nearby web 应用程序，请单击设置 > 许可 > 库，然后提供一个客户端 ID。
- 或者，如果您想使用 ArcGIS 路径服务在 Nearby 模板应用程序中查看转弯方向，则需要通过单击设置 > 属性 > 库来提供 API 密钥，或在设置中启用支持受保护的 Web 应用程序属性并要求最终用户登录 Nearby 应用程序。
自定义应用程序
创建应用程序后，可以通过更改应用程序设置对其进行自定义。
启动 AppStudio，然后在侧面板中，单击设置 > 属性。 下表列出了 Nearby 属性选项卡中各个选项卡的内容，并按照它们在选项卡中的显示位置及其用途进行排序。 也可以在应用程序的 appinfo.json 文件中直接修改这些属性。 如果对上述属性做出了任何更改，再次启动应用程序之前请单击应用对其进行保存。
“启动画面”选项卡内容
| 属性 | JSON 名称 | 类型 | 描述 |
|---|---|---|---|
| 背景图像 | startBackground | 字符串（图像 URL） | 用于“启动”页面背景的图像。 |
| 标识颜色 | brandColor | 字符串（颜色值） | 用作原色的颜色。 |
| 标题字体文件 | mediumFontTTF | 字符串（字体文件 URL） | 设置在整个应用程序中使用的自定义标题字体。该字体将用于标题、页面标题等。 |
| 文本字体文件 | regularFontTTF | 字符串（字体文件 URL） | 设置在整个应用程序中使用的自定义标题字体。该字体将用于照片、文本等的描述。 |
| 反馈电子邮件 | feedbackEmail | 字符串（电子邮件 ID） | 用于接收用户反馈的电子邮件地址。 |
| 显示免责声明 | showDisclaimer | 布尔值 (true|false) | 将免责声明文本显示为应用程序中的弹出窗口。此文本内容节选自详细信息选项卡的访问和使用约束部分。 |
“库”选项卡内容
| 属性 | JSON 名称 | 类型 | 描述 |
|---|---|---|---|
| Nearby web 应用程序 | galleryMapsQuery | 字符串 | 输入 ArcGIS 查询以在库中列出有效的 Nearby web 应用程序。 这可以是 Web 应用程序的单个有效项目 ID（例如 id:0b28ef391fe44fc5bc2b0bcd3f5bbbcb）、包含多个 Web 应用程序的群组 ID（例如 group:47597bdf4b6d49fd85c0f4175a6e7b60）或具有多个 Web 应用程序项目 ID 的搜索查询（例如 id:0b28ef391fe44fc5bc2b0bcd3f5bbbcb 或 id:6efd8324a57247c79a7ec9a66a9bf581）。 |
| 将显示在库中的结果总数 | maxNumberOfQueryResults | 数值 | 输入应从门户查询中返回的最大 Web 应用程序数。 |
| Portal URL | portalUrl | 字符串 | 用于查询 Nearby web 应用程序的门户 URL。 |
| 支持受保护的 Web 应用程序 | supportSecuredMaps | 布尔值 (true|false) | 提供根据查询参数登录组织以访问受保护 Web 应用程序的功能。 |
| 跳过登录 | enableAnonymousAccess | 布尔值 (true|false) | 如果将支持受保护 Web 应用程序设置为 true，则将此选项设置为 true 可以提供绕过登录并且仅显示库中公开提供的 Web 应用程序的功能。 |
| API 密钥 | APIKey | 字符串 | 提供 API 密钥以授予对路径服务的访问权限，以便在 Nearby 模板中显示转弯方向。 请注意，当您注册 Esri 开发者 帐户时，系统会为您创建一个 API 密钥。 如果您已拥有 ArcGIS 帐户，则可以登录 Esri 开发者 帐户以查看此 API 密钥并创建更多 API 密钥。 |
| 门户排序字段 | portalSortField | 字符串 | 用于对库中显示的 Web 应用程序进行排序。 可能的值包括：title、created、type、owner、modified、avgRating、numRatings、numComments、numViews。 |
| 门户排序顺序 | portalSortOrder | 字符串 | 与库排序字段结合使用，以按升序或降序对 web 应用程序进行排序。 可能的值是 asc 或 desc。 |