Kartpunkt
EnglishSkapa testnyckel

Adresser

Geokodning av svenska adresser via API

Ni skickar en text som en person skrev eller en koordinat, och API:et svarar med adresser ur Lantmäteriets adressregister, en adress i taget.

Operationerna

Ett anrop och dess svar

En felstavad sökning, med en träff.

POST https://api.kartpunkt.se/v1/geocode
Authorization: Bearer $KARTPUNKT_API_KEY
Content-Type: application/json

{"q": "jarngatan 2 upsala", "limit": 1}

Svaret en testnyckel fick, ur testdata (2026-10-05). Rader som börjar med // … är utelämnade.

{
  "results": [
    {
      "id": "se.syn.syn-0000uvt",
      "type": "address",
      "label": "Järngatan 2, 755 41 Uppsala",
      "street": "Järngatan",
      "number": 2,
      "letter": null,
      "postcode": "75541",
      "locality": "Uppsala",
      "municipality_code": "0380",
      "municipality": "Uppsala",
      "county_code": "03",
      "county": "Uppsala län",
      "district_code": "903802",
      "district": "Uppsala södra",
      "point": {"lat": 59.859903789196885, "lon": 17.64433171466342},
      "position_type": "driveway",
      "match_type": "corrected",
      "score": 6.057753791356872
    }
  ],
  "provenance": {
    "synthetic": true,
    "sources": [
      {
        "id": "synthetic",
        "name": "Kartpunkt synthetic test addresses",
        "licence": "CC0-1.0",
        "attribution": "Syntetiska testadresser från Kartpunkt, inte verkliga adresser.",
        "url": "https://creativecommons.org/publicdomain/zero/1.0/",
        "updated": "2026-10-05"
      }
    ]
  }
}

Vad svaret innehåller

Varje träff har ett adress-id, id, adressens delar, kommun och län, en punkt och dess lägestyp, och i match_type hur träffen förhåller sig till det som skrevs. Spara adress-id:t: med POST /v1/addresses/changes ser ni senare om adressen har ändrats eller avslutats.

provenance anger källan och dess licens. Ett svar med Lantmäteriets adresser har Lantmäteriets källhänvisning, som licensen CC BY 4.0 kräver.

Testnyckel och livenyckel

En testnyckel svarar med testdata: påhittade adresser i samma format som livedata, märkta "synthetic": true, som i svaret ovan. En livenyckel svarar med Lantmäteriets adresser och kräver en betald plan och godkänd tillgång till livedata. Integrationen är densamma; ni byter bara nyckel.

En adress i taget

Lantmäteriets adresser lämnas som enskilda svar: varje anrop gäller en sökning, en koordinat eller en adress och svarar med några träffar. En egen adresslista, upp till 50 000 rader, geokodas som ett jobb med ett svar per rad.

Prova och kom igång