Memo Aan Datum Onderwerp Afnemers KV1 Van GVB – FB support Afdeling Vervoersystemen 09 april 2014 Doorkiesnr 020 4606660 V1.3 E-mail [email protected] KV1 levering GVB Pagina 1 van 3 Inleiding In deze memo wordt de KV1 levering van GVB op de openbare locatie beschreven en toegelicht. KV1 implementatie KV1 van GVB is gebaseerd op het BISON koppelvlak versie 8.1.1.0. KV1 bevat de geplande dienstregeling. Een dienstregeling betekent een verzameling van gegevens over lijnen en de bijbehorende haltes, punten en passagetijden. Een KV1 DELTA is een dienstregeling van een beperkt aantal lijnen met dezelfde geldigheid, met als doel het publiceren van de afwijkingen ten opzichte van de reeds eerder geleverde dienstregeling. Korte inhoudelijke toelichting - GVB levert de passeertijden variant. - USRSTAR (haltegebied) wordt gevuld met referentiepunten. Hiermee worden haltes gebundeld die logisch bij elkaar liggen en die voor reizigers als busstation of overstappunt gelden. - TILI: bij MinimalDriveTime kan in de CSV geen onderscheid worden gemaakt tussen Transporttypes en dus geldt hier “de kortste rijtijd over modaliteit heen”. In de XML is transporttype toegevoegd dus daar is wel onderscheid tussen modaliteiten. - POINT: In het CSV bestand staan alleen RD-coördinaten. In het XML bestand staan zowel RD als WGS-coördinaten. - ORUNORUN: GVB laat deze tabel leeg. - JOPATILI: In deze tabel wordt aangegeven welke haltes bij GVB tijdhaltes zijn. Frequentie van publiceren KV1 GVB levert 1x per jaar een basisbestand (baseline) voor het hele jaar. GVB levert (gemiddeld) wekelijks delta’s die één of meerdere lijnen in de basis vervangen voor een afgebakende periode (geldigheid). Uitplannen van lijnen Wanneer een lijn gedurende een periode van één tot vijf dagen niet rijdt, zal GVB hiervoor een delta publiceren. Deze delta zal een geldigheid hebben van 1 dag vóór tot en met 1 dag ná de periode van niet-rijden. Binnen deze dataset zal OPERDAY voor de tussenliggende dagen niet gevuld zijn. Voorbeeld: lijn 1 rijdt niet in het weekend van 27 en 28 juli. GVB levert een delta met een geldigheid van 26 juli t/m 29 juli. In deze dataset zal de OPERDAY voor 27 en 28 juli niet aanwezig zijn. Dit geeft aan dat deze lijn op 27 en 28 juli niet rijdt. Wanneer een lijn langer dan vijf dagen niet rijdt, biedt het huidige KV1(delta) model van GVB geen mogelijkheid om dat door te geven. GVB zal de afnemers hiervoor via email aan de bekende contactpersonen informeren, met verzoek deze lijn uit te plannen. Memo Datum 09 april 2014 Pagina 2 van 3 Leveringsvorm Het basisbestand en de delta’s worden beschikbaar gesteld op een internetlocatie die bereikbaar is via het indexbestand, dat aangeeft welke bestanden relevant zijn. Deze internetlocatie is: http://pol.gvb.nl/gvbpublicatieinternet/KV1/KV1index.xml NIEUW Het indexbestand verwijst naar de .zip bestanden waarin zowel de CSV als de XML bestanden zitten. GVB stelt de KV1 bestanden ter beschikking op een openbaar toegankelijke plek op internet. Het is aan de afnemer om in te richten op welke wijze deze bestanden worden opgehaald. GVB wil hierin ondersteunen door middel van het indexbestand, zodat het proces van ophalen door onze afnemers zoveel mogelijk geautomatiseerd kunnen verlopen. GVB levert geen maatwerkoplossingen per afnemer. Toelichting KV1Index.xml <mutatiedatum> Het indexbestand begint met een mutatiedatum op het hoogste niveau. Hier wordt de hoogste waarde van <isgepubliceerd> weergegeven. Een afnemer kan aan dit nummer zien of er ten opzichte van de vorige controle nieuwe KV1 bestanden gepubliceerd zijn. <lastindex> Hier wordt het hoogste nummer van <index> weergeven. Een afnemer kan aan dit nummer zien of er ten opzichte van de vorige controle nieuwe KV1 bestanden gepubliceerd zijn. <periode key> Elke periode krijgt een unieke key mee van de applicatie waarmee GVB KV1 bestanden aanmaakt. Een afnemer kan dit veld gebruiken ter identificatie van bestanden, maar kan ook <index> gebruiken; deze laatste is een unieke nummering die begint bij 1, en daarmee gebruikersvriendelijker is om te lezen dan deze periodekey. <dataownercode> Dit veld geeft de eigenaar van het bestand weer; bij GVB staat hier altijd GVB. <startdatum> De ingangsdatum van de geldigheid van de KV1 <einddatum> De einddatum van de geldigheid van de KV1 <isbaseline> Indicator die aangeeft of dit bestand de basisjaardienstregeling bevat (‘true’) of een delta (‘false’). Alle lijnen van GVB worden in december voor het volledige dienstregelingjaar gepubliceerd als ‘baseline’. In de loop van het jaar kan er per lijn een nieuwe baseline gepubliceerd worden, bijvoorbeeld bij rijtijdaanpassing of een definitieve routewijziging. Deze zal dezelfde einddatum hebben als de oorspronkelijke baseline. Delta’s worden het hele jaar door gepubliceerd; onder een delta blijft altijd de meest recente baseline voor die lijn geldig. <isgepubliceerd> Veld dat aangeeft of dit bestand geldig is. In principe is dit veld altijd gevuld met ‘true’; in de uitzonderlijke situatie dat een eerder gepubliceerde delta ingetrokken moet worden, zal dit veld de waarde ‘false’ krijgen. <publicatiedatum> Dit is de datum-tijdstempel van het moment waarop de (nieuwste versie van) het bestand gepubliceerd is door GVB. <index> Dit is een uniek nummer binnen het indexbestand. Elk nieuw of gewijzigd bestand krijgt een hoger nummer. Op het hoogste niveau van de index.xml wordt de meest recente index weergegeven. Memo Datum 09 april 2014 Pagina 3 van 3 <versie> Een gepubliceerde periode krijgt in eerste instantie altijd het versienummer 1 mee. Mocht er onverhoopt nog iets wijzigen in een delta dan wordt het versienummer opgehoogd. Wordt een versie ingetrokken (en krijgt < isgepubliceerd> de status false) dan wordt het versienummer 0. NB: het aanpassen van dit versienummer in de xml en csv bestanden zal op een later moment geïmplementeerd worden. <zipfile> Dit is de verwijzing naar de bestandsnaam van de zipfile. Het formaat is KV1_GVB_UNIEKENUMMER_VERSIEINTERN.zip. Bijvoorbeeld “KV1_GVB_6_1.zip” Door deze bestandsnaam in de link te plaatsen in plaats van ‘KV1index.xml’ kan het bestand gedownload worden. Bovenstaand voorbeeld zou de volgende link opleveren: http://pol.gvb.nl/gvbpublicatieinternet/KV1/KV1_GVB_6_1.zip <Lijnen> Hier wordt aangegeven welke lijnen de delta bevat Contact Voor vragen of opmerkingen over deze memo kan contact opgenomen worden met de reisinformatie supportdesk van GVB, PAK-support, bij voorkeur via email [email protected]. NIEUW
© Copyright 2024 ExpyDoc
