API-dokumentasjon

Vegreferanse er et lineært referansesystem som brukes til stedfesting av vegobjekter og administrativ klassifisering av vegnettet.

For vegobjekter kan vegreferanse returneres som den av del responsen, og vegreferansen kan benyttes som et avgrensende områdefilter.

Vegreferanse i respons

Følgende objekt returneres som en del av vegobjekter, og som respons i andre endepunkter.

{
    "vegreferanse": {
        "fylke": 16,
        "kommune": 0,
        "kategori": "E",
        "status": "V",
        "nummer": 6,
        "hp": 1,
        "meter": 2024,
        "kortform": "5000 Ev6 hp1 m2024"
    }
}
fylke
Felt Beskrivelse
fylke Tosifret fylkesnummer.
kommune Tosifret kommunenummer. For europa-, riks- og fylkesveger er kommunenummeret alltid 0.
kategori Angir vegkategori.
  • E - Europaveg
  • R - Riksveg
  • F - Fylkesveg
  • K - Kommunal veg
  • P - Privat veg
  • S - Skogsbilveg
status Angir vegstatus.
  • V - Eksisterende veg
  • W - Midlertidig veg
  • T - Midlertidig status bilveg
  • S - Eksisterende ferjestrekning
  • G - Gang-/sykkelveg
  • U - Midlertidig status gang-/sykkelveg
  • B - Beredskapsveg
  • M - Serviceveg
  • X - Rømningstunnel
  • A - Anleggsveg
  • H - Gang-/sykkelveg anlegg
  • P - Vedtatt veg
  • E - Vedtatt ferjestrekning
  • Q - Vedtatt gang-/sykkelveg
nummer Angir vegnummer.
hp Angir parsell.
  • 1–49 - Hovedparseller
  • 50–69 - Armer
  • 70–199 - Ramper
  • 400–599 - Rundkjøringer
  • 600–699 - Skjøteparseller
  • 800–998 - Trafikklommer, rasteplasser
meter Angir posisjon i hele meter, regnet fra parsellens start.
kortform Sammenslått versjon av vegreferansen.
For _strekninger_ returneres `fra_meter` og `til_meter` i stedet for `meter`. Dersom et vegobjekt er stedfestet på mer enn én vegstrekning, returneres det flere vegreferanseobjekter. ## Vegreferanse som parameter Flere av endepunktene aksepterer en vegreferanse som parameter. Vegreferansen kan angis som et punkt eller en strekning. For å gjøre presise avgrensninger av hvilket vegnettet det skal hentes vegobjekter innenfor, er det mulig å angi deler av vegreferanse på ulike måter.
Eksempel Beskrivelse
E Kun vegkategori.
?v Kun vegstatus.
Ev Vegkategori og vegstatus.
E6 Vegkategori og vegnummer.
Ev6 Vegkategori, vegstatus og vegnummer.
Ev6hp1 Angivelse av hovedparsell.
Ev6hp1-hp4 Angivelse av flere hovedparseller.
Ev6hp1m100 Angivelse av et punkt.
Ev6hp1m100-200 Angivelse av en strekning.
Ev6hp1m100-hp2m200 Angivelse av strekning over flere hovedparseller.
Parameteren er case-insensitiv, og mellomrom fjernes automatisk. ## Vegreferanse som unik nøkkel Vegnummer for FKPS-veger er ikke unike. Fylkesveg 950 finnes for eksempel både i Nordland, Sør-Trøndelag og Vestfold, og du finner kommunalveg 1640 flere steder i landet. Hovedparseller er heller ikke unike, og strekningen Ev6 hp1 befinner seg i hele 10 ulike fylker. For å angi et unikt punkt ved å bruke vegreferanse, må derfor fylkes- og kommunenummer angis. Eksempel: `5000Ev6hp1m2024` Endepunktet [/veg](#/get/veg) støtter kun vegreferanser som angis på denne måten. ## Mer informasjon For utfyllende informasjon om vegreferansen, se [Håndbok V830: Nasjonalt vegreferansesystem](http://www.vegvesen.no/_attachment/61505).