NODEDC_PLATFORM/packages/external-provider-contract/providers/gelios/v3/README.md

1016 B

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.