{"componentChunkName":"component---src-templates-page-js","path":"/en/services/","result":{"data":{"markdownRemark":{"fields":{"slug":"/en/services/"},"frontmatter":{"title":"Services","isFront":null,"panels":[]},"html":"

Digitransit services

\n

The main components of Digitransit service platform are:

\n
    \n
  1. Multimodal routing engine
    2. \n
  2. Address search
    3. \n
  3. Background map service
    4. \n
  4. Web browser-based user interface
    5. \n
\n

The first three of these need some source data. Digitransit includes the respective data loading processes for them.

\n

The multimodal routing engine OpenTripPlanner uses GTFS-compliant public transit data together with map information from OpenStreetMap in pbf form.

\n

The address search engine is based on Pelias open source project. The service searches coordinates for place names and addresses, or\nreturns the nearest place / address from the given coordinate point.

\n

The background map service provides map information as raster and vector tiles.

\n

Digitransit user interface is a browser based application, which combines the above mentioned services for example in route itinerary searches.

\n

In addition to these main components, Digitransit includes a set of additional services for realtime and information purposes. They are not\nmandatory for running the multimodal trip planning service.

\n

Deploying a Digitransit service instance

\n

All Digitransit micro services are packaged as Docker containers, which are easy to run in your own server. To certain extent,\nit is possible to tune and modify the execution of the containers using environment variables.

\n

The easiest solution is to use the source data provided by Digitransit (OpenTripPlanner data container, Pelias data container, hsl-map-server).\nHowever, the service will then work only on areas covered by existing Digitransit data sources.

\n

To use your own data in a microservice, you need to copy the respective data loading process of Digitransit and modify it to suit your needs.\nIn some cases, it may be sufficient to define additional data sources using environment variables (OpenTripPlanner data loader allows this),\nbut in general case, you have to fork the source code repository of github/hsldevcom and modify it, or develop a totally new data loader.

\n

The dataloading configuration for OpenTripPlanner routing is fairly easy to modify to include desired data sources.\nThe configuration includes a list of web addresses, from where the loader fetches GTFS packages, and the address of OSM map data.\nIt is a straightforward task to replace these addresses.

\n

Source data for Pelias address search is collected and processed with a set of scripts. A single data source is processed using\na tailored javascript library, for example https://github.com/hsldevcom/pelias-gtfs for stop data. Unnecessary scripts can be removed and new\nones added to obtain the desired address data collection. It should be noted that the administrational attributes (neighbourhood, locality, postal area etc)\nare mapped to address items using built-in area information fetched from WhosOnFirst data service. This mechanism should be replaced\nor the data content changed.

\n

The dataloading process of background maps is heavily tied with services provided by HSL. A replacement can be developed by following\nthe map api specifications.

\n

It should be noted that hosting only a subset of services and using APIs of Digitransit for the rest is also possible. For example, a new local\nrouting service in Finland may well use the address search of Digitransit, because it covers the whole country.

\n

An example of hosting your private trip planning service using Helsinki region data:

\n
    \n
  1. Install Docker environment
    2. \n
  2. Start the multimodal routing engine:
    3. \n
\n
docker run -d --rm  -p 9080:8080 -e ROUTER_NAME=hsl -e JAVA_OPTS=-Xmx3g -e ROUTER_DATA_CONTAINER_URL=https://api.digitransit.fi/routing-data/v2/hsl hsldevcom/opentripplanner:prod
\n

OpenTriPlanner services are now available in the address localhost:9080.

\n
    \n
  1. Start the address information database:
    2. \n
\n
docker run -d --rm --name pelias-data-container hsldevcom/pelias-data-container
\n
    \n
  1. Start the address search engine:
    2. \n
\n
docker run -d --rm --name pelias-api -p 3100:8080 --link pelias-data-container:pelias-data-container hsldevcom/pelias-api
\n

Address search is now served at localhost:3100. To test, open a browser and browse to url https://localhost:3100/v1/search?text=Helsinki

\n
    \n
  1. Run the user interface service:
    2. \n
\n
docker run -d --rm  -p 8080:8080 -e OTP_URL=http://localhost:9080/otp/ -e CONFIG=hsl -e GEOCODING_BASE_URL=localhost:3100/v1 hsldevcom/digitransit-ui
\n

You can now browse to the address localhost:8080 and use your private trip planning service, which uses background maps from Digitransit API.

\n

Theming the user interface

\n

The default theme of the Digitransit user interface does not include any city specific features. It is configured to work with the data of the entirety of Finland.

\n

The UI can be themed and configured to suit a new target area by adding a new configuration file into to repository\nhttps://github.com/HSLdevcom/digitransit-ui, to the folder app/configurations. For more information, check out\nhttps://github.com/HSLdevcom/digitransit-ui/blob/master/docs/Themes.md .

\n

The language collection available in the user interface can be extended by adding required strings into app/translations.js file and by updating\nthe language selector component respectively.

\n

Resources

\n

Examples:

\n\n

These resources can serve multiple simultaneous uses without delays. If the service load is high, it may be necessary to deploy a load balancing\nsolution to distribute service requests to multiple servers. For example, Digitransit uses over 20 OpenTripPlanner instances to serve\nthe capital area of Finland.

\n

It is possible to optimize the resources and speed up the response times using various caching technologies (CDN, proxy caching).\nEspecially the background map service benefits from those.

\n

Country specific features of Digitransit

\n

The OpenTripPlanner fork developed for Digitransit is fairly generic, and does not include significant Finland-specific features.\nSome features, such as ticket price computation for the Helsinki area, can be activated using a suitable configuration.

\n

Pelias address search has been modified to support searches in many languages and local character set. All country specific features are defined\nin the configuration file.

\n\n","excerpt":"Digitransit services The main components of Digitransit service platform are: Multimodal routing engine Address search Background map service Web browser-based user interface The first three of these…"}},"pageContext":{"slug":"/en/services/"}},"staticQueryHashes":["3675773199","4050193485"]}