Statens Vegvesen - VisVegInfo

This document describes the API published by Statens Vegvesen for accessing data from the National Road Database (NVDB) using Web Services

Contents

Audience
Usage Limits
RoadInfo Service
Example/Demo

Audience

This document is intended for website and mobile developers who want to NVDB data in their application. It provides an introduction to using the API and reference material on the available parameters.

Usage Limits

Use of the API is subject to a query limit of 2,500 requests per day.

RoadInfo Service

Webservice / WSDL

The service is documented as a WSDL definition that can be retreived here

REST access

All methods are also exposed in an restful way that allows HTTP-GET (except GetDataInArea and one method for getting data for a location, that are exposed via HTTP-POST).

Methods

GetCatalogue
GetRoadReferenceForLocation
GetRoadReferencesForSearch
GetRoadDataAtReference / GetRoadDataAtReferenceWithViewDate
GetRoadDataAtNVDBReference / GetRoadDataAtNVDBReferenceWithViewDate
GetRoadDataForLocation
GetRoadDataInArea
GetRoadReferencesInArea
LookupRoadReferences
LookupNVDBReferences
GetRoadReferenceForNVDBReference
GetRoadReferenceForReference
GetRoadReferenceHistoryForReference
GetRoadReferenceHistoryForNVDBReference
GetRoadReferenceHistoryForLocation

GetCatalogue

Returns the catalogue exposed by the service

Example: Invoking the GetCatalogue method either via WSDL or HTTP-GET will return the exposed catalogue from the service

View GetCatalogue

Response

<RoadAttributeCatalogue xmlns="http://schemas.datacontract.org/2004/07/RoadInfoServiceContracts" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
 <RoadAttributes>
  <RoadAttributeType>
   <Columns>
    <RoadAttributeTypeValue>
     <DataType>enum</DataType>
     <Name>Fartsgrense</Name>
    </RoadAttributeTypeValue>
   </Columns>
   <Description>Fartsgrense</Description>
   <ID>105</ID>
   <Name>Fartsgrense</Name>
  </RoadAttributeType>
  <RoadAttributeType>...</RoadAttributeType>
  <RoadAttributeType>...</RoadAttributeType>
 </RoadAttributes>
</RoadAttributeCatalogue>

GetRoadReferenceForLocation

Return the closest roadreference for the specified location given optional filtering parameters

Parameters

easting - Easting for value for the location (UTM33 - X, WGS84 - longitude)
northing - Northing for value for the location (UTM33 - Y, WGS84 - latitude)
coordinateSystem - CoordinateSystem used for coordinates (UTM33 or WGS84)

Optional parameters (for filtering)

ViewDate - Viewdate to use when looking at roadnet
bufferMeters - Buffer to use when finding closest road
TopologyLevel - TopologyLevel to use when looking at roadnet
searchRoadCategories - RoadCategories to filter against when snapping aginst roadnet (Commaseparated string of categories or empty to ignore)
searchRoadStatus - RoadStatuses to filter against when snapping aginst roadnet (Commaseparated string of statuses or empty to ignore)
searchRoadNumber - Roadnumber to filter against when snapping against roadnet (number or empty to ignore)

Topology-level
Overview: Represents an non-detailed overview of the roadnet
Roadway: (Default) Represents a detailed roadnet showing roundabouts and intersections
Lane: The most detailed representation of the roadnet showing each lane

Road-Category
E: Europaveg
R: Riksveg
F: Fylkesveg
K: Kommunal veg
P: Privat veg
S: Skogsbilveg

Road-Status
V: Eksisterende veg
W: Midlertidig veg
T: Midlertidig status bilveg
G: Gang-/sykkelveg
A: Anleggsveg
H: Gang-/sykkelveg anlegg
S: Eksisterende ferjestrekning
M: Møte- og rasteplass
P: Vedtatt veg
X: Veggrunn
E: Vedtatt ferjestrekning
U: Midlertidig status gang-/sykkelveg
Q: Vedtatt gang-/sykkelveg

REST Usage: 

RoadInfoService/GetRoadReferenceForLocation?GetRoadReferenceForLocation?easting={easting}&northing={northing}&coordinateSystem={coordinateSystem}
RoadInfoService/GetRoadReferenceForLocation?GetRoadReferenceForLocation?easting={easting}&northing={northing}&coordinateSystem={coordinateSystem&viewdate={ViewDate}&bufferMeters={bufferMeters}&topologylevel={TopologyLevel}&searchRoadCategories={FilterCategories}&searchRoadStatus={FilterStatuses}&searchRoadNumber={FilterRoadNumber}

Example: RoadInfoService/GetRoadReferenceForLocation?easting=14.17564&northing=66.32016&coordinateSystem=WGS84&viewdate=2012-01-01&bufferMeters=100&topologylevel=Lane&searchRoadCategories=E,R&searchRoadStatus=V,G

Response
<RoadReference xmlns="http://schemas.datacontract.org/2004/07/RoadInfoServiceContracts" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" i:type="RoadPointReference">
 <County>18</County>
 <LaneCode>1#2</LaneCode>
 <Municipality>0</Municipality>
 <ReflinkOID>1796297</ReflinkOID>
 <RoadCategory>E</RoadCategory>
 <RoadNumber>12</RoadNumber>
 <RoadNumberSegment>1</RoadNumberSegment>
 <RoadStatus>G</RoadStatus>
 <TextualRoadReference>1800EG0001200100260</TextualRoadReference>
 <Measure>0.14040206666110036</Measure>
 <RoadNetPosition>
   <SRID>25833</SRID>
   <X>463055.85435545497</X>
   <Y>7355839.7250289777</Y>
 </RoadNetPosition>
 <RoadNumberSegmentDistance>260</RoadNumberSegmentDistance>
 <RoadnetHeading>61.930380817629079</RoadnetHeading>
</RoadReference>

GetRoadReferencesForSearch

Return all roadreferences that matches a specified search Parameters

search - Input for search, a RoadReference either including RoadNumer or including both roadnumber and roadnumbersegment (0600RV00007 or 0600RV00007001)
ViewDate - Viewdate to use when looking at roadnet
TopologyLevel - TopologyLevel to use when looking at roadnet

REST Usage: 

RoadInfoService/GetRoadReferencesForSearch?search={Search}&topologylevel={TopologyLevel}&ViewDate={ViewDate}

Example: RoadInfoService/GetRoadReferencesForSearch?search=0600RV00007&topologylevel=Overview&ViewDate=2013-01-01

Response
<ArrayOfRoadReference xmlns="http://schemas.datacontract.org/2004/07/RoadInfoServiceContracts" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<RoadReference i:type="RoadLineReference">
...
..
</RoadReference>
<ArrayOfRoadReference>

GetRoadDataAtReference / GetRoadDataAtReferenceWithViewDate

Returns road-data for a specific location referenced by Norwegian RoadReference-reference

Parameters

roadReference - Roadreference to get data for
viewDate - Date to use when viewing the roadnet (Format: YYYY-MM-DD)
topologyLevel - Topologylevel to use when snapping against the roadnet (Overview, Roadway, Lane)

REST Usage: 

RoadInfoService/GetRoadDataAtReference?roadReference={ROADREFERENCE}
RoadInfoService/GetRoadDataAtReferenceWithViewDate?roadReference={ROADREFERENCE}&viewDate={VIEWDATE}
RoadInfoService/GetRoadDataAtReferenceWithViewDateWithTopologyLevel?roadReference={ROADREFERENCE}&viewDate={VIEWDATE}&topologyLevel={TOPOLOGYLEVEL}

Example: RoadInfoService/GetRoadDataAtReference?roadReference=1700EV0000601902022

Response
<RoadDataCollection xmlns="http://schemas.datacontract.org/2004/07/RoadInfoServiceContracts" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <RoadDataItems>
        <RoadDataItem i:type="RoadDataPointItem">
            <Attributes>
                <RoadDataItemAttribute>
                    <AttributeName>Fartsgrense</AttributeName>
                    <AttributeValue>80</AttributeValue>
                </RoadDataItemAttribute>
            </Attributes>
            <ItemTypeID>105</ItemTypeID>
            <RoadReferenceAtLocation>
                <County>17</County>
                <LaneCode>1#2</LaneCode>
                <Measure>0.70388506016348151</Measure>
                <Municipality>0</Municipality>
                <ReflinkOID>578603</ReflinkOID>
                <RoadCategory>E</RoadCategory>
                <RoadNetPosition>
                    <SRID>25833</SRID>
                    <X>330240.20380865817</X>
                    <Y>7110845.6671205452</Y>
                </RoadNetPosition>
                <RoadNumber>6</RoadNumber>
                <RoadNumberSegment>19</RoadNumberSegment>
                <RoadNumberSegmentDistance>2022</RoadNumberSegmentDistance>
                <RoadStatus>V</RoadStatus>
                <RoadnetHeading>19.308673338085654</RoadnetHeading>
                <TextualRoadReference>1700EV0000601902022</TextualRoadReference>
            </RoadReferenceAtLocation>
        </RoadDataItem>
        <RoadDataItem i:type="RoadDataPointItem">...</RoadDataItem>
        <RoadDataItem i:type="RoadDataPointItem">...</RoadDataItem>
    </RoadDataItems>
</RoadDataCollection>

GetRoadDataAtNVDBReference / GetRoadDataAtNVDBReferenceWithViewDate

Returns road-data for a specific location referenced by Norwegian National RoadDatabase-reference

Parameters

nvdbLinkId - NVDB LinkID
linkRelLen - RelativeLength along link (0..1)
viewDate - Date to use when viewing the roadnet (Format: YYYY-MM-DD)

REST Usage: 

RoadInfoService/GetRoadDataAtNVDBReference?nvdbLinkID={LINKID}&linkRelLen={relLen}
RoadInfoService/GetRoadDataAtNVDBReferenceWithViewDate?nvdbLinkID={LINKID}&linkRelLen={relLen}&viewDate={VIEWDATE}

Example: RoadInfoService/GetRoadDataAtNVDBReference?nvdbLinkID=578603&linkRelLen=0.70388506016348151

Response
<RoadDataCollection xmlns="http://schemas.datacontract.org/2004/07/RoadInfoServiceContracts" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <RoadDataItems>
        <RoadDataItem i:type="RoadDataPointItem">
            <Attributes>
                <RoadDataItemAttribute>
                    <AttributeName>Fartsgrense</AttributeName>
                    <AttributeValue>80</AttributeValue>
                </RoadDataItemAttribute>
            </Attributes>
            <ItemTypeID>105</ItemTypeID>
            <RoadReferenceAtLocation>
                <County>17</County>
                <LaneCode>1#2</LaneCode>
                <Measure>0.70388506016348151</Measure>
                <Municipality>0</Municipality>
                <ReflinkOID>578603</ReflinkOID>
                <RoadCategory>E</RoadCategory>
                <RoadNetPosition>
                    <SRID>25833</SRID>
                    <X>330240.20380865817</X>
                    <Y>7110845.6671205452</Y>
                </RoadNetPosition>
                <RoadNumber>6</RoadNumber>
                <RoadNumberSegment>19</RoadNumberSegment>
                <RoadNumberSegmentDistance>2022</RoadNumberSegmentDistance>
                <RoadStatus>V</RoadStatus>
                <RoadnetHeading>19.308673338085654</RoadnetHeading>
                <TextualRoadReference>1700EV0000601902022</TextualRoadReference>
            </RoadReferenceAtLocation>
        </RoadDataItem>
        <RoadDataItem i:type="RoadDataPointItem">...</RoadDataItem>
        <RoadDataItem i:type="RoadDataPointItem">...</RoadDataItem>
    </RoadDataItems>
</RoadDataCollection>

GetRoadDataForLocation

Returns road-data for a specific location referenced by coordinates

Parameters

easting - Easting coordinate (X for UTM33, Longitude for WGS84)
northing - Northing coordinate (Y for UTM33, Latitude for WGS84)
coordinateSystem - CoordinateSystem used for coordinates (UTM33 or WGS84)
viewDate - (optional) Date to use when viewing the roadnet (Format: YYYY-MM-DD)
bufferMeters - (optional) Buffer to use when snapping against the roadnet
topologyLevel - (optional) Topologylevel to use when snapping against the roadnet (Overview, Roadway, Lane)
searchRoadCategories - (optional) RoadCategories to filter against when snapping aginst roadnet (Commaseparated string of categories or empty to ignore)
searchRoadStatus - (optional) RoadStatuses to filter against when snapping aginst roadnet (Commaseparated string of statuses or empty to ignore)
searchRoadNumber - (optional) Roadnumber to filter with when snapping aginst roadnet

Method supporting GET

RoadInfoService/GetRoadDataForLocation?easting={EASTING}&northing={NORTHING}&coordinateSystem={COORDINATESYSTEM}
RoadInfoService/GetRoadDataForLocation?easting={EASTING}&northing={NORTHING}&bufferMeters={BUFFERMETERS}&coordinateSystem={COORDINATESYSTEM}
RoadInfoService/GetRoadDataForLocation?easting={EASTING}&northing={NORTHING}&ViewDate={VIEWDATE}&coordinateSystem={COORDINATESYSTEM}
RoadInfoService/GetRoadDataForLocation?easting={EASTING}&northing={NORTHING}
                &bufferMeters={BUFFERMETERS}&ViewDate={VIEWDATE}&coordinateSystem={COORDINATESYSTEM}
RoadInfoService/GetRoadDataForLocation?easting={EASTING}&northing={NORTHING}
                &bufferMeters={BUFFERMETERS}&ViewDate={VIEWDATE}&coordinateSystem={COORDINATESYSTEM}&topologyLevel={TOPOLOGYLEVEL}
                &searchRoadCategories={ROADCATEGORIES}&searchRoadStatus={ROADSTATUSES}

Example: RoadInfoService/GetRoadDataForLocation?easting=258079&northing=6654855&coordinateSystem=UTM33

Response
<RoadDataCollection xmlns="http://schemas.datacontract.org/2004/07/RoadInfoServiceContracts" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <RoadDataItems>
        <RoadDataItem i:type="RoadDataPointItem">
            <Attributes>
                <RoadDataItemAttribute>
                    <AttributeName>Fartsgrense</AttributeName>
                    <AttributeValue>50</AttributeValue>
                </RoadDataItemAttribute>
            </Attributes>
            <ItemTypeID>105</ItemTypeID>
            <RoadReferenceAtLocation>
                <County>3</County>
                <LaneCode>1#2</LaneCode>
                <Measure>0.54257987711362732</Measure>
                <Municipality>1</Municipality>
                <ReflinkOID>604335</ReflinkOID>
                <RoadCategory>K</RoadCategory>
                <RoadNetPosition>
                    <SRID>25833</SRID>
                    <X>258084.67045553171</X>
                    <Y>6654862.8981344905</Y>
                </RoadNetPosition>
                <RoadNumber>13070</RoadNumber>
                <RoadNumberSegment>1</RoadNumberSegment>
                <RoadNumberSegmentDistance>3796</RoadNumberSegmentDistance>
                <RoadStatus>V</RoadStatus>
                <RoadnetHeading>305.67640757583558</RoadnetHeading>
                <TextualRoadReference>0301KV1307000103796</TextualRoadReference>
            </RoadReferenceAtLocation>
        </RoadDataItem>
        <RoadDataItem i:type="RoadDataPointItem">...</RoadDataItem>
    </RoadDataItems>
</RoadDataCollection>

GetRoadDataInArea

Returns road-data for a specific type within a given a given polygon

Parameters
These parameters are contained within a wrapper-type called GetRoadDataInAreaRequest

featureTypeID - (integer) The type that data should be extracted for
polygon - The polygon describing the area (The polygon must be closed!)

REST Usage:

Exposed via rest using HTTP-POST

Example body of request

<GetRoadDataInAreaRequest xmlns="http://schemas.datacontract.org/2004/07/RoadInfoServiceContracts">
    <featureTypeID>45</featureTypeID>
    <polygon>
        <CoordinateSystem>UTM33</CoordinateSystem>
        <PolygonPoints>
            <Point>
                <X>256123.75</X>
                <Y>6621849.75</Y>
            </Point>
            <Point>
                <X>260524.25</X>
                <Y>6631497</Y>
            </Point>
            <Point>
                <X>253923.5</X>
                <Y>6634543.5</Y>
            </Point>
            <Point>
                <X>250877</X>
                <Y>6625742.5</Y>
            </Point>
            <Point>
                <X>256123.75</X>
                <Y>6621849.75</Y>
            </Point>
        </PolygonPoints>
    </polygon>
</GetRoadDataInAreaRequest>

Example response

<RoadDataCollection xmlns="http://schemas.datacontract.org/2004/07/RoadInfoServiceContracts" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <RoadDataItems>
        <RoadDataItem i:type="RoadDataPointItem">
            <Attributes>
                <RoadDataItemAttribute>
                    <AttributeName>Navn</AttributeName>
                    <AttributeValue>Oslofjordtunnelen</AttributeValue>
                </RoadDataItemAttribute>
                <RoadDataItemAttribute>
                    <AttributeName>Takst liten bil</AttributeName>
                    <AttributeValue>60</AttributeValue>
                </RoadDataItemAttribute>
                <RoadDataItemAttribute>
                    <AttributeName>Takst stor bil</AttributeName>
                    <AttributeValue>130</AttributeValue>
                </RoadDataItemAttribute>
            </Attributes>
            <ItemTypeID>45</ItemTypeID>
            <RoadReferenceAtLocation>
                <County>2</County>
                <LaneCode>1#2</LaneCode>
                <Measure>0.059387705426161</Measure>
                <Municipality>0</Municipality>
                <ReflinkOID>443429</ReflinkOID>
                <RoadCategory>R</RoadCategory>
                <RoadNetPosition>
                    <SRID>25833</SRID>
                    <X>255635.99969713949</X>
                    <Y>6625176.9635178018</Y>
                </RoadNetPosition>
                <RoadNumber>23</RoadNumber>
                <RoadNumberSegment>1</RoadNumberSegment>
                <RoadNumberSegmentDistance>5704</RoadNumberSegmentDistance>
                <RoadStatus>V</RoadStatus>
                <TextualRoadReference>0200RV0002300105704</TextualRoadReference>
            </RoadReferenceAtLocation>
        </RoadDataItem>
    </RoadDataItems>
</RoadDataCollection>

GetRoadReferencesInArea

Returns roads (with references) for the given polygon

Parameters
These parameters are contained within a wrapper-type called GetRoadDataInAreaRequest

polygon - The polygon describing the area (The polygon must be closed!)
ViewDate - (Optional) ViewDate to receive the roadnetwork for (default today)
TopologyLevel - (Optional) TopologyLevel to receive road network for (default Roadway)

REST Usage:

Exposed via rest using HTTP-POST

Example body of request

<GetRoadReferencesInAreaRequest xmlns="http://schemas.datacontract.org/2004/07/RoadInfoServiceContracts">
    <ViewDate>
        2015-08-13T00:00:00Z
    </ViewDate>
    <TopologyLevel>
        Roadway
    </TopologyLevel>
    <polygon>
        <CoordinateSystem>UTM33</CoordinateSystem>
        <PolygonPoints>
            <Point>
                <X>254343.46</X>
                <Y>6624313.97</Y>
            </Point>
            <Point>
                <X>254369.96</X>
                <Y>6624500.16</Y>
            </Point>
            <Point>
                <X>254225.80</X>
                <Y>6624582.72</Y>
            </Point>
            <Point>
                <X>254084.67</X>
                <Y>6624387.53</Y>
            </Point>
            <Point>
                <X>254343.46</X>
                <Y>6624313.97</Y>
            </Point>
        </PolygonPoints>
    </polygon>
</GetRoadReferencesInAreaRequest>

Example response

<arrayofroadreference xmlns="http://schemas.datacontract.org/2004/07/RoadInfoServiceContracts" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <roadreference i:type="RoadLineReference">
    <county>3</county>
    <LaneCode>1#2</LaneCode>
    <municipality>1</municipality>
    <reflinkoid>605153</reflinkoid>
    <roadcategory>K</roadcategory>
    <roadnumber>15877</roadnumber>
    <roadnumbersegment>1</roadnumbersegment>
    <roadstatus>V</roadstatus>
    <textualroadreference>0301KV15877001 00000-00098</textualroadreference>
    <frommeasure>0</frommeasure>
    <geometrytransformationapplied i:nil="true" />
    <roadnumbersegmentenddistance>98</roadnumbersegmentenddistance>
    <roadnumbersegmentstartdistance>0</roadnumbersegmentstartdistance>
    <tomeasure>0.3320075</tomeasure>
    <wktgeometry>LINESTRING (261042.700000001 6650002.5, 261027.5 6650009.6, 261008.4 6650022.3, 260978 6650043.4, 260959.4 6650054.3)</wktgeometry>
   </roadreference>
    <roadreference i:type="RoadLineReference">
    <county>3</county>
    <municipality>1</municipality>
    <reflinkoid>604813</reflinkoid>
    <roadcategory>K</roadcategory>
    <roadnumber>14719</roadnumber>
    <roadnumbersegment>1</roadnumbersegment>
    <roadstatus>V</roadstatus>
    <textualroadreference>0301KV14719001 00181-00265</textualroadreference>
    <frommeasure>0.68388864</frommeasure>
    <geometrytransformationapplied i:nil="true" />
    <roadnumbersegmentenddistance>265</roadnumbersegmentenddistance>
    <roadnumbersegmentstartdistance>181</roadnumbersegmentstartdistance>
    <tomeasure>1</tomeasure>
    <wktgeometry>LINESTRING (260715.9 6650040.2, 260707.3 6650046.4, 260691.1 6650059.4, 260661.9 6650082.8, 260651.2 6650093.4)</wktgeometry>
   </roadreference>
</arrayofroadreference>

LookupRoadReferences

Translates an array of RoadReferences to NVDB-References

Parameters
Array of input roadreferences. Either Point references 2000EV0006900500319 or Linereferences 2000EV00069005 00319-00400

LookupNVDBReferences

Translates an array of NVDB-References to RoadReferences

Parameters
Array of input NVDB-references (either line of point)

GetRoadDataAlongRouteBetweenLocations

Calculates the route between the given locations and returns the series of roadsegments that covers that route

Parameters

startEasting - Easting coordinate for startpoint (X for UTM33, Longitude for WGS84)
startNorthing - Northing coordinate for startpoint (Y for UTM33, Latitude for WGS84)
endEasting - Easting coordinate for endpoint (X for UTM33, Longitude for WGS84)
endNorthing - Northing coordinate for endpoint (Y for UTM33, Latitude for WGS84)
viewDate - Date to use when viewing the roadnet (Format: YYYY-MM-DD)
TopologyLevel - [Optional, default is Roadway] TopologyLevel to use when snapping against roadnet and returning data
SearchRoadCategories - (optional) Filter of RoadCategories to look at when looking at roadnet (commaseparated string: E,R,F)
SearchRoadStatuses - (optional) Filter of RoadStatuses to look at when looking at roadnet (commaseparated string: V,W,S)
SearchRoadNumber - (optional) Filter of RoadNumber to look at when looking at roadnet (number)
RouteType - (optional) Control what type of route that should be calculated. CostBased (default) calculates a route that is allowed for a vehicle to drive. LengthBased calculated the shortest (topologically correct) route.

REST Usage: 

RoadInfoService/GetRoadDataAlongRouteBetweenLocations?startEasting={STARTEASTING}&startNorthing={STARTNORTHING}&endEasting={ENDEASTING}&endNorthing={ENDNORTHING}&viewDate={VIEWDATE}

Example: RoadInfoService/GetRoadDataAlongRouteBetweenLocations?startEasting=-2162.328125&startNorthing=6652822.2985611&endEasting=-3273.03125&endNorthing=6652325.1266861&viewDate=2012-08-01
Response
<RouteWithData xmlns="http://schemas.datacontract.org/2004/07/RoadInfoServiceContracts" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <DataOnRoute i:nil="true"/>
        <Route>
            <RoadLineReference>
                <County>12</County>
                <LaneCode>1#2</LaneCode>
                <Municipality>0</Municipality>
                <ReflinkOID>805633</ReflinkOID>
                <RoadCategory>E</RoadCategory>
                <RoadNumber>134</RoadNumber>
                <RoadNumberSegment>9</RoadNumberSegment>
                <RoadStatus>V</RoadStatus>
                <TextualRoadReference>1200EV00134009 03456-04778</TextualRoadReference>
                <FromMeasure>0.57545212038667826</FromMeasure>
                <RoadNumberSegmentEndDistance>4778</RoadNumberSegmentEndDistance>
                <RoadNumberSegmentStartDistance>3456</RoadNumberSegmentStartDistance>
                <ToMeasure>0.70909541615256511</ToMeasure>
                <WKTGeometry>
                    LINESTRING (-2163.2254649132547 6652828.5142814741, -2175.09999999963 6652826.8, -2205.20000000019 6652820.6, -2229.30000000005 6652815.2, -2250.09999999986 6652813.4, -2278.49999999977 6652814.8, -2304.20000000019 6652816.5, -2330.39999999991 6652818.9, -2354.69999999995 6652820.5, -2377.49999999977 6652821, -2403.30000000005 6652819.1, -2422.59999999963 6652816.9, -2446.09999999986 6652813, -2462.79999999958 6652810.4, -2468.29999999981 6652809.3, -2469.5 6652809.1, -2474.49999999977 6652808.9, -2502.69999999949 6652803.7, -2541.99999999977 6652796.7, -2583.99999999953 6652788.5, -2622.99999999953 6652780.6, -2663.80000000028 6652771.4, -2707.10000000033 6652762.8, -2748.59999999986 6652753.7, -2786.69999999995 6652744.3, -2822.99999999953 6652734.9, -2857.80000000028 6652722.9, -2880.99999999953 6652713.3, -2905.10000000009 6652702.1, -2937.60000000009 6652688.2, -2967.79999999981 6652677.6, -3000.39999999967 6652665.2, -3030.60000000009 6652653.3, -3059.59999999986 6652638.6, -3077.00000000023 6652629.5, -3099.69999999972 6652613.9, -3125.60000000033 6652591.9, -3153.59999999986 6652567.4, -3178.69999999972 6652543, -3196.39999999967 6652524.6, -3212.89999999944 6652506, -3224.19999999995 6652495, -3238.20000000019 6652476.3, -3242.99999999977 6652467.6, -3248.89999999944 6652450.6, -3252.80000000005 6652434.1, -3256.19999999949 6652425.2, -3257 6652422.6, -3258.49999999953 6652418.9, -3260.69999999972 6652412.3, -3270.49999999977 6652381.5, -3279.39999999944 6652351.7, -3285.3245068338751 6652328.2298383107)
                </WKTGeometry>
            </RoadLineReference>
        </Route>
</RouteWithData>

GetRoadDataAlongRoute

Calculates the route between the given locations and returns the series of roadsegments that covers that route

Parameters

Points - Array of points to calculate route for (At least one per each road in the route)
ViewDate -Date to use when viewing the roadnet
SearchRoadCategories - (optional) Filter of RoadCategories to look at when looking at roadnet
SearchRoadStatuses - (optional) Filter of RoadStatuses to look at when looking at roadnet
SearchRoadNumber - (optional) Filter of RoadNumber to look at when looking at roadnet
IncludeRoadAttributeTypes - Array of Attribute ID:s to include in returned data
ReturnRoadReferencesOnRoute - True to return the roadsegments of the route (else only roaddata on the route is returned)
TopologyLevel - TopologyLevel to use when snapping against roadnet and returning data
RouteType - (optional) Control what type of route that should be calculated. CostBased (default) calculates a route that is allowed for a vehicle to drive. LengthBased calculated the shortest (topologically correct) route.

GetRoadReferenceForNVDBReference

Gets a RoadReference for the given NVDB reflinkoid and relative length

Parameters

reflinkOID - NVDB ReflinkOID
rellen - Relative position (0..1) on RefLink

Optional parameters (for filtering)

ViewDate - Viewdate to use when looking at roadnet

REST Usage: 

RoadInfoService/GetRoadReferenceForNVDBReference?reflinkoid={reflinkoid}&rellen={rellen}
RoadInfoService/GetRoadReferenceForNVDBReference?reflinkoid={reflinkoid}&rellen={rellen}&ViewDate={yyyy-mm-dd}

Example: RoadInfoService/GetRoadReferenceForNVDBReference?reflinkoid=248917&rellen=0.5&ViewDate=2010-01-12

GetRoadReferenceForReference

Gets a RoadReference for the given Roadreferencestring

Parameters

roadreference - Roadreferencestring Ex: 1500EV0003902907618

Optional parameters (for filtering)

ViewDate - Viewdate to use when looking at roadnet
TopologyLevel - TopologyLevel (Overview, Roadway, Lane) to use when looking at roadnet

REST Usage: 

RoadInfoService/GetRoadReferenceForReference?roadReference={roadreferencestring}
RoadInfoService/GetRoadReferenceForReference?roadReference={roadreferencestring}&ViewDate={yyyy-mm-dd}&topologyLevel=Lane

Example: RoadInfoService/GetRoadReferenceForReference?roadReference=1500EV0003902907618&ViewDate=2013-01-12&topologyLevel=Overview

GetRoadReferenceHistoryForReference

Gets the RoadReference history for the given Roadreferencestring

Parameters

roadreference - Roadreferencestring Ex: 1500EV0003902907618

REST Usage: 

RoadInfoService/GetRoadReferenceHistoryForReference?roadReference={roadreferencestring}

Example: RoadInfoService/GetRoadReferenceHistoryForReference?roadReference=1500EV0003902907618

GetRoadReferenceHistoryForNVDBReference

Gets the RoadReference history for the given NVDB Reference location

Parameters

reflinkOID - NVDBLink OID
rellen - Relative length on Link (0..1)

REST Usage: 

RoadInfoService/GetRoadReferenceHistoryForNVDBReference?reflinkOID={link}&relLen={rellen}

Example: RoadInfoService/GetRoadReferenceHistoryForNVDBReference?reflinkOID=705187&relLen=0.743930600874405

GetRoadReferenceHistoryForLocation

Gets the RoadReference history for the given location

Parameters

easting - Easting coordinate (UTM33)
northing - Northing coordinate (UTM33)

REST Usage: 

RoadInfoService/GetRoadReferenceHistoryForLocation?easting={easting}&northing={northing}

Example: RoadInfoService/GetRoadReferenceHistoryForLocation?easting=214858&northing=6687762

Example / Demo

Using the map below you can test the services directly. When you click a location in the map the REST services are called and the data is display in the map

Søk Vegreferanse: Topology-Level:

Results
Extract data
Extract data along route

Road Reference

Data at location

The method GetDatainArea extracts data within a given polygon for a specified featuretype

Choose FeatureType

Polygon

After clicking the draw polygon button you can draw a polygon in the map by clicking its corners.
Doubleclick to stop drawing

Beskrivning

Click the mark waypoints button

Draw a line in the map by clicking its waypoints

Doubleclick to stop drawing