Open gereedschap

Gereedschap

Drie rekenhulpen die een vraag vanuit een URL beantwoorden en hetzelfde antwoord ook als widget en als JSON teruggeven. Geen account, geen sleutel, geen kosten, en de licentie staat toe wat eruit komt opnieuw te publiceren.

De drie rekenhulpen

Gerangschikt naar waar het antwoord van gemaakt is. De eerste geeft weer wat een rederij publiceerde, de tweede heeft uit een ingediende dienstregeling één van vijf onderdelen, en de derde rekent elk getal zelf uit.

  1. Welke schepen deze route varen, wie ze exploiteert, hoe lang ze erover doen en wat de rederij vraagt.

    Gemeten. Elke rij is een van de 2.709 afvaarten die 120 rederijen hebben gepubliceerd, met vertrek, overtochtduur, schip en tarief zoals ingediend. Een gedateerde momentopname, geen actuele beschikbaarheid.

  2. Hoe lang een reis echt duurt als je het bereiken van het station en het wachten daar meetelt.

    Ingediend voor één van de vijf onderdelen, afgeleid voor de rest. De tijd in het voertuig is ingediend op 545 corridors en elders afgeleid, en het terminal bereiken, daar wachten en dezelfde twee aan de andere kant zijn altijd afgeleid. Een rij wordt benoemd naar het onderdeel in het voertuig en nooit naar het totaal.

  3. Wat een reis de atmosfeer kost, per vervoerwijze die hem zou kunnen uitvoeren.

    Van begin tot eind afgeleid. Elk getal is een van de 6 gepubliceerde factoren maal een afstand die uit twee sets coördinaten volgt. Waar een vervoerwijze de corridor bedient, is de afstand die van het traject. Waar dat niet zo is, wordt de vervoerwijze gemodelleerd op de grootcirkelafstand, wordt geen reistijd vermeld en wordt de balk hol getekend.

Waar elk antwoord op steunt

Dezelfde drie woorden die de datasets gebruiken, want een rekenhulp is nooit sterker dan de rijen eronder.

Gemeten
De vervoerder publiceerde deze waarde en wij hebben hem opgeschreven. Een tarief, een vertrek, een overtochtduur.
Ingediend
Wat een vervoerder zegt dat een dienst zal doen. Een plan, niet getoetst aan iets dat werkelijk gereden heeft.
Afgeleid
Uit andere waarden berekend. Een afstand tussen coördinaten, een gepubliceerd grammengetal daarop toegepast, een marge om een station te bereiken.

De CO2-rekenhulp markeert een gemodelleerde vervoerwijze op de balk zelf en in het API-antwoord, en de deur-tot-deurrekenhulp draagt per onderdeel een herkomstregel met de dag waarvoor de vervoerder heeft ingediend.

Drie oppervlakken, één antwoord

Elke rekenhulp doet alle drie. Dat is wat ze een link waard maakt in plaats van één bezoek.

Een permalink die op de server wordt opgebouwd
Het formulier is een gewone GET, dus verzenden is navigeren en de adresbalk houdt de staat vast. Er is geen script nodig om een antwoord te zien, en dat betekent ook dat een link naar een antwoord blijft werken wanneer hij in een artikel, een e-mail of een crawler belandt.
Een widget voor uw eigen pagina
Dezelfde parameters op een route zonder het omhulsel van de site. De naamsvermelding en de link terug zitten in het kader zelf in plaats van dat een uitgever erom wordt gevraagd, en elke rekenhulppagina drukt het fragment af voor de staat die zij op dat moment toont.
Een openbare JSON-API
Open, zonder sleutel en zonder aanmelding. Een geversioneerde antwoordvorm, de licentie in het lichaam en in een Link-header, lezen vanaf andere domeinen toegestaan, en de limiet in de headers van elk antwoord.

De limiet is 60 verzoeken per minuut per adres, per instantie, in het geheugen bijgehouden. Het stopt een script dat in een lus is beland.

De antwoorden gebruiken

Wat hieruit komt valt onder CC BY 4.0, dezelfde licentie als de datasets eronder.

Publiceer een getal opnieuw, teken het opnieuw, zet de widget in een commercieel artikel, bouw een product op de API. Noem Orlero en link terug. Dat is de hele licentie.

Een antwoord is niet actueler dan de momentopname eronder, dus citeer de datum die de rekenhulp naast het getal toont en niet de dag waarop u het las.

https://creativecommons.org/licenses/by/4.0/

Plannen met Ori

Ori, de reisplanner

Vraag bijvoorbeeld dit