omnitravel / navitia

1.x-dev 2026-11-09 23:31 UTC

Requires

• php: >=8.2
• omnisense/contracts: ^1.0@dev
• omnisense/omnitravel: ^1.0@dev
• symfony/http-client: ^6.4|^7.0|^8.0

Requires (Dev)

• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11.0

MIT

• Marco Meyer

• real-time
• transit
• france
• framework-agnostic
• public-transport
• departures
• journey-planner
• navitia
• omnitravel
• sncf

Published on Packagist.org on 2026-11-10 00:35 UTC

README

omnisense/omnitravel's Navitia, under any PHP host: the Navitia v1 API on one coverage - navitia.io's (fr-idf, fr-ne...) or SNCF's (sncf at https://api.sncf.com/v1, the same API).

• a stop's departures and arrivals (stop_areas/{id}/departures, stop_points/{id}/arrivals): the scheduled and the real-time time, the platform, the train's number, the line and its colours;
• journeys from A to B (journeys): walks, rides with their stops and path, transfers;
• the network: a stop area, the stop areas near a point (coords/{lon};{lat}/places_nearby) and by name (places), the coverage's lines page by page, a line's or a route's stop areas, the lines of a stop area, the networks as operators.

use Omnitravel\Model\DepartureQuery;
use Omnitravel\Navitia\NavitiaFactory;

$sncf = (new NavitiaFactory($httpClient))->create([
    'token' => getenv('SNCF_API_TOKEN'),          // by reference: never written in a file
    'coverage' => 'sncf',
    'base_uri' => 'https://api.sncf.com/v1',
    'attribution' => 'Données SNCF',
]);
foreach ($sncf->departures(new DepartureQuery('stop_area:SNCF:87391003', limit: 5)) as $departure) {
    echo $departure->number, ' ', $departure->headsign, ' ', $departure->time()->format('H:i'), ' voie ', $departure->platform, "\n";
}

Options: token and coverage (required), base_uri (https://api.navitia.io/v1), timezone (Europe/Paris), attribution, timeout; policy, usage (the family's).

Usage policy

policy.json declares what is known: a key, the credit to navitia.io (the attribution option's text when given). Its rate limits and rights are unknown: navitia.io's terms page (https://navitia.io/en/?p=1571) could not be read on 2026-11-10 (HTTP 403) and api.sncf.com publishes no quota, so nothing is enforced but what a site sets itself - its plan's quota, as 'policy' => ['rateLimits' => [['max' => 5000, 'window' => 'month']]]. A 429 and its Retry-After are honoured all the same.

The manual: docs/index.md. MIT.