vasttrafik-api

1.1.2 • Public • Published

Västtrafik API client for JavaScript

This is a mirror of the official Västtrafik Travel Planner API Client for Javascript. For more information, see the official api website.

Usage

NodeJS (see ./example.js)

const Api = require('vasttrafik-api');
 
// Sample credentials. Be sure to get your own before going into production.
(async () => {
    const key = '8aOzt2RmMIG0OXSyIgjM2IkHvAoa';
    const secret = 'OMxjxjaXblXdpn8E1gYFehHyx3Ea';
    await vasttrafik.authorize(key, secret);
    
    const api = new vasttrafik.LocationApi();
    const res = await api.getLocationByName({input: 'Lindholmen'});
    console.log(res.text);
})();

Browsers (see ./example.html)

<script src="./dist/vasttrafik.js"></script>
<script>
    (function() {
        // Sample token. Generate access token on server (see example.js)
        var token = 'b94ad16c-715c-3820-a321-503b0267346e';
        vasttrafik.setAccessToken(token);
 
        var api = new vasttrafik.LocationApi();
        api.getLocationByName({input: 'Lindholmen'}, function (error, data, res) {
            console.log(res.text);
        });
    })();
</script> 

Docs

Method Description
ArrivalBoardApi.getArrivalBoard Return the next 20 arrivals (or less if not existing) from a given point in time or the next arrivals in a given timespan.
DepartureBoardApi.getDepartureBoard Return the next 20 departures (or less if not existing) from a given point in time or the next departures in a given timespan.
GeometryApi.getGeometry Returns the polyline for a leg.
JourneyDetailApi.getJourneyDetail Returns information about the complete route of a trip.
LivemapApi.livemap Returns the positions of all vehicles in a given bounding box
LocationApi.getAllStops Returns a list of all stops available in the journey planner.
LocationApi.getLocationByName Returns a list of possible matches in the journey planner database
LocationApi.getNearbyAddress Returns the address nearest a given coordinate.
LocationApi.getNearbyStops Returns a list of stops around a given center coordinate.
SysteminfoApi.getSystemInfo Provides information about the journey planner and the underlying data
TripApi.getTrip Calculates a trip from a specified origin to a specified destination.

Authentication

If you just want to test things out you can use these sample credentials:

key '8aOzt2RmMIG0OXSyIgjM2IkHvAoa' secret 'OMxjxjaXblXdpn8E1gYFehHyx3Ea'

Don't forget to create your own credentials in the developer portal before going into production however since the sample ones might become invalid at any time.

Changes

This repository is mostly a simple mirror of the official api client, but a few changes were made to make it easier to work with.

Helper methods added:

  • client.authorize(key, secret, deviceId) Fetches an access token with the specified key and secret and then authorizes the client with the it (cannot be used in the browser)
  • client.setAccessToken(token) Authorizes upcoming api calls with the specified access token

Monkey patches:

  • JSON instead of XML is returned by default (see mirror/src/ApiClient.js#448)
  • Avoids duplicate api calls when using promises (see mirror/src/ApiClient.js#453)

Version

  • npm version patch|minor|major
  • npm run deploy

Questions?

You can post questions about Västtrafik's API in the developer forum. Also feel free posting issues or questions regarding this mirror here on github.

Readme

Keywords

none

Package Sidebar

Install

npm i vasttrafik-api

Weekly Downloads

0

Version

1.1.2

License

Unlicense

Unpacked Size

474 kB

Total Files

147

Last publish

Collaborators

  • someatoms