# Gelios provider package v3

Version 3 describes the production REST transport used by the L2 workflow:
`GET https://api.geliospro.com/api/v1/units`. The provider credential keeps the
Gelios access/refresh pair inside native NDC L2 Credentials; n8n refreshes the
access token at request time and exposes neither secret to the graph. The
normalized output is the immutable provider-neutral Data Product
`fleet.positions.current.v2@2.0.0`.

The product adds four orthogonal state facets owned by L2 semantic mapping:

- `availability_state`: `online`, `offline`, `unknown`;
- `motion_state`: `moving`, `stationary`, `unknown`;
- `position_state`: `valid`, `low_quality`, `missing`;
- `freshness_state`: `fresh`, `stale`.

`state_policy_version` identifies the mapping policy that produced the facets.
`operational_status` remains in the product as a backwards-compatible coarse
state; presentation classes, colours, pin proportions and label geometry remain
Foundry-owned and are never part of this provider package.
