{"canonical_url":"https://engineer.company/nb/glossary/geojson/","content_markdown":"# GeoJSON\n\n## Hva det er\n\nGeoJSON er et åpent format for å utveksle kartobjekter, altså punktene, linjene og flatene på et\nkart sammen med opplysningene som hører til dem, som ett vanlig JSON-dokument. IETF standardiserte\ndet som RFC 7946 i august 2016, og den erstattet fellesskapsspesifikasjonen som først kom ut i 2008.\nEn GeoJSON-tekst sendes med medietypen application/geo+json og lagres som regel med filendelsen\n.geojson, selv om vanlig .json også er registrert.\n\nFormatet har tre slags objekter, og hvert av dem oppgir hvilken slags det er, i et «type»-medlem.\n\n- **Geometry** er en form. Det finnes sju typer: Point, MultiPoint, LineString, MultiLineString,\n  Polygon, MultiPolygon og GeometryCollection. De er formene i Simple Features-modellen fra Open\n  Geospatial Consortium (OGC), de samme som kodingene WKT og WKB bærer som tekst og binært.\n- **Feature** er én ting på kartet: en geometri, et «properties»-objekt med egenskapene til tingen,\n  og en valgfri «id». Geometrien kan være null for et objekt der plasseringen ikke er kjent.\n- **FeatureCollection** samler en liste med objekter i et «features»-medlem. Det er dette de fleste\n  filer og API-svar inneholder.\n\nEtt enkelt objekt for en smart strømmåler ser slik ut:\n\n```json\n{\n    \"type\": \"Feature\",\n    \"id\": \"meter-0417\",\n    \"geometry\": {\n        \"type\": \"Point\",\n        \"coordinates\": [12.5683, 55.6761]\n    },\n    \"properties\": {\n        \"name\": \"Meter 417\",\n        \"installed\": \"2023-04-12\"\n    }\n}\n```\n\nHver posisjon er en liste med tall: lengdegrad først, så breddegrad, så en valgfri høyde i meter.\nSpesifikasjonen sier at de to første kommer «precisely in that order», nøyaktig i den rekkefølgen,\nså punktet ovenfor ligger i sentrum av København, 12,57 grader øst og 55,68 grader nord. Alle\nkoordinater bruker ett og samme referansesystem, lengde- og breddegrad i WGS 84 oppgitt i\ndesimalgrader, som OGC kaller CRS84. Versjonen fra 2008 lot en fil oppgi et annet system i et\n«crs»-medlem. RFC 7946 fjernet det medlemmet fordi blandede referansesystemer hadde skapt problemer\nmed samspillet mellom systemer, og tillater et annet system bare der alle parter har blitt enige om\ndet på forhånd.\n\nPolygoner har egne regler. Hver ring er lukket, med minst fire posisjoner, og den siste gjentar den\nførste. Den første ringen er yttergrensen, og eventuelle senere ringer er hull. RFC 7946 legger til\nen høyrehåndsregel, der ytre ringer går mot klokka og hull med klokka, men fordi versjonen fra 2008\nikke sa noe om retningen, får parsere beskjed om å godta polygoner som bryter regelen.\n\n## Hvorfor det er viktig\n\nAlt som leser JSON, kan lese GeoJSON. En nettleser tolker det uten noe tillegg, et bibliotek for\nwebkart tegner det direkte, og en dokumentdatabase lagrer det slik det er. RFC 7946 nevner\nJavaScript-biblioteker for webkart, JSON-baserte dokumentdatabaser og web-API-er som stedene der det\ner i utstrakt bruk. Den rekkevidden gjør det til det vanlige formatet når kartdata forlater et\nGIS-verktøy på skrivebordet og skal ut på en nettside eller gjennom et API.\n\nStandarder bygger også på det. OGC API – Features, OGC-standarden for å servere geografiske objekter\nover HTTP, anbefaler GeoJSON overalt der dataene kan uttrykkes i det. En server som tilbyr GeoJSON,\nreturnerer en FeatureCollection for en liste med objekter og en enkelt Feature for ett objekt, begge\nsom application/geo+json, og standardsystemet er den samme lengde- og breddegraden i WGS 84 som\nGeoJSON låser fast.\n\nDe samme designvalgene setter grensene.\n\n- **Ett referansesystem.** Data som ligger i et nasjonalt rutenett, må transformeres til lengde- og\n  breddegrad før de skrives, og transformeres tilbake av hver mottaker som måler i meter.\n- **Bare enkle former.** Geometritypene dekker punkter, rette linjestykker og polygoner. Kurver,\n  volumer som 3D-bymodeller og koordinater utenfor WGS 84 faller utenfor formatet, og OGC API –\n  Features bruker nettopp de tilfellene som eksempler på data GeoJSON ikke kan bære.\n- **Størrelse.** Hver koordinat skrives ut som desimalsifre, og en FeatureCollection er én enkelt\n  JSON-verdi, som en vanlig JSON-parser leser helt til siste byte før den gir fra seg et eneste\n  objekt. RFC 8142 definerer GeoJSON Text Sequences, med medietypen application/geo+json-seq og én\n  GeoJSON-tekst per post, slik at vilkårlig store datasett kan leses bit for bit.\n- **Felles kanter lagres dobbelt.** To nabopolygoner lagrer hver sin fulle kopi av grensen de deler,\n  så grensen står der to ganger, og en endring i den ene kopien kan åpne en glipe eller en overlapp.\n\nRFC 7946 sier også rett ut hva formatet overlater til andre. GeoJSON gir ingen beskyttelse av\npersonvern eller integritet på egen hånd, så data under overføring er avhengige av TLS.\nSikkerhetsavsnittet advarer om at å publisere plasseringen til sårbare personer, dyr, leveområder\neller anlegg kan utsette dem for sporing eller skade, og at å gjøre posisjonene uskarpe i et\nanonymisert datasett neppe stopper et målrettet angrep.\n\n## Slik ser det ut i praksis\n\nPå tvers av\n[mer enn tretti GIS-prosjekter som ble bygget, satt i produksjon og driftet](/nb/portfolio/led-30-gis-projects-from-build-to-support/)\nvar GeoJSON ett av formatene GDAL/OGR flyttet data mellom, sammen med shapefiler, GeoTIFF, KML og\nvektorfliser. PostgreSQL med PostGIS holdt de romlige dataene under det hele, QGIS og JOSM tok seg\nav selve dataarbeidet, og det brukerne så, var webkart bygget på Mapbox GL og Leaflet.\n\nReferansesystemet må være avklart før noe av dette. I\n[en migrering fra MSSQL til PostgreSQL med PostGIS-utvidelsen](/nb/portfolio/improved-gis-map-performance-10x-on-postgresql/)\ngikk over 50 millioner romlige poster gjennom ETL-pipelines der transformasjonssteg brakte dem over\npå SRID-standarden EPSG:4326. Den koden betegner det samme WGS 84-datumet i grader som GeoJSON låser\nfast, og PostGIS-manualen slår fast at utdataene fra funksjonen ST_AsGeoJSON følger RFC 7946 for\ngeometri i EPSG:4326, uten at noen transformasjon trengs.\n\n## Hvor det går galt\n\n**Punktene havner i feil hav.** Et lag med adresser i Oslo dukker opp midt i Arabiahavet, og hver\nkontroll av verdiområdet går likevel gjennom, fordi begge tallene er gyldige grader. Bredde- og\nlengdegrad ble byttet om på vei inn. EPSG:4326 oppgir formelt breddegraden før lengdegraden, mange\ndatakilder følger det, og GeoJSON vil ha lengdegraden først. Bygg hver posisjon fra navngitte felter\ni stedet for fra kolonnerekkefølgen, og ha et testobjekt på en kjent adresse, slik at en ombytting\nstopper i en test og ikke først i en gjennomgang av kartet.\n\n**Koordinatene kommer i meter.** Et lag mangler på kartet eller blir avvist av klienten, og filen\ninneholder koordinater i hundretusenvis der det skulle stått grader. Geometrien var lagret i et\nprojisert nasjonalt rutenett og ble eksportert som den var. Transformer den til lengde- og\nbreddegrad først, med `ST_Transform(geom, 4326)` i PostGIS. Får den stå utransformert, legger\nST_AsGeoJSON som standard til et «crs»-medlem, nettopp det medlemmet RFC 7946 fjernet.\n\n**Polygonene tegnes vrengt i én klient.** Et dekningsområde fyller hele kartet unntatt sin egen\nform, mens andre verktøy tegner den samme filen riktig. Den klienten bruker retningen på hver ring\ntil å skille innsiden fra utsiden, og ringene går motsatt vei, noe versjonen fra 2008 tillot.\nPostGIS-manualen påpeker at enkelte klienter krever høyrehåndsregelen, så bruk den før eksporten med\n`ST_ForcePolygonCCW(geom)`, og test resultatet i hver klient som leser det.\n\n**Filene har flere sifre enn kartet trenger.** Et lag med detaljerte polygoner bruker flere sekunder\npå å lastes ned på en telefon, og koordinatene har ni eller flere desimaler. ST_AsGeoJSON skriver\nsom standard opptil ni desimaler, og RFC 7946 påpeker at å gå fra seks til femten kan nesten doble\nstørrelsen på en tekst, mens seks allerede gir en oppløsning på omtrent 10 centimeter. Gi en lavere\n`maxdecimaldigits`, og reduser presisjonen med `ST_ReducePrecision` først, fordi PostGIS-manualen\nadvarer om at å kutte sifre bare i utdataene kan gjøre en geometri ugyldig.\n\n**Interne kolonner følger med i properties.** Et offentlig endepunkt returnerer eiernavn, kosttall\neller notater som skulle blitt i databasen. Får ST_AsGeoJSON en hel rad, legger den hver kolonne\nunntatt geometrien i «properties». Velg bare kolonnene som skal publiseres, i en underspørring, og\npå PostGIS 3.5 eller nyere navngir du nøkkelkolonnen, slik at den blir objektets «id»:\n\n```sql\nSELECT json_build_object(\n  'type', 'FeatureCollection',\n  'features', json_agg(ST_AsGeoJSON(m.*, id_column =\u003e 'id')::json)\n)\nFROM (SELECT id, name, geom FROM meters) AS m;\n```\n\n## Les mer\n\n- [RFC 7946: The GeoJSON Format](https://www.rfc-editor.org/rfc/rfc7946) — IETF-standarden, med\n  objekttypene, koordinatrekkefølgen, regelen for ringretning, rådene om presisjon og\n  sikkerhetsavsnittet.\n- [RFC 8142: GeoJSON Text Sequences](https://www.rfc-editor.org/rfc/rfc8142) — følgeformatet som\n  deler et stort datasett opp i én GeoJSON-tekst per post.\n- [ST_AsGeoJSON](https://postgis.net/docs/ST_AsGeoJSON.html) — siden i PostGIS-manualen om å\n  eksportere geometri og hele rader som GeoJSON, med valgene for presisjon og flagg.\n- [EPSG:4326 WGS 84](https://epsg.org/crs_4326/WGS-84.html) — registeroppføringen der aksefølgen\n  setter breddegraden først, stikk motsatt av GeoJSON.\n- [OGC API – Features – Part 1: Core](https://docs.ogc.org/is/17-069r4/17-069r4.html) —\n  OGC-standarden som anbefaler GeoJSON for å servere objekter over HTTP.\n\n\u003chttps://engineer.company/nb/glossary/geojson/\u003e\n","date_modified":"2026-10-20T21:59:50Z","description":"Slik lagrer GeoJSON kartobjekter for nettlesere og web-API-er, derfor står lengdegraden først, og her er feilene som flytter eller blåser opp dataene.","formats":{"gemtext":"https://engineer.company/nb/glossary/geojson/index.gmi","gopher":"https://engineer.company/nb/glossary/geojson/gophermap","html":"https://engineer.company/nb/glossary/geojson/","json":"https://engineer.company/nb/glossary/geojson/index.json","markdown":"https://engineer.company/nb/glossary/geojson/index.md","pdf":"https://engineer.company/nb/glossary/geojson/index.pdf"},"kind":"page","language":"nb","title":"Hva er GeoJSON?","url":"https://engineer.company/nb/glossary/geojson/","version":1}