Sensornet

Hvad er Sensornet?

Sensornet er GEUS' løsning til indberetning af pejlinger til Jupiter databasen. Systemet gør det muligt både at automatisere indberetning fra måleudstyr og at registrere data manuelt via en webformular.

Sensornet stilles til rådighed som et REST API, der modtager pejledata i et defineret JSON-format. Derudvoer findes der en form til manuel indberetning. Her kan man manuelt kopiere data ind fra f.eks. regneark.

Alle kan anvende Sensornet efter registrering som bruger. Ved registrering modtages en API KEY, som skal anvendes ved alle kald til systemet.

1. Bruger registreres og modtager API KEY.
2. Pejledata sendes til Sensornet som JSON.
3. Data valideres mod Sensornets JSON-schema.
4. Godkendte data overføres automatisk til Jupiter.

Forudsætninger

For at data kan overføres til Jupiter skal DGU-nummeret og det angivne indtagnummmer allerede eksistere i Jupiter.

Hvis pejlinger er angivet i forhold til pejlepunkt skal dette også eksistere i Jupiter

Ved meget højfrekvente målinger foretages en begrænset udtynding, således at kun den første måling pr. indtag pr. time overføres til Jupiter.

Data overføres automatisk til Jupiter efter en kort forsinkelse (typisk omkring 10 minutter).

• DGU-nummer
• Indtagsnummer
• Kalibreringsstatus (raw eller calibrated)
• Referencepunkt (K, M eller T)
• Kotesystem (typisk DVR90 ved referencepunkt K)
• Array af målinger med tidspunkt og værdi

• Pejlemetode
• Projektnavn
• Dataejer
• Bemærkning
• Pejlesituation
• Atmosfærisk lufttryk
• Pejleekstremer
• UUID

Opdatering og sletning af data

UUID-feltet gør det muligt at opdatere eller slette tidligere indberettede målinger.

• Send samme UUID med nye værdier for at opdatere data.
• Send samme UUID uden måleværdi for at slette data.
• Målinger kan også rettes ved at gensende samme kombination af:
  • DGU-nummer
  • Indtagsnummer
  • Måletidspunkt

Validering

Alle data skal overholde Sensornets JSON-schema. Data, der ikke validerer korrekt, behandles ikke.

API-svaret indeholder felterne:

• valid – angiver om data validerer.
• errors – beskriver fundne fejl.

Se eksemplet nedenfor for korrekt JSON-format.

{
  "schema_name": "http://data.geus.dk/sensornet/json/geus_sensor_schema_v1.json",
  "boreholeno": "201.4990",
  "intakeid": 1,
  "calibrated_status": "calibrated",
  "refpoint": "K",
  "verticaref": "DVR90",
  "measurements": [
    {
      "timestamp": "2018-11-13T20:20:39",
      "waterlevel": 11.234
    },
    {
      "UUID": "bfc85bd2-00cb-4756-916d-892019432771",
      "timestamp": "2018-11-13T21:20:39",
      "waterlevel": 12.052,
      "chloride": 461.15976,
      "temperature": 11.916792,
      "atmospress": 1000.0
    },
    {
      "UUID": "bfc85bd2-00cb-4756-916d-89201222771b",
      "timestamp": "2018-11-13T21:25:39",
      "waterlevel": 12.042,
      "situation": 0
    },
    {
      "UUID": "bfc85bd2-00cb-4756-916d-892234b0771a",
      "timestamp": "2018-11-13T21:28:39",      
      "extremes": "T"
    }
  ],
  "company_name": "cyberdyne",
  "sensortype": "IK-500",
  "method": "T",
  "project": "ANDET",
  "dataowner": "GE"
}  

Søgning og visualisering

Sensornet indeholder både en søgeside og en kortvisning, hvor de indberettede data kan ses og kontrolleres.

Kontakt

Kontakt gerne vra@geus.dk ved spørgsmål eller behov for hjælp til brug af Sensornet.