vegvesen

NodeJS wrapper for Statens Vegvesen's NVDB REST APIs

• Installation
• Usage
• Examples
• Methods
• Contact
• Legal

Installation

npm install vegvesen

You can also download it manually.

• Latest stable release

Usage

var vegvesenClient  = require("vegvesen");
var vegvesen = new vegvesenClient();

vegvesen.connect(function(){
    vegvesen.vegobjekter.spesifiktVegobjekt(82559833, function(obj){
        console.log(obj);
    });
});

All methods are loaded dynamically when connect() is called. This is dictated by the specification of the API. So for an up-to-date guide, check the official documentation.

Examples

If the API endpoint url changes, you can provide an optional argument in the constructor

new VegvesenClient("https://api.endpoint.url");

You can also provide an optional options object to change request and response parameters

new VegvesenClient("https://api.endpoint.url", {
    requestConfig: {
     timeout: 1000,
        noDelay: true,
        keepAlive: true
    },
    responseConfig: {
        timeout: 1000 //response timeout 
    }
});

Function names are based off of the "rel" property of each API object. So e.g.

<ressurs rel="spesifikt-vegobjekt" uri="/vegobjekter/objekt/{vegobjekt-id}"/>

can be accessed by calling

vegvesen.vegobjekter.spesifiktVegobjekt();

Some methods requires parameters, theese can be specified like:

vegvesen.vegobjekter.spesifiktVegobjekt(487458622);

In case a method requires multiple parameters, they can be supplied by passing an array containing the arguments, e.g.

vegvesen.vegreferanse.vegreferanseFraWgs84Koordinat([5.26835878197702, 60.38078971681345]});

To access the result of an API call, every method also takes a callback function as the last argument, e.g.

vegvesen.vegobjekter.spesifiktVegobjekt(487458622, function(data){
    console.log(data);
});

More examples can be found under the folder "examples"

Methods

Currently at the time of publishing this version of the module, this is the functions exposed by the API:

definisjoner

• vegobjektTyper()
• vegobjektTypeDefinisjon()
• egenskapsTypeDefinisjon()
• datakatalogVersjon()

vegobjekter

• vegobjekterAvGittType()
• spesifiktVegobjekt()

sokegrensesnitt

• sok()

vegreferanse

• vegreferanseFraUtm33Koordinat()
• vegreferanseFraWgs84Koordinat()
• vegreferanseFraVeglenke()
• vegreferanseFraVegreferansenavn()
• vegreferanse()
• veglenkeTilVegreferanse()

omrader

• regioner()
• vegavdelinger()
• fylker()
• politidistrikter()
• kommuner()
• riksvegruter()
• kontraktsomrader()

endringer

• endringerObjekttype()

Contact

If you have any questions regarding the usage of this API client, just contact me through the contact information provided on the github repo, and also specified in the npm package.json

Legal

Copyright Thomas Alrek (C) 2016

This module is released as GNU General Public License version 2, see file LICENSE.md for details. You are free to use this in your own applications. However, the data gathered from NVDB is licensed under the NLOD license (Norwegian only). If you use the data in your application, you are required by this license to always include the following text:

Inneholder data under norsk lisens for offentlige data (NLOD) tilgjengeliggjort av Statens vegvesen.