# 羚牛氢能 · 加氢站导航

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

它复用运营地图已经按 GPS 逆地理解析、落盘缓存的站点目录，并只对外提供：名称、位置、省市区、地址与合作状态。车辆数据、加氢量及其他运营字段不会被加载或从这个服务的 API 返回。

## 本地运行

```bash
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 分钟更新一次。省、市、区由运营地图根据 GCJ-02 坐标调用高德逆地理服务生成，结果按坐标缓存 7 天；详细地址仍直接展示资产原始字段。

## ECS 部署

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

```bash
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>
```