Salta al contingut

Integració i API

La dada ha d’entrar on ja treballes

Un portal més que ningú no mira no resol res. La posició es publica perquè aterri al mapa operacional i al gestor d’incidències que el teu equip ja té obert.

Interfícies disponibles

InterfíciePer a quèMode
API RESTConsultar posicions, equips, alertes i històricsPetició sota demanda
WebhooksRebre esdeveniments tan bon punt es produeixen: canvis de posició, alertes, entrades i sortides de zonaEnviament sortint
Exportació programadaBolcats periòdics per a anàlisi i planificacióCSV / JSON

L’autenticació és per credencial de servei amb àmbit acotat i rotació de claus. Tot el trànsit va sobre TLS, amb límit de taxa per credencial i les proteccions habituals davant dels riscos típics d’API.

Com es veu una posició

Aquest és l’esdeveniment que rep el teu sistema quan un equip canvia de posició. L’important no és la coordenada: és que ve acompanyada de la seva qualitat, perquè qui la consumeix pugui decidir fins a quin punt se’n fia.

{
  "event": "position.updated",
  "timestamp": "2026-03-11T09:41:07Z",
  "terminal": {
    "id": "TRM-0043",
    "team": "vigilancia-l2-turno-manana"
  },
  "position": {
    "zone": "station-014",
    "area": "platform",
    "direction": "north",
    "x": 128.4,
    "y": 22.7,
    "srs": "site-local"
  },
  "onboard": {
    "train": "4207",
    "car": 3
  },
  "quality": {
    "accuracy_m": 6.8,
    "source": "wifi-rtt",
    "nlos_suspected": false,
    "map_matched": true
  }
}
  • zone i area són la lectura operativa: estació i recinte. Sol ser l’únic que necessita el gestor d’incidències.
  • x i y són coordenades en el sistema local de l’emplaçament, per pintar sobre el plànol.
  • accuracy_m és el radi d’incertesa estimat d’aquesta lectura concreta, no una constant del sistema.
  • onboard apareix només quan l’agent va en un tren i la capa a bord està desplegada. És una identificació exacta, no una estimació: si l’objecte no hi és, és que no s’està llegint cap balisa de cotxe.
  • nlos_suspected avisa que la mesura podria haver arribat rebotada.
  • map_matched indica si la posició s’ha ajustat al plànol transitable.

Govern de les dades

  • Contractes de dades versionats: els canvis d’esquema s’anuncien i conviuen, no trenquen la teva integració un dimarts.
  • Retenció configurable per tipus de dada, segons la política de l’operador.
  • Anonimització i pseudonimització aplicables als fluxos que no necessiten identificar la persona.
  • Portabilitat: l’històric s’exporta complet quan es demani. Les dades són de l’operador.

Per a un integrador de senyalització, CCTV o comunicacions, aquesta és la pàgina que importa: si l’API és neta, posar Metrosafe en un quadre de comandament existent és feina de dies, no de mesos.

Vols la documentació de l’API?

Digues-nos amb quin sistema el vols integrar i et passem l’especificació completa i un entorn de proves.

Responem en menys de 24 hores laborables.