{"components":{"schemas":{"GeoJsonCoordinates":{"additionalProperties":false,"properties":{"coordinates":{"items":{},"type":"array"},"type":{"type":"string"}},"type":"object"},"GeoKodingRespons":{"additionalProperties":false,"properties":{"crs":{"$ref":"#/components/schemas/GeojsonCrs"},"features":{"items":{"$ref":"#/components/schemas/GeokodingGeoJson"},"type":"array"},"type":{"type":"string"}},"type":"object"},"GeojsonCrs":{"additionalProperties":false,"properties":{"properties":{"$ref":"#/components/schemas/GeojsonEpsg"},"type":{"type":"string"}},"type":"object"},"GeojsonEpsg":{"additionalProperties":false,"properties":{"name":{"type":"string"}},"type":"object"},"GeokodingGeoJson":{"additionalProperties":false,"properties":{"geometry":{"$ref":"#/components/schemas/GeoJsonCoordinates"},"properties":{"$ref":"#/components/schemas/GeokodingProperties"},"type":{"type":"string"}},"type":"object"},"GeokodingProperties":{"additionalProperties":false,"properties":{"bruksnummer":{"description":"Del av et matrikkelnummer","type":"integer"},"festenummer":{"description":"Del av et matrikkelnummer","type":"integer"},"gardsnummer":{"description":"Del av et matrikkelnummer","type":"integer"},"hovedomr\u00e5de":{"description":"Angir om omr\u00e5det er teigens eller anleggsprojeksjonens hovedteig/hovedflate.","type":"boolean"},"kommunenummer":{"description":"Kommunenummer best\u00e5ende av fire tegn med ledende 0 om n\u00f8dvendig.","maxLength":4,"minLength":4,"pattern":"^[0123456789]*$","type":"string"},"lokalid":{"description":"Lokal identifikator, tildelt av dataleverand\u00f8r/dataforvalter (her matrikkelsystemet, Kartverket).","type":"integer"},"matrikkelnummertekst":{"description":"Generert tekst ut fra hvilken matrikkelenhet teigen tilh\u00f8rer. Eventuelt flere matrikkelnummere skyldes manglende, uavklarte grenser eller uregistrert jordsameie.","type":"string"},"meterFraPunkt":{"description":"Distanse i meter til punktet det ble s\u00f8kt etter.","type":"integer"},"n\u00f8yaktighetsklasseteig":{"description":"Grov klassifisering (trafikklys) av stedfestingsn\u00f8yaktighet. (Gr\u00f8nt = ok, gult = sjekk!, r\u00f8dt = store mangler)","type":"string"},"objekttype":{"description":"Stedfesting/geometri hentes fra to objekttyper, teig eller anleggsprojeksjonsflate. Den siste er \u00abfotavtrykk\u00bb av volumer som fins over eller under teiger p\u00e5 terrenget","type":"string"},"oppdateringsdato":{"description":"dato for siste endring p\u00e5 data-objektet i matrikkelsystemet","format":null,"pattern":null,"type":"string"},"seksjonsnummer":{"description":"Del av et matrikkelnummer","type":"integer"},"teigmedflerematrikkelenheter":{"description":"Teigen mangler indre avgrensing mellom de registrerte matrikkelnummerene","type":"boolean"},"uregistrertjordsameie":{"description":"De registrerte matrikkelnummerene har andel i teigen","type":"boolean"}},"type":"object"},"Metadata":{"additionalProperties":false,"properties":{"side":{"default":1,"description":"Sidenummeret som skal vises i returen. Minimum 1, maksimum 500.","maximum":500,"minimum":1,"type":"integer"},"sokeStreng":{"description":"S\u00f8kestrengen som ble sendt inn til API-et.","type":"string"},"totaltAntallTreff":{"description":"Antall treff som s\u00f8ket returnerte.","type":"integer"},"treffPerSide":{"default":10,"description":"Antall treff per side. Minimum 1, maksimum 500.","maximum":500,"minimum":1,"type":"integer"},"viserFra":{"description":"Viser treff fra objekt nummer X i responsen.","type":"integer"},"viserTil":{"description":"Viser treff til objekt nummer X i responsen.","type":"integer"}},"type":"object"},"Punkt":{"additionalProperties":false,"properties":{"bruksnummer":{"description":"Del av et matrikkelnummer","type":"integer"},"festenummer":{"description":"Del av et matrikkelnummer","type":"integer"},"gardsnummer":{"description":"Del av et matrikkelnummer","type":"integer"},"hovedomr\u00e5de":{"description":"Angir om omr\u00e5det er teigens eller anleggsprojeksjonens hovedteig/hovedflate.","type":"boolean"},"kommunenummer":{"description":"Kommunenummer best\u00e5ende av fire tegn med ledende 0 om n\u00f8dvendig.","maxLength":4,"minLength":4,"pattern":"^[0123456789]*$","type":"string"},"lokalid":{"description":"Lokal identifikator, tildelt av dataleverand\u00f8r/dataforvalter (her matrikkelsystemet, Kartverket).","type":"integer"},"matrikkelnummertekst":{"description":"Generert tekst ut fra hvilken matrikkelenhet teigen tilh\u00f8rer. Eventuelt flere matrikkelnummere skyldes manglende, uavklarte grenser eller uregistrert jordsameie.","type":"string"},"meterFraPunkt":{"description":"Distanse i meter til punktet det ble s\u00f8kt etter.","type":"integer"},"n\u00f8yaktighetsklasseteig":{"description":"Grov klassifisering (trafikklys) av stedfestingsn\u00f8yaktighet. (Gr\u00f8nt = ok, gult = sjekk!, r\u00f8dt = store mangler)","type":"string"},"objekttype":{"description":"Stedfesting/geometri hentes fra to objekttyper, teig eller anleggsprojeksjonsflate. Den siste er \u00abfotavtrykk\u00bb av volumer som fins over eller under teiger p\u00e5 terrenget","type":"string"},"oppdateringsdato":{"description":"dato for siste endring p\u00e5 data-objektet i matrikkelsystemet","format":null,"pattern":null,"type":"string"},"representasjonspunkt":{"allOf":[{"$ref":"#/components/schemas/Representasjonspunkt"}],"description":"Punktet ligger innenfor teigens eller flatens avgrensing."},"seksjonsnummer":{"description":"Del av et matrikkelnummer","type":"integer"},"teigmedflerematrikkelenheter":{"description":"Teigen mangler indre avgrensing mellom de registrerte matrikkelnummerene","type":"boolean"},"uregistrertjordsameie":{"description":"De registrerte matrikkelnummerene har andel i teigen","type":"boolean"}},"type":"object"},"PunktRespons":{"additionalProperties":false,"properties":{"eiendom":{"items":{"$ref":"#/components/schemas/Punkt"},"type":"array"},"metadata":{"$ref":"#/components/schemas/Metadata"}},"type":"object"},"Representasjonspunkt":{"additionalProperties":false,"properties":{"koordsys":{"description":"Koordinatsystemet til representasjonspunktet, oppgis som en SRID (alts\u00e5 tall-delen av en EPSG-kode, f.eks. 4258 eller 25833).","type":"integer"},"nord":{"description":"","type":"number"},"\u00f8st":{"description":"","type":"number"}},"type":"object"}}},"info":{"description":"\nAPI fra Kartverket for geokoding eller lokalisering av eiendommer. Finn eiendommer ved en posisjon, eller finn posisjonen til et matrikkelnummer.\n\nI dette APIet er eiendommer definert som matrikkelenheter med avgrensing i kartet. Datagrunnlaget har vanligvis et d\u00f8gn forsinkelse fra Matrikkelen.\n\nObs. Eiendomskartet i matrikkelen kan v\u00e6re ufullstendig eller upresist.\n\nDet er ikke n\u00f8dvendig med innlogging/autorisasjon for \u00e5 bruke APIet.\n\nMedio desember 2023 ble APIet flyttet til et nytt endepunkt som er tilgjengelig p\u00e5 <a href=\"https://api.kartverket.no/eiendom/v1\">https://api.kartverket.no/eiendom/v1</a>.\nDet tidligere endepunktet <a href=\"https://ws.geonorge.no/eiendom/v1\">https://ws.geonorge.no/eiendom/v1</a> vil v\u00e6re tilgjengelig inntil videre, og vil fungere som en proxy til det nye endepunktet.\nVi anbefaler likevel \u00e5 bytte til det nye endepunktet.\n\nSt\u00f8rre eller ikke-kompatible endringer i APIet vil bli annonsert med minst 3 m\u00e5neder forvarsel p\u00e5 <a href=\"https://status.kartverket.no\">https://status.kartverket.no</a>.\n\nOmr\u00e5de for eiendom kan leveres, men type grense eller kvalitetsinformasjon om grenser leveres IKKE i dette APIet.\nHvis man \u00f8nsker \u00e5 hente ned datagrunnlaget s\u00e5 anbefales det \u00e5 laste ned filene som er tilgjengeliggjort via <a href=\"https://www.geonorge.no\">geonorge.no</a> (Matrikkelen-Eiendomskart Teig).\nFor direkte henting av grenseinformasjon fra Matrikkelen, - bruk MatrikkelAPI.","title":"\u00c5pent eiendoms-API for lokalisering","version":"1.1.0"},"openapi":"3.0.3","paths":{"/geokoding":{"get":{"description":"Finn representasjonspunkt eller omr\u00e5de for et spesifikt matrikkelnummer. Matrikkelnummeret m\u00e5 ha formen \"Kommunenr-G\u00e5rdsnr/Bruksnr/Festenr/Seksjonsnr\" hvis festenr og seksjonsnr er aktuelt (seksjoner med eget uteareal, eller eiendommen den er seksjonert p\u00e5). For eksempel ?matrikkelnummer=0301-223/60/0/3<p> Alternativt kan man oppgi nummerene individuelt. For eksempel  ?kommunenummer=0301&gardsnummer=223&bruksnummer=60</p>","parameters":[{"description":"Den offisielle benevnelsen for en eiendom. Fullstendig matrikkelnummer best\u00e5r av kommunenummer, gardsnummer, bruksnummer, eventuelt festenummer, eventuelt seksjonsnummer, f.eks 3413-325/2 (grunneiendom), 3413-325/2/1 (festegrunn) eller 3413-6/501/0/2 (seksjon)","in":"query","name":"matrikkelnummer","required":false,"schema":{"type":"string"}},{"description":"Angi som \"true\" for \u00e5 hente ut omr\u00e5de i stedet for kun representasjonspunktet.  Omr\u00e5de er flater avgrenset av linjer som kan v\u00e6re eiendomsgrenser (av ulik kvalitet), men ogs\u00e5 hjelpelinjer der grenser mangler i matrikkelen.  For volumer over eller under bakken er omr\u00e5de et \u00abfotavtrykk\u00bb.","in":"query","name":"omrade","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Kommunenummer best\u00e5ende av fire tegn med ledende 0 om n\u00f8dvendig.","in":"query","name":"kommunenummer","required":false,"schema":{"maxLength":4,"minLength":4,"pattern":"^[0123456789]*$","type":"string"}},{"description":"Del av et matrikkelnummer","in":"query","name":"gardsnummer","required":false,"schema":{"type":"integer"}},{"description":"Del av et matrikkelnummer","in":"query","name":"bruksnummer","required":false,"schema":{"type":"integer"}},{"description":"Del av et matrikkelnummer","in":"query","name":"festenummer","required":false,"schema":{"type":"integer"}},{"description":"Del av et matrikkelnummer","in":"query","name":"seksjonsnummer","required":false,"schema":{"type":"integer"}},{"description":"Angi det koordinatsystemet som du \u00f8nsker at geometrien i returen skal transformeres til, oppgis som en SRID (alts\u00e5 tallene i en EPSG-kode, f.eks. 4258 eller 25833). Standard er 4258. 4258 er i praksis identisk med 4326. Hvis det bes om et annet koordinatsystem enn det som er standard for geojson (4326/4258) s\u00e5 inkluderes et CRS-element i en geojson-respons.","in":"query","name":"utkoordsys","required":false,"schema":{"default":4258,"maximum":99999,"minimum":0,"type":"integer"}},{"description":"Vis kun de elementene du vil ha i returen. Kommaseparert liste med n\u00f8kler. For \u00e5 hente ut underobjekter bruk \".\"-notasjon, f.eks. &filtrer=metadata.side","in":"query","name":"filtrer","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeoKodingRespons"}}},"description":"ok"}},"summary":"Finn representasjonspunkt eller omr\u00e5de for et spesifikt matrikkelnummer."}},"/punkt":{"get":{"description":"Gj\u00f8r et geografisk s\u00f8k etter de n\u00e6rmeste eiendommene, dvs deres teiger eller anleggsprojeksjonsflate registrert i matrikkelsystemet. <p>For eksempel ?nord=60.5&ost=11.12&koordsys=4258&radius=1000</p>","parameters":[{"description":"\u00d8st-koordinaten/Longitude","in":"query","name":"ost","required":true,"schema":{"type":"number"}},{"description":"Nord-koordinaten/Latitude","in":"query","name":"nord","required":true,"schema":{"type":"number"}},{"description":"Koordinatsystemet (EPSG) til koordinatene du s\u00f8ker med. Angis som en SRID, for eksempel 4258 eller 25833.","in":"query","name":"koordsys","required":true,"schema":{"maximum":999999,"minimum":1,"type":"integer"}},{"description":"Radius i antall meter som s\u00f8ket leter etter eiendommer i. Maksimum er 3000m.","in":"query","name":"radius","required":false,"schema":{"default":100,"maximum":3000,"minimum":1,"type":"integer"}},{"description":"Angi det koordinatsystemet som du \u00f8nsker at geometrien i returen skal transformeres til, oppgis som en SRID (alts\u00e5 tallene i en EPSG-kode, f.eks. 4258 eller 25833). Standard er 4258. 4258 er i praksis identisk med 4326. Hvis det bes om et annet koordinatsystem enn det som er standard for geojson (4326/4258) s\u00e5 inkluderes et CRS-element i en geojson-respons.","in":"query","name":"utkoordsys","required":false,"schema":{"default":4258,"maximum":99999,"minimum":0,"type":"integer"}},{"description":"Vis kun de elementene du vil ha i returen. Kommaseparert liste med n\u00f8kler. For \u00e5 hente ut underobjekter bruk \".\"-notasjon, f.eks. &filtrer=metadata.side","in":"query","name":"filtrer","required":false,"schema":{"type":"string"}},{"description":"Antall treff per side. Minimum 1, maksimum 500.","in":"query","name":"treffPerSide","required":false,"schema":{"default":10,"maximum":500,"minimum":1,"type":"integer"}},{"description":"Sidenummeret som skal vises i returen. Minimum 1, maksimum 500.","in":"query","name":"side","required":false,"schema":{"default":1,"maximum":500,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PunktRespons"}}},"description":"ok"}},"summary":"Finn eiendommer n\u00e6r et gitt geografisk punkt."}},"/punkt/omrader":{"get":{"description":"Gj\u00f8r et geografisk s\u00f8k etter teigene til de n\u00e6rmeste eiendommene, dvs deres teiger eller anleggsprojeksjonsflate registrert i matrikkelsystemet. Det returneres i form av en GeoJSON-featurecollection. <p>For eksempel ?nord=60.5&ost=11.12&koordsys=4258&radius=1000</p>","parameters":[{"description":"\u00d8st-koordinaten/Longitude","in":"query","name":"ost","required":true,"schema":{"type":"number"}},{"description":"Nord-koordinaten/Latitude","in":"query","name":"nord","required":true,"schema":{"type":"number"}},{"description":"Koordinatsystemet (EPSG) til koordinatene du s\u00f8ker med. Angis som en SRID, for eksempel 4258 eller 25833.","in":"query","name":"koordsys","required":true,"schema":{"maximum":999999,"minimum":1,"type":"integer"}},{"description":"Radius i antall meter som s\u00f8ket leter etter eiendommer i. Maksimum er 3000m.","in":"query","name":"radius","required":false,"schema":{"default":100,"maximum":3000,"minimum":1,"type":"integer"}},{"description":"Angi det koordinatsystemet som du \u00f8nsker at geometrien i returen skal transformeres til, oppgis som en SRID (alts\u00e5 tallene i en EPSG-kode, f.eks. 4258 eller 25833). Standard er 4258. 4258 er i praksis identisk med 4326. Hvis det bes om et annet koordinatsystem enn det som er standard for geojson (4326/4258) s\u00e5 inkluderes et CRS-element i en geojson-respons.","in":"query","name":"utkoordsys","required":false,"schema":{"default":4258,"maximum":99999,"minimum":0,"type":"integer"}},{"description":"Vis kun de elementene du vil ha i returen. Kommaseparert liste med n\u00f8kler. For \u00e5 hente ut underobjekter bruk \".\"-notasjon, f.eks. &filtrer=metadata.side","in":"query","name":"filtrer","required":false,"schema":{"type":"string"}},{"description":"Maks antall objekter i GeoJSON-featurecollection responsen. Maksimum er 500.","in":"query","name":"maksTreff","required":false,"schema":{"default":50,"maximum":500,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeoKodingRespons"}}},"description":"ok"}},"summary":"Returnerer GeoJSON med omr\u00e5der n\u00e6r et gitt geografisk punkt."}}},"servers":[{"url":"https://api.kartverket.no/eiendom/v1"}]}