Library to acquire real-time information from Västtrafik’s APIs built on .NET Core.
- Arrival board
- Departure board
- Geometry
- Journey details
- Live map
- Locations
- nearby address
- nearby stops
- get all stops
- by name
- System information
- Trip
- Search parking areas
- Get parking area
- Forecast full time
- Forecast availability
- Historical availability
- Current available capacity
- Parking image
- Get specific traffic situation
- Get traffic situations for stop
- Get traffic situations for line
- Get traffic situations for journey
- Get traffic situations for stop area
- Get all traffic situations
Built with .NET Standard Libraries 1.3 and support the following frameworks:
- .NET Core 1.0
- .NET Framework 4.6+
- Mono/Xamarin Platforms
- Universal Windows Platform 10.0
Install library from NuGet.
Package Manager
PM> Install-Package Stranne.VasttrafikNET.NET CLI
> dotnet add package Stranne.VasttrafikNETIn order to get started you need to acquire a key and secret from Västtrafik in order to use their services.
DeviceId needs to be unique for each device. Only one token per DeviceId is allowed which can cause problems if used on multiple devices, like for example mobile devices or multiple servers if the device id is the same. Using multiple unique DeviceId on same device can cause multiple and needlessly authentications request to Västtrafik's servers. You decide the value yourself. By default a new global identifier will be used if nothing or null are specified. Default will create a new token each time the service is instantiated and can lead to extra token request if the service is always created for the request, for example if the service is configured as scope in a DI.
Use a using statement or a DI engine to make sure dispose is called. This will dispose the HttpClient inside the library.
Register the service/services that are needed.
Startup.cs
using Stranne.VasttrafikNET;
...
private const string VtKey = "...";
private const string VtSecret = "...";
private const string VtDeviceId = "...";
...
// This method gets called by the runtime. Use this method to add services to the container.
public void ConfigureServices(IServiceCollection services)
{
...
services.AddScoped<Foo>();
...
services.AddSingleton<IJourneyPlannerService>(serviceProvider => new JourneyPlannerService(VtKey, VtSecret, VtDeviceId));
services.AddSingleton<ICommuterParkingService>(serviceProvider => new CommuterParkingService(VtKey, VtSecret, VtDeviceId));
services.AddSingleton<ITrafficSituationsService>(provider => new TrafficSituationsService(VtKey, VtSecret, VtDeviceId));
}
...Inject the requested service and use.
Foo.cs
using Stranne.VasttrafikNET;
using Stranne.VasttrafikNET.Models;
public class Foo {
private readonly IJourneyPlannerService _journeyPlannerService;
public Foo(IJourneyPlannerService journeyPlannerService) {
_journeyPlannerService = journeyPlannerService;
}
public async Task Bar() {
var departures = await _journeyPlannerService.GetDepartureBoardAsync(new BoardOptions
{
Id = "0000000800000022"
});
...
}
}using Stranne.VasttrafikNET;
using Stranne.VasttrafikNET.Models;
private const string VtKey = "...";
private const string VtSecret = "...";
private const string VtDeviceId = "...";
...
public async Task Bar() {
using(var journeyPlannerService = new JourneyPlannerService(VtKey, VtSecret, VtDeviceId)) {
var departures = await journeyPlannerService.GetDepartureBoardAsync(new BoardOptions
{
Id = "0000000800000022"
}));
...
}
}
...Check out one of the following examples on how this library can be implemented and what it can do.
The following exceptions are located under the namespace Stranne.VasttrafikNET.Exceptions.
Represents errors that occur on failed authentication with Västtrafik's servers. Verify key and secret are correct and that they have access to the API in question.
Represents errors that occur when preparing message for Västtrafik's servers with a request that missing required parameters
Represents errors that occur during communicating with Västtrafik's servers
Represents errors that occur on Västtrafik's servers