# GTFS, GTFS-RT ja GBFS: mitkä ovat erot?

> Vertaa GTFS-, GTFS-RT- ja GBFS-tietoja valitaksesi liikennetietosi: suunnitellut aikataulut, reaaliaikaiset tiedot, jaetut asemat ja ajoneuvot.

Source: https://www.roote.ai/fi/guides/gtfs-gtfsrt-ja-gbfs-mika-erot/
Language: fi
Author: ROOTE

GTFS Schedule kuvaa suunnitellun liikennetarjonnan. GTFS Realtime, jota kutsutaan usein GTFS-RT:ksi, välittää päivitettyjä palvelutietoja. GBFS kuvaa jaettuja liikennepalveluja, mukaan lukien niiden asemat ja julkaistujen syötteiden mukaiset saatavilla olevat ajoneuvot. Valitse formaatti sen mukaan, minkä kysymyksen sovelluksesi haluaa ratkaista.

Nämä formaatit organisoivat tiedot; ne eivät takaa datan saatavuutta kaikkialla eivätkä jokaisen syötteen laatua.

## GTFS suunnitellun tarjonnan kuvaamiseen

GTFS Schedule -aineisto koostuu taulukkotiedostoista, jotka kuvaavat muun muassa operaattoreita, pysäkkejä, linjoja, vuoroja ja niiden kulkemisaikoja. Aikataulut ilmaisevat koskevat päivät. Tiedostot yhdistetään tunnisteiden avulla. [GTFS Schedule -referenssi](https://gtfs.org/documentation/schedule/reference/).

Se mahdollistaa kysymyksiin vastaamisen kuten "missä tämä pysäkki sijaitsee?" tai "mikä vuoro on suunniteltu tälle palvelulle?". Aikataulun hyödyntäminen edellyttää kalenterin ja tiedostojen välisen suhteiden tulkintaa.

Pelkkä pysäkkilistan lukeminen ei siis riitä vuorojen rekonstruointiin. Toisaalta pysäkin sijainti voi olla hyödyllinen ilman aikataulujen näyttämistä.

## GTFS-RT palvelutiedon päivittämiseen

GTFS Realtime voi tarjota vuoropäivityksiä, ajoneuvojen sijainteja ja hälytyksiä. Vuoropäivitykset koskevat erityisesti kulkemisaikoja ja palvelumuutoksia. Syötteet käyttävät Protocol Buffers -rakennesarjoitusta. [GTFS Realtime -esittely](https://gtfs.org/documentation/realtime/reference/).

Julkaisija voi tarjota joitakin kategorioita ilman kaikkia muita. Sijaintisyötteen läsnäolo ei takaa arvioita kaikille pysäkeille.

Käyttöliittymässä erottele suunniteltu kulkuyhteys ja päivitetty arviointi. Opasamme [teoreettiset aikataulut ja reaaliaika](https://www.roote.ai/fi/guides/bussien-aikataulut-teoreettiset-vai-realiaikaiset/) selittää tämän eron käyttäjän näkökulmasta.

## GBFS jaetulle liikenteelle

GBFS käyttää JSON-syötteitä kuvaamaan jaettua liikennepalvelua. Järjestelmästä ja versiosta riippuen ne voivat sisältää tietoja asemista, niiden tilasta, ajoneuvoista sekä muista palvelun ominaisuuksista. Dokumentaatio erottaa asematiedot ja saatavuustilat. [GBFS-dokumentaatio](https://github.com/MobilityData/gbfs/blob/v2.3/gbfs.md).

Erota sovelluksessasi suhteellisen vakaat sijainnit nopeasti muuttuvista tilatiedoista. Säilytä formaatin versio ja asianmukainen aikatunniste tulkinnan yhteydessä.

Saatavuussyöte ei ole varaus- tai lukituksenavaus-API. Se auttaa tarjonnan löytämisessä; vuokraustoiminto kuuluu palveluntarjoajalle.

## Vertailu käyttötapauksen mukaan

| Tarve | Tarkasteltava formaatti |
| --- | --- |
| Kuvailla suunnitellut pysäkit ja linjat | GTFS Schedule |
| Tulkitse suunnitellut kulkuaikataulut ja palvelupäivät | GTFS Schedule |
| Päivitä kulkuaikoja tai vastaanota palvelutietoja | GTFS-RT, julkaistujen syötteiden mukaan |
| Sijaintien tai jaettujen liikennevälineiden paikantaminen | GBFS, julkaistujen tietojen mukaan |

Suunnitteluesimerkki: kartta näyttää raitiovaunupysäkit ja pyöräasemat. Se käyttää rakenteellisia tietoja sijainneista ja päivitettyjä tilatietoja pyörien saatavuudesta. Kumpikin kerros tarvitsee erilaista välimuistia ja päivityssykliä.

## Huomioi kunkin lähteen rajoitteet

Tarkista versiot, valinnaiset kentät, kattavuus ja käyttöoikeudet. Tunniste on merkityksellinen vain omassa kontekstissaan: eri julkaisijat voivat käyttää samoja tunnuksia eri kohteista.

Varustaudu myös puuttuviin tai vanhentuneisiin tietoihin. Tyhjä lista saatavuussyötteestä ei tarkoita palvelun puuttumista. Vältä tuntemattoman tiedon hiljaista korvaamista nollalla.

## Käytä suoraan syötteitä tai API:a

Suora integrointi asettaa vastuulle kerätä, validoida ja tulkita lähteet. API voi tarjota yhteisen sopimuksen, mutta sen kattavuus, varoitukset ja ehdot pitää aina tarkistaa.

Ensimmäistä ROOTE-käyttötapausta varten tutustu [ohjeeseen, miten hakea lähialueen pysäkit API:lla](https://www.roote.ai/fi/guides/kuinka-etsi%C3%A4-l%C3%A4hell%C3%A4-olevia-liikennepys%C3%A4kkej%C3%A4-api-rajapinnan-avulla/). Aloita käyttöliittymäsi tarpeesta ja tarkista todelliset saatavilla olevat kentät.

## Lue katkelmia ja valitse arkkitehtuuri

GTFS Schedule -tiedostossa stop_times.txt:n katkelma yhdistää vuoron, pysäkin ja suunnitellun kulkureitin. Alla oleva suppea esimerkki on opettavainen: se ei kuitenkaan ole täydellinen GTFS-aineisto, ja sen tunnisteet tulee yhdistää trips.txt-, stops.txt-tiedostoihin sekä kalentereihin.

GTFS Realtime -tiedostossa etsi hyödylliset entiteetit: TripUpdate voi päivittää kulunajan, VehiclePosition kuvaa ajoneuvon sijainnin ja Alert välittää palvelutiedotteen. Ajoneuvon sijainti ei automaattisesti tarkoita saapumisennustetta. Siirrettävä formaatti on Protocol Buffers; JSON-muotoinen diagnostiikkakuvailu ei ole varsinaista binaarista siirtovirtaa.

GBFS:ssä station_information kuvaa asemia, kun taas station_status kuvaa niiden julkistettuja tiloja. Joidenkin laskurien nimet ja saatavilla olevat tiedostot vaihtelevat version mukaan. Alla oleva JSON-katkelma havainnollistaa GBFS 2.3:aa ja sen kenttiä num_bikes_available ja num_docks_available; tarkista versio ennen esimerkin käyttöä.

Paikkakartta voi alkaa rakenteellisilla tiedoilla. Seuraavien kulkujen näyttö tarvitsee sitten vastaavat päivitykset ja eksplisiittisesti suunnitellun takaisinvarauksen. Saatavilla olevien pyörien näyttö hallinnoi laskureita, vuokrausehtoja ja ajallista kelpoisuutta. Nämä kolme näyttöä eivät automaattisesti jaa samaa välimuistipolitiikkaa.

```
# Extrait pédagogique de stop_times.txt
trip_id,arrival_time,departure_time,stop_id,stop_sequence
trip_demo,08:10:00,08:10:00,stop_demo,1

# Extrait pédagogique de station_status en GBFS 2.3
{
  "station_id": "station_demo",
  "num_bikes_available": 3,
  "num_docks_available": 7,
  "is_installed": true,
  "is_renting": true,
  "is_returning": true,
  "last_reported": 1720000000
}
```

[Muotoile pyörän saatavuus ja sen ajantasaisuus](https://www.roote.ai/fi/guides/pyorien-saatavuutta-reaaliajassa-sovelluksessa/)

[Valitse API tai MCP tuotteellesi](https://www.roote.ai/fi/guides/api-vai-mcp-kumpi-valita-liikkumistietojen-integrointiin/)

## Usein kysytyt kysymykset

### Sisältääkö GTFS automaattisesti reaaliaikaiset tiedot?

Ei. GTFS Schedule kuvaa suunnitellun tarjonnan; päivitetyt tiedot kuuluvat muihin syötteisiin, kuten GTFS-RT:hen.

### Voiko GBFS lukita pyörän avaamisen?

Se kuvaa palvelun ja sen julkiset tiedot. Vuokraus tapahtuu operaattorin tarjoamien palvelujen kautta.

### Takaako standardimuoto täydellisen kattavuuden?

Ei. Formaatti määrittelee rakenteen; kattavuus ja julkaistut tiedot riippuvat lähteistä.