位置服务

GeoHermes

GeoHermes-位置服务平台

GeoHermes:位置服务平台

GeoHermes 是一个专业的位置能力平台,专注于提供核心的位置数据处理服务。它负责登记设备、接入点位、查询当前位置与历史轨迹、管理电子围栏,并将实时位置数据与进出事件高效交付给上层业务系统。

在架构设计上,GeoHermes 严格遵循职责分离原则:人员、车辆、资产的档案信息、审批流程以及「谁能看谁」的权限管理均保留在业务系统中。GeoHermes 仅识别已登记的设备,并处理落在这些设备上的位置事实。每个业务产品在平台上对应一个独立的应用,数据按应用进行严格隔离,确保数据安全与隐私。

图示解读:

  • 上半部分:左侧业务系统保留姓名、车牌、资产编号等敏感信息,以及审批和查看权限。跨越边界传递到右侧 GeoHermes 平台的仅有设备编号。平台不知道设备归属的具体人员或车辆,只知道该已登记设备的当前位置和历史路径。未登记的设备数据无法接入。
  • 下半部分:体现应用隔离机制。例如,人员定位产品和车队管理作为两个不同的业务产品,分别对应平台上的应用 A 和应用 B。两者的位置数据互不可见,实现逻辑隔离。

图源:diagrams/who-keeps-what.svg。图内文字为 ASCII,含义如下表所示:

图上文字 含义
BUSINESS KEEPS 业务系统保留的内容
Person / Vehicle / Asset 人员、车辆、资产档案(姓名、车牌、编号)
Also stays on this side 审批,以及谁可以看谁,都不交给平台
ONLY THIS / device code 两边之间只传递设备编号
GEOHERMES SEES 平台实际认得的东西
Device 已登记设备;上面没有姓名和车牌
Place 这台设备的当前位置和走过的路径
One product = one application 一个业务产品对应一个应用
Staff-location product / Application A 例如人员定位产品,位置只在应用 A 里
Fleet product / Application B 例如车队产品,位置只在应用 B 里
no cross access 两个应用的位置互不可见

协同架构

上层业务系统作为产品层,直接面向终端用户。用户只需登录业务系统,即可在统一的界面中完成地图查看、轨迹回放、告警管理及权限控制。业务后台是 GeoHermes 的唯一调用方,通过 SDK 将请求发送至平台,并将返回的位置事实渲染回业务界面。

GeoHermes 向业务侧交付五项核心能力,这些能力构成了位置服务的完整闭环:

图源:diagrams/collaboration.svg。图内文字为 ASCII,含义如下表所示:

图上文字 含义
UPPER BUSINESS 上层业务系统:人员、车队或资产产品
End user 终端用户只登录业务系统
Business UI 业务界面:地图、回放、告警文案、谁能看谁
Business backend + SDK 业务后台,持有应用密钥,经 geohermes-sdk 调用平台
BUSINESS OWNS 业务自己保留的主数据、审批、协议解码和通知渠道
call 后台发起的能力调用
facts 平台返回的位置事实,由业务界面呈现
GEOHERMES 位置能力平台;下面五行是能力输出
Device / deviceId 审批通过后登记设备,得到稳定设备标识;未登记不收点
Ingest / fix 收下规范化点位
Query / Current/Track 当前位置,以及不抽稀的历史轨迹
Fence / ENTER/LEAVE 围栏与绑定之后的进入、离开(含禁入或活动范围)
Subscribe / stream 一条实时连接上的位置流;围栏边沿已落库,可补拉
applicationId 平台按应用隔离数据;控制台只做应用运维,不是业务界面

平台提供直观的控制台界面,方便管理员查看设备实时轨迹及历史轨迹:

控制台地图与围栏

同时支持查看设备产生的围栏事件,事件会通过消息流即时发送给应用侧,便于业务系统进行后续处理:

围栏事件

核心能力

GeoHermes 提供以下关键功能,帮助业务系统快速构建位置服务能力:

  • 先登记,再收点 业务侧在审批通过后登记设备,获取稳定的设备标识。平台拒绝接收未登记设备的定位数据,不会因为收到第一条定位点就自动建档,从源头确保数据的合规性与准确性。
  • 当前位置与历史轨迹 支持查询设备的实时位置,也可按时间窗口提取历史轨迹点列。平台忠实记录观测事实,不对轨迹数据进行采样抽稀,保留完整的移动细节。
  • 围栏与进出事件 支持多边形规则的电子围栏,分为「禁入」与「活动范围」两种类型。设备需先与围栏绑定,当点位进入判定范围后,平台才会触发进入或离开事件。事件中包含围栏种类信息,业务侧可据此生成个性化的告警文案。当同一设备关联多个活动范围时,平台会对并集整体发出进入/离开事件。
  • 实时订阅,断线可补 通过一条实时连接,同时送达新位置数据和围栏进出事件。围栏进出事件会优先落库存储,若业务后台出现短暂中断,恢复后可按时间补拉数据,确保不依赖实时连接作为唯一的数据记录来源,提高系统的可靠性。
  • Java 客户端支持
    业务后台可使用 geohermes-sdk 进行票据交换、设备登记、点位推送、数据查询及订阅等操作。应用密钥仅存储在业务后台,保障安全性。

适用场景

GeoHermes 特别适合以下团队使用:

  • 希望掌控业务逻辑的团队:正在开发人员定位、车队管理或资产跟踪应用,希望自行掌握用户管理、组织架构和告警策略,仅将位置数据底座外包给专业平台的团队。
  • 已有数据采集能力的团队:拥有现有的采集设备或协议网关,能够将终端报文解析为经纬度与观测时刻,需要稳定的数据写入、查询服务以及精准的围栏判定能力。

平台控制台主要供管理员登记应用,或由集成商认领后进行只读核对。最终的业务用户始终登录其所属的业务系统,享受无缝的服务体验。