Upload Configuratie

Configureer upload sets voor het importeren van data in de Upload sectie van Configuratie. Alleen beheerders kunnen upload sets beheren.

Deze documentatie helpt je bij:

• Het voorbereiden van CSV-bestanden met de juiste structuur en formaten
• Het aanmaken en beheren van uploadsets via de interface

Inhoudsopgave

Deze documentatie is opgedeeld in twee delen:

Voorbereiding van CSV-bestanden

• CSV bestandsvereisten - Technische specificaties voor het CSV-bestand

Werken met uploadsets

• Upload sets tabel - Overzicht van alle uploadsets
• Upload set aanmaken - Stap-voor-stap instructies
• Bestand laden en bekijken - Hoe je een bestand laadt
• Upload set beheren - Toevoegen, bewerken en verwijderen
• Tips en problemen oplossen - Hulp bij problemen

CSV bestandsvereisten

Zorg dat je CSV-bestand de juiste structuur heeft:

• Gebruik komma’s als scheidingsteken
• Eerste regel bevat kolomkoppen
• Elke volgende regel bevat één object
• Null-waarden toegestaan als NA, N/A of leeg veld

Verplichte kolommen

• geometry (tekst, WKT): geometrie als POINT(x y) of LINESTRING(x1 y1, x2 y2, ...)
  • WKT (Well-Known Text) is een OGC-standaard formaat voor het representeren van geometrieën
  • Precisie: gebruik maximaal 6 decimalen voor lon/lat coördinaten (bijvoorbeeld 5.073885). Dit geeft een precisie van ongeveer 10 cm, wat voldoende is voor verkeersmetingen en locatiebepaling.
  • Voorbeelden:
    • Punt: POINT(5.073885 5.073885) (lon lat, bijvoorbeeld Utrecht)
    • Lijn: LINESTRING(5.073885 5.073885, 5.076046 52.069516) (meerdere lon lat punten)
• entity_type (tekst): type entiteit. Beschikbare opties: car, bicycle, pedestrian
• metric_type (tekst): type meting. Beschikbare opties: volume, speed, traveltime
• source (tekst): herkomst van de data, bijvoorbeeld kwc, opendata, overig
• date (tekst): datum in formaat YYYY-MM-DD, bijvoorbeeld 2025-01-15
• time (tekst): tijdstip in formaat HH:mm, bijvoorbeeld 13:00
• period_duration (geheel getal): duur van de meetperiode in seconden (wordt automatisch omgezet naar minuten). Beschikbare opties: 60 (1 minuut), 300 (5 minuten), 900 (15 minuten), 3600 (1 uur)
• metric_value (decimaal): gemeten waarde. Moet > 0 zijn (of exact 0 bij volume)
  • Indien metric_type = volume: absolute aantallen (wordt automatisch omgerekend naar per uur)
  • Indien metric_type = speed: km/uur
  • Indien metric_type = traveltime: seconden
• client_id (tekst): unieke identificatie van het meetpunt of segment
• client_name (tekst): leesbare naam van het meetpunt of segment

Unieke ID voor meetlocaties:

Bij het verwerken van upload bestanden worden rijen gegroepeerd op basis van de combinatie van geometry, entity_type en metric_type. Dit betekent dat meerdere rijen met dezelfde geometrie, entity_type en metric_type worden samengevoegd tot één metadata item, ongeacht de client_id.

De manier waarop de unieke ID wordt bepaald verschilt tussen punten en lijnen:

• Voor punten: client_id wordt gebruikt als unieke ID voor het meetpunt (met fallback naar id als client_id ontbreekt)
  • Als meerdere rijen dezelfde geometry, entity_type en metric_type hebben, worden ze gegroepeerd en wordt de client_id van de eerste rij gebruikt
• Voor lijnen: client_id wordt opgeslagen in de metadata en gebruikt voor weergave, maar de unieke ID voor lijnobjecten wordt automatisch gegenereerd op basis van de combinatie van geometry, entity_type en metric_type
  • Dit betekent dat lijnen met dezelfde geometrie, entity_type en metric_type dezelfde ID krijgen, ongeacht de client_id

Belangrijk: Gebruik unieke combinaties van geometry, entity_type en metric_type per meetlocatie, of zorg dat rijen met dezelfde combinatie ook dezelfde client_id hebben om verwarring te voorkomen.

Voorbeelden

Download voorbeeld upload bestanden.zip voor complete voorbeeldbestanden.

Puntmeting (volume)

geometry,entity_type,metric_type,source,date,time,period_duration,metric_value,client_id,client_name
"POINT(4.9000 52.3700)",car,volume,kwc,2024-01-15,08:00,900,120,P123,Sensor A

Lijnmeting (traveltime)

geometry,entity_type,metric_type,source,date,time,period_duration,metric_value,client_id,client_name
"LINESTRING(4.9000 52.3700, 4.9100 52.3750)",car,traveltime,opendata,2024-01-15,08:00,300,420.5,L456,Segment B

Veelvoorkomende fouten en oplossingen

• Ontbrekende verplichte kolom: voeg de kolom toe of vul deze aan.
• geometry niet in WKT formaat: gebruik POINT(x y) voor punten of LINESTRING(x1 y1, x2 y2, ...) voor lijnen.
• Verkeerde kolomvolgorde: zorg dat de kolommen in de juiste volgorde staan (zie voorbeelden hierboven).

Upload sets tabel

De tabel toont alle upload sets met:

• Uploadset naam
• Aangemaakt (datum en tijd wanneer de upload set is aangemaakt)
• Laatst bewerkt (datum en tijd van laatste wijziging, of ”-” als deze niet is bewerkt)
• Acties (upload toevoegen, naam bewerken, verwijderen)

Upload set aanmaken

1. Navigeer naar Configuratie > Upload
2. Klik op de knop “Upload set aanmaken” (rechtsboven)
3. Vul het formulier in:
   • Set naam: Geef de upload set een duidelijke naam
   • Bestand laden: Selecteer of sleep een CSV-bestand (zie Bestand laden en bekijken voor details)
4. Bekijk de geladen objecten in de tabel en kaart
5. Klik op “Opslaan”

Bestand laden en bekijken

Er zijn twee manieren om een CSV-bestand te laden voor weergave in de tabel en kaart:

1. Drag & Drop

   • Sleep een CSV-bestand naar het upload gebied
   • Het bestand wordt automatisch geladen en weergegeven in de tabel en kaart wanneer je loslaat

2. Bestand kiezen

   • Klik op “Upload een bestand” of het upload gebied
   • Selecteer een CSV-bestand van je computer
   • Het bestand wordt automatisch geladen en weergegeven in de tabel en kaart

Ondersteunde formaten

• CSV-bestanden: Alleen CSV-bestanden worden ondersteund
• Zorg dat het bestand de juiste structuur heeft

Wat je ziet na het laden

Na het laden van een bestand zie je:

• Object tabel: Toont alle objecten die zijn geladen met kolommen voor ID, Naam, Entity type, Metric type en aantal nieuwe entries
• Kaart weergave: Visualiseert de geüploade objecten op een kaart op basis van hun geometrie

Upload set beheren

Upload toevoegen aan upload set

1. Vind de upload set in de tabel
2. Klik op de ”+” knop (upload toevoegen aan uploadset)
3. Laad een nieuw CSV-bestand voor weergave in de tabel en kaart
4. Bekijk de geladen objecten
5. Klik op “Opslaan”

Let op: Bij het toevoegen van een upload kun je de upload set naam niet wijzigen.

Upload set naam bewerken

1. Vind de upload set in de tabel
2. Klik op de bewerkknop (potlood icoon)
3. Wijzig de upload set naam
4. Klik op “Opslaan”

Let op: Bij het bewerken van de naam kun je geen nieuw bestand uploaden.

Upload set verwijderen

1. Vind de upload set in de tabel
2. Klik op de verwijderknop
3. Bevestig de verwijdering

Let op: Het verwijderen van een upload set verwijdert alle bijbehorende geüploade objecten. Deze actie kan niet ongedaan worden gemaakt.

Tips en problemen oplossen

Tips voor effectief gebruik

1. Controleer bestandsformaat: Zorg dat je CSV-bestand correct is geformatteerd volgens de CSV bestandsvereisten
2. Bekijk geladen objecten: Controleer de objecten in de tabel en kaart voordat je op “Opslaan” klikt
3. Gebruik duidelijke namen: Geef upload sets logische namen zodat je later gemakkelijk kunt vinden welke data erin zit
4. Test eerst: Test met een klein bestand voordat je grote datasets laadt

Veelvoorkomende problemen

Bestand wordt niet geladen

• Controleer of het bestand een CSV-bestand is
• Controleer de bestandsgrootte (maximaal 100 MB)

Objecten worden niet herkend

• Controleer of alle vereiste kolommen aanwezig zijn
• Controleer de dataformaten (datum, tijd, coördinaten)
• Controleer de kolomvolgorde

Foutmeldingen na laden

• Let op eventuele foutmeldingen die verschijnen na het laden
• Controleer de veelvoorkomende fouten hierboven
• Neem contact op met een beheerder als het probleem aanhoudt