Dit document beschrijft het proces voor het aanmelden en beheren van parkeer datasets ten behoeve van de Parkeer Data Catalogus van het Ministerie van Infrastructuur & Milieu.
1
Aanmelden nieuwe parkeer dataset
Stap 1 De parkeer exploitant legt contact met de service desk van Caesar Experts (https://parkeerdatacatalogus.nl/Contact) om een parkeerdataset aan te leveren. Stap 2 De servicedesk maakt op basis van de contactgegevens van de aanbieder een account aan op http://dropit.caesar.nl en verstuurt de aanmeld gegevens naar de aanbieder, inclusief deze handleiding en een Microsoft Excel template met daarin een beschrijving van het dataformaat waarin de parkeerdataset aangeleverd moet worden. Stap 3 De aanbieder vult de juiste gegevens in het Microsoft Excel template bestand in. Meer informatie over de Microsoft Excel template kunt u vinden in hoofdstuk 5. Mocht u nog vragen hebben, neem dan contact op met de service desk van Caesar Experts (https://parkeerdatacatalogus.nl/Contact). Stap 4 De aanbieder upload de Microsoft Excel bestand uit stap 3 via het DropIT portaal; eventueel vindt er tijdens het proces of achteraf telefonische afstemming plaats tussen aanbieder en servicedesk. Hoe de gegevens ge-upload kunnen worden staat in hoofdstuk 4 beschreven. Stap 5 De aangeboden metadata wordt via een automatisch proces ingelezen. Dit proces wordt elke 12 uur uitgevoerd en beschikbaar gesteld via de Parkeer Data Catalogus. Binnen 72 uur na de aanlevering door de aanbieder meldt de servicedesk terug aan de aanbieder dat de aanlevering geslaagd is. Als er tijdens het inlezen fouten worden geconstateerd (bijv. wanneer de aanlevering niet conform de Microsoft Excel template is aangeleverd), dan neemt de servicedesk contact op met de aanbieder.
2
Wijzigen bestaande parkeer dataset
Het proces voor het wijzigen van een dataset is niet anders dan voor het aanmelden van een nieuwe dataset. De aanbieder van de dataset kan het proces zoals genoemd bij “aanmelden nieuwe parkeer dataset” starten vanaf stap 2. Wel is in dit geval belangrijk dat de identifiers van de gewijzigde items in de dataset exact overeenkomen met de identifiers van de items in de eerder aangeboden dataset.
3
Verwijderen parkeer dataset
Het proces voor het verwijderen van een dataset is identiek aan het proces “wijzigen bestaande parkeer dataset”, met één verschil: om een item uit de dataset te verwijderen dient het veld “EinddatumDataset” in de Microsoft Excel template ingevuld te worden met de datum vanaf wanneer het item niet meer geldig is.
4
Bestand uploaden via DropIT portaal
4.1
U heeft nog geen DropIT account
4.1.1 U heeft een uitnodiging ontvangen via de mail U krijgt via de mail onderstaande uitnodiging voor het gebruiken van het DropIT portaal dat speciaal ingericht is voor de Parkeer Data Catalogus. Deze email is afkomstig van
[email protected] Controleer uw Spam map als u de email niet in uw postvak kunt vinden.
4.1.2 Registreren bij DropIT portaal Klik op de knop “Get started with DropIT!”. U wordt automatisch doorverwezen naar onderstaande website om uw registratie te voltooien.
In dit scherm vult u uw gegevens in en klikt vervolgens op “Start using DropIT”. U bent nu klaar om DropIT te gaan gebruiken. Lees verder bij 4.2 U heeft al een DropIT account
4.2
U heeft al een DropIT account
Ga met een webbrowser naar het volgende adres: http://dropit.caesar.nl Onderstaande website wordt getoond.
Kies rechtbovenin de optie “Login”. Onderstaand scherm wordt getoond.
Meld u aan met uw emailadres en wachtwoord waarmee u zich eerder geregistreerd heeft. Na een succesvolle aanmelding kunt u verder bij 4.3 Bestand uploaden.
4.3
Bestand uploaden
Nadat u succesvol bent aangemeld wordt onderstaand dashboard getoond met daarin een lijst van alle bij het systeem bekende uploads. Met dit scherm kunt nu nieuwe bestanden uploaden.
Kies voor “Upload a file” om een dataset te uploaden naar het DropIT portaal. U krijgt een scherm te zien waarmee u op uw eigen computer het juiste bestand kan kiezen.
Na het klikken op ‘Openen’ wordt het gekozen bestand automatisch naar de website ge-upload.
4.3.1 Bestand uploaden voltooid Zodra de upload voltooid is wordt het bestand in de lijst met “Your uploaded files” geplaatst, inclusief bestandsgrootte en de datum waarop het bestand is ge-upload.
Het bestand staat nu klaar voor het automatisch inlezen in de datacatalogus. Er is verder geen actie meer nodig. Na verwerking van het bestand wordt u door de servicedesk van Caesar Experts op de hoogte gesteld van het resultaat.
5
Microsoft Excel Template
Via de Microsoft Excel template worden de gegevens over de dataset aangeboden aan de Parkeer Data Catalogus. Hieronder vindt u meer uitleg over de verschillende kolommen en wat hierin wordt verwacht. A. Identifier: Een uniek kenmerk van deze parkeergelegenheid. Voorbeeld: denbosch_129000001. B.
Title: Naam van de parkeergelegenheid. Voorbeeld: P07 Hekellaan
C. URL: De internet URL van de parkeergelegenheid Voorbeeld: http://opd.itt.nl/Data/parkingdata/v1/denbosch/dynamic/denbosch_129000001.json D. StartDatumDataset: Vanaf wanneer deze data geldig is. Voorbeeld: 30-05-1986 E.
EindDatumDataset: Tot wanneer deze data geldig is. Voorbeeld: 31-12-2099
F.
Lattitude: De breedtegraad waar deze parkeergelegenheid ligt Voorbeeld: 51,686
G. Longitude: De lengtegraad waar deze parkeergelegenheid ligt Voorbeeld: 5,31677 H. Omschrijvingdataset: Een omschrijving voor deze parkeergelegenheid. Voorbeeld: Dit is een parkeergarage in Den Bosch. I.
InstructionalMethod: Een link naar eventuele instructie gegevens over de gegevens Voorbeeld:
J.
License: Een link naar eventuele licentie gegevens. Voorbeeld: http://www.q-park.nl/nl/bottommenu/disclaimer
K.
PublisherName: Naam van de publicist Voorbeeld: Den Bosch
L.
ContactPersoon_Firstname: Voornaam van de contactpersoon Voorbeeld: Piet Jan
M. ContactPersoon_Lastname: Achternaam van de contactpersoon Voorbeeld: Klaassen N. Contactpersoon_Email: E-mail adres van de contactpersoon Voorbeeld:
[email protected] O. Contactpersoon_Phone: Telefoonnummer van de contactpersoon Voorbeeld: 012-3456789 P.
Contactpersoon_ispublic: Mogen de gegevens van de contactpersoon op de website zichtbaar zijn. Voorbeeld: True of False
Q. Format: Betreft de informatie van de URL Statische of Dynamische data: Voorbeeld: Static of Dynamisch
R.
Interval: Hoe vaak wordt de gegevens van deze parkeergelegenheid ververst. Hierin wordt een eenheid gegeven. Voorbeeld: Jaar, Maand, Dag, uur, Minuut of seconde
S.
Aantal: Hoe vaak wordt de gegevens van deze parkeergelegenheid ververst. Hierin wordt een getal gegeven. Voorbeeld: 5