Performance Hub 徽标Performance Hub
网站版块： 文档

地理围栏

本页内容

地理围栏将解锁限制为实际位于设施附近的人员。启用后，移动应用必须上报位于配置圆形区域内的位置，才允许解锁，从而防止有人在家中开门。在 Settings → Geofencing 下配置设施地理围栏；范围和单扇门可以覆盖该设置。

Settings 中的 GeofencingSettings 中的 Geofencing

图 1：设施地理围栏编辑器

检查的工作方式

当用户轻点解锁时，其手机会发送当前位置和 GPS 精度。由服务器（而不是手机）做出判断：

  1. 未上报位置 → 拒绝，并提示用户启用定位服务。（原因：位置不可用）
  2. GPS 精度不足：读数的精度差于 Require GPS accuracy better than 阈值 → 拒绝。这可以防止不可靠的读数（例如在信号较差的室内）被采信。（原因：GPS 精度不足）
  3. 距离检查：用户与地理围栏中心的距离必须在以下范围内：半径 + 上报的 GPS 精度 + 精度缓冲。超出该范围 → 拒绝，应用会建议用户靠近。（原因：位于地理围栏之外）
  4. 位于范围内 → 地理围栏检查通过，并继续执行其余的访问决策。

由于 GPS 精度会计入允许范围，站在边界处且精度为 ±15 m 的用户仍然可以通过。该检查旨在避免因正常 GPS 噪声而误拒，同时阻止远程解锁。判断在服务器端做出，因此被篡改的应用或伪造的位置仍会被拒绝。

如果启用了地理围栏，但缺少图钉/中心点，解锁将被拒绝（系统采用失败即关闭原则），请务必确认已放置图钉。

设置

设置默认值范围作用
Require user to be at facility (geofence)新的设施配置默认开启开 / 关总开关。关闭时显示："Geofence is disabled — anyone with credentials can open the door from anywhere."
Radius200 m50–5000 m（滑块，步长 10 m；预设 50/200/500/1000 m）以图钉为中心、允许解锁的圆形区域
Accuracy buffer (m)25 m—计入允许范围的额外米数，用于容忍正常的 GPS 噪声
Require GPS accuracy better than (m)100 m—精度差于此值的读数会被直接拒绝

放置图钉

  • 将图钉拖动到设施中心，或使用 Search address（"Start typing a street address…"）将其放置到某个地址上。
  • Reset to facility location 会将图钉恢复到设施已保存街道地址的坐标。当图钉被移离已保存位置时，会显示 Pin manually placed 标签。
  • 如果设施没有登记街道地址（会附带指向设施及系统配置的链接；请参阅设施位置），或者图钉距离设施已保存位置超过 500 m，系统会显示警告。这两种情况通常都意味着需要更新设施地址。

测试地理围栏

点击 Test Geofence 进入测试模式：地图上会出现一个紫色的 T 图钉。将其拖动到任意位置，即可模拟用户在该处解锁，编辑器会立即显示 Would pass 或 Would be denied，以及原因和距离。点击 Stop testing 退出。保存前可用此功能检查半径是否合理，例如确认停车场在范围内，而街对面的咖啡馆不在范围内。

覆盖层级

默认情况下，设施地理围栏适用于每扇门。有两个层级可以覆盖它，最具体的层级优先：

层级位置选项
访问范围Settings → Access Scopes → 范围 → Geofence 选项卡Geofence override 开关及其独立的完整编辑器
门Doors → 门面板 → Geofence 选项卡Inherit from facility / Override for this door / Disable geofence for this door

单扇门覆盖设置优先于范围覆盖设置，而范围覆盖设置又优先于设施默认值。对于员工经常在尚未到达现场时就解锁的后场或服务入口，为单扇门禁用地理围栏非常有用。Doors 选项卡上的每张门卡片都会显示其有效地理围栏（半径或 Off，若为门专属设置，则附加 · Override）。

会员看到的内容

当因地理围栏而被拒绝时，应用会说明原因，而不是静默失败：

情况应用行为
位于地理围栏之外显示“请靠近”类消息及距离
GPS 精度不足提示用户走到室外/获取更清晰的 GPS 定位
定位服务已关闭提示为应用启用定位权限

所有因地理围栏导致的拒绝都会连同原因和距离（如有）记录在访问日志中，便于调查“无法进入”之类的反馈。