lingniu-vehicle-ingest/station-navigation/README.md

羚牛氢能 · 加氢站导航

面向运维和司机调度的独立公共站点导航服务，默认本地端口为 20804。

它只调用一次上游加氢站目录接口，并通过正向字段白名单对外提供：名称、位置、省市区、地址与合作状态。车辆数据、加氢量及其他运营字段不会被加载或从这个服务的 API 返回。

本地运行

export OPEN_PLATFORM_APP_KEY='<32位AppKey>'
./start-local.sh

访问 http://127.0.0.1:20804/。

API

• GET /api/stations：公开站点目录，不包含加氢量字段；
• GET /api/health：进程健康状态；
• 其他 /api/* 路由均返回 404。

站点目录在服务端缓存 2 分钟，并在服务启动后后台预热；因此正常页面打开直接返回缓存数据，最多延迟 2 分钟更新一次。

ECS 部署

服务运行在 20804，与运营地图端口隔离。部署单元复用 /opt/lingniu-vehicle-map/env/vehicle-map.env 中已有的 Open Platform 凭据，并通过 VEHICLE_MAP_ASSET_ROOT=/opt/lingniu-vehicle-map/current 复用一致的品牌样式。

install -m 0644 deploy/lingniu-station-navigation.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable --now lingniu-station-navigation.service
deploy/install-release.sh <release-id> <release.tgz>