An open API service indexing awesome lists of open source software.

https://github.com/hove-io/navitia

The open source software to build cool stuff with locomotion
https://github.com/hove-io/navitia

gtfs journey-planner mobility mobility-as-a-service navitia open-api public-transportation trip-planner trip-planning

Last synced: about 2 months ago
JSON representation

The open source software to build cool stuff with locomotion

Awesome Lists containing this project

README

          

.. image:: documentation/diagrams/kraken.jpg
:alt: navitia
:align: center

Cher membre de la communauté Navitia,

Nous vous remercions de l’intérêt que vous portez à nos produits et plus particulièrement à notre plateforme d’information voyageurs.

Nous avons le plaisir de vous informer qu’**une nouvelle version de Navitia sera prochainement disponible**.

Dans le cadre du lancement de cette nouvelle version, nous avons pris la décision de limiter l’accès à notre code source. Cette décision se traduit par la fermeture progressive d’ici à fin septembre de nos répertoires sur Github. Cette décision est avant tout motivée par le désir d’offrir à nos clients une meilleure qualité de services tant sur le plan fonctionnel que sur le plan des performances. Elle répond également à un certain nombre d’exigences en termes de cyber sécurité.

La version historique de Navitia, ouverte en 2014, restera disponible. Cette version est également disponible avec notre offre fremium via https://navitia.io , offre qui évoluera progressivement vers notre nouvelle version Navitia.
Cette offre vous permet, sous certaines conditions, de disposer d’une assistance.

Notre service commercial sales@hove.com reste bien entendu à votre disposition pour vous étudier avec vous une formule adaptée à vos besoins.

Cordialement,
Hove

=========
Navitia
=========
``(pronounce [navi-sia])``

.. |Version Logo| image:: https://img.shields.io/github/v/tag/hove-io/navitia?logo=github&style=flat-square
:target: https://github.com/hove-io/navitia/releases
:alt: version

.. |Build Status| image:: https://img.shields.io/github/actions/workflow/status/hove-io/navitia/workflow.yml?branch=dev
:target: https://github.com/hove-io/navitia/actions/workflows/build_navitia_packages_for_release.yml
:alt: Last build

.. |License| image:: https://img.shields.io/github/license/hove-io/navitia
:target: https://github.com/hove-io/navitia#AGPL-3.0-1-ov-file
:alt: license

+----------------+----------------+-----------+
| Version | Build status | License |
+----------------+----------------+-----------+
| |Version Logo| | |Build Status| | |License| |
+----------------+----------------+-----------+

Presentation
============
Welcome to the Navitia repository!

Navitia is a webservice providing:

#. multi-modal journeys computation

#. line schedules

#. next departures

#. exploration of public transport data

#. search & autocomplete on places

#. sexy things such as isochrones

Approach
--------

| Navitia is an open-source web API, **initially** built to provide traveler information on urban
transportation networks.
|
| Its main purpose is to provide day-to-day information to travelers.

| Over time, Navitia has been able to do way more, *sometimes* for technical and debuging purpose
*or* because other functional needs fit quite well in what Navitia can do *or* just because it was
quite easy and super cool.
|
| Technically, Navitia is a HATEOAS_ API that returns JSON formated results.

.. _HATEOAS: https://en.wikipedia.org/wiki/HATEOAS

Who's who
----------

| Navitia is instantiated and exposed publicly through api.navitia.io_.

| Developments on Navitia are lead by Hove (previously Kisio Digital and CanalTP).
| Hove is a subsidiary of Keolis (itself a subsidiary of SNCF, French national railway company).

.. _api.navitia.io: https://api.navitia.io

More information
----------------

* main web site https://www.hove.com
* playground https://playground.navitia.io
* integration documentation https://doc.navitia.io
* technical documentation https://github.com/hove-io/navitia/tree/dev/documentation/rfc
* twitter @navitia https://twitter.com/navitia

Getting started
===============

Want to test the API?
----------------------

| The easiest way to do this is a to go to `navitia.io `_.
| `Signup `_, grab a token, read the `doc `_
and start using the API!

For a more friendly interface you can use the API through
`navitia playground `_ (no matter the server used).

Want to dev and contribute to navitia?
---------------------------------------

If you want to build navitia, develop in it or read more about technical details please refer to
`CONTRIBUTING.md `_.

Curious of who's contributing? :play_or_pause_button: https://www.youtube.com/watch?v=GOLfMTMGVFI

Architecture overview
=====================
Navitia is made of 3 main modules:

#. *Kraken* is the c++ core (Heavy computation)

#. *Jörmungandr* is the python frontend (Webservice and lighter computation)

#. *Ed* is the postgres database (Used for preliminary binarization)

*Kraken* and *Jörmungandr* communicate with each other through protocol buffer messages sent by ZMQ.

| Transportation data (in the `NTFS `_,
or `GTFS `_ format) or routing data
(mainly from `OpenStreetMap `_ for the moment) can be given to *Ed*.
| *Ed* produces a binary file used by *Kraken*.

.. image:: documentation/diagrams/Navitia_simple_architecture.png

More information here: https://github.com/hove-io/navitia/wiki/Architecture