GeoVeil API - Documentație v2.0

Sistemul de Monitorizare GNSS

API-ul GeoVeil oferă acces la datele de interferență GNSS colectate de rețeaua de 82 de stații distribuite pe teritoriul României. Sistemul detectează și înregistrează evenimente de interferență pe benzile L1, L2 și L5, permițând analiza în timp real și corelarea evenimentelor între stații multiple.

din nov.2024

Date zilnice WAL

24/7

Monitorizare continuă

REST

Format JSON

Logica de Corelație

Endpoint-ul /ce identifică evenimente simultane folosind următorii algoritmi:

1

Grupare pe Frecvență

Evenimentele sunt grupate după centfreq_mhz, rfpath și bandwidth_mhz

2

Filtrare Multi-Stație

Se păstrează doar grupurile detectate de ≥2 stații diferite

3

Agregare Temporală

Se calculează prima/ultima apariție și numărarea pe minute distincte

4

Statistici

Se calculează avg_power_loss și occurrence_count

💡 Notă: Evenimentele corelate sugerează surse de interferență externe (jammere, echipamente defecte, interferență militară) care afectează o zonă geografică extinsă.

Evenimente de Interferență

Obține datele de interferență GNSS pentru o stație și interval de timp specificat.

GET

Endpoint URL

GET https://api.geoveil.ro/v2/i

Parametri

station_code

string

Codul stației (ex: TIM1, BUCU, IASI)

Exemplu: TIM1

start_date*

string

Data de început în format YYYY-MM-DD

Exemplu: 2025-12-05

end_date*

string

Data de sfârșit în format YYYY-MM-DD

Exemplu: 2025-12-05

Exemplu de Apel

https://api.geoveil.ro/v2/i?station_code=TIM1&start_date=2025-12-05&end_date=2025-12-05

Răspuns Exemplu

[
  {
    "id": 12345,
    "stationid": 71,
    "datetime": "2025-12-05T14:30:00+02:00",
    "rfpath": "L1",
    "centfreq_mhz": 1575.42,
    "bandwidth_mhz": 2.046,
    "powerloss_dbm": -45.2,
    "hestpowspecdens_dbmhz": -120.5,
    "event_key": "20251205143000-1575.42-2.046",
    "station_code": "TIM1"
  }
]

Câmpuri Răspuns:

rfpath - Banda de frecvență (L1, L2, L5)

centfreq_mhz - Frecvența centrală în MHz

bandwidth_mhz - Lățimea de bandă în MHz

powerloss_dbm - Pierderea de putere în dBm

hestpowspecdens_dbmhz - Densitatea spectrală

datetime - Timestamp fus orar local

Evenimente Corelate

Identifică evenimentele detectate simultan de multiple stații.

GET

Endpoint URL

GET https://api.geoveil.ro/v2/ce

Parametri

start_date*

string

Data și ora de început în format ISO

Exemplu: 2025-12-05T00:00:00Z

end_date*

string

Data și ora de sfârșit în format ISO

Exemplu: 2025-12-05T23:59:59Z

Exemplu de Apel

https://api.geoveil.ro/v2/ce?start_date=2025-12-05T00:00:00Z&end_date=2025-12-05T23:59:59Z

Răspuns Exemplu

[
  {
    "stations": ["TIM1", "ARAD", "DEVA"],
    "central_frequency": 1575.42,
    "rf_path": "L1",
    "bandwidth": 2.046,
    "first_occurrence": "2025-12-05T10:15:00Z",
    "last_occurrence": "2025-12-05T10:45:00Z",
    "avg_power_loss": -42.8,
    "occurrence_count": 15
  }
]

Câmpuri Specifice Corelației:

stations - Lista stațiilor care au detectat

occurrence_count - Minute distincte cu detecții

first_occurrence - Prima detecție

last_occurrence - Ultima detecție

avg_power_loss - Media pierderii de putere

Ultima Oră

Obține evenimentele din ultima oră - ideal pentru monitorizare în timp real.

GET

Endpoint URL

GET https://api.geoveil.ro/v2/lh

Parametri

station_code

string

Codul stației (opțional - fără parametru returnează toate stațiile)

Exemplu: BUCU

Exemple de Apel

Toate stațiile:

https://api.geoveil.ro/v2/lh

Stație specifică:

https://api.geoveil.ro/v2/lh?station_code=BUCU

Lista Completă Stații

Toate cele 82 de stații GNSS din rețeaua GeoVeil România.

82 Stații

💡 Tip: Folosește codul stației (ex: TIM1) în parametrul station_code pentru apelurile API. Click pe orice stație pentru a copia codul.

Ghid de Pornire Rapidă

1. Verifică evenimente pentru o stație

curl "https://api.geoveil.ro/v2/i?station_code=TIM1&start_date=2025-12-05&end_date=2025-12-05"

2. Monitorizare în timp real

curl "https://api.geoveil.ro/v2/lh"

3. Găsește evenimente corelate

curl "https://api.geoveil.ro/v2/ce?start_date=2025-12-05T00:00:00Z&end_date=2025-12-05T23:59:59Z"

4. JavaScript Fetch

fetch('https://api.geoveil.ro/v2/lh')
  .then(r => r.json())
  .then(console.log)