Nominatim — OpenStreetMap-geokodning
Nominatim är det officiella geokodnings-API:et byggt på OpenStreetMap-data. Ger friform- och strukturerad adress → koordinat (geokodning), koordinat → adress (omvänd geokodning), POI-sökning och OSM-ID-uppslag — globalt, utan API-nyckel. Kompletterar Kartverket (norsk primärkälla) med global täckning och platssökning. ODbL-licens, max 1 req/s mot offentlig server (resultat cachas).
—
Datamängd
Dagligen
Uppdatering
4
MCP-verktyg
{
"data": "..."
}MCP-integration
API-endpunkter
/searchFri-form adresse-/stedsøk
- q obligatorisk
- Fritekst-adressesøk
q=Karl Johans gate, Oslo - country valfri
- Begrens til ISO-3166-1 alpha-2 landkode(r), kommaseparert
country=no - countrycodes valfri
- Alias for `country` (Nominatims eget navn). `country` vinner hvis begge er gitt.
countrycodes=no - limit valfri
- Maks antall treff
limit=10 - viewbox valfri
- Prioriter/begrens til bounding box: x1,y1,x2,y2 (lon/lat)
- bounded valfri
- Når true sammen med viewbox: kun treff strengt innenfor boksen
Visa curl-exempel
# GET https://data.ketl.no/api/connectors/nominatim/search?q=Karl%20Johans%20gate%2C%20Oslo
curl \
-H "Accept: application/json" \
"https://data.ketl.no/api/connectors/nominatim/search?q=Karl%20Johans%20gate%2C%20Oslo"Autentiserat anrop — lägg till en av dessa headers: x-api-key: ketl_… · Authorization: Bearer … — Se fullständig referens i dokumentationen.
/geocodeStrukturert geokoding (street/city/country)
- street valfri
- Gate (minst ett av street/city/county/state/country/postalcode)
street=Karl Johans gate 1 - city valfri
- By
city=Oslo - county valfri
- Fylke. NORSKE fylker slås opp her — ikke via `state`
county=Oslo - state valfri
- Delstat/region. OSM fører IKKE norsk administrativ geografi som `state` (Oslo/Vestland gir 0 treff, målt 2026-08-20) — bruk `county` for norske fylker. Eksempelet er derfor tysk
state=Bayern - country valfri
- Land
country=Norway - postalcode valfri
- Postnummer
postalcode=0154 - limit valfri
- Maks antall treff
limit=5
Visa curl-exempel
# GET https://data.ketl.no/api/connectors/nominatim/geocode
curl \
-H "Accept: application/json" \
"https://data.ketl.no/api/connectors/nominatim/geocode"Autentiserat anrop — lägg till en av dessa headers: x-api-key: ketl_… · Authorization: Bearer … — Se fullständig referens i dokumentationen.
/reverseOmvendt geokoding (koordinat → adresse)
- lat obligatorisk
- Breddegrad (WGS84)
lat=59.913 - lon obligatorisk
- Lengdegrad (WGS84)
lon=10.752 - zoom valfri
- OSM-detaljnivå for treffet (0 = land, 10 = by, 18 = bygning). Utelat for Nominatims default.
zoom=18
Visa curl-exempel
# GET https://data.ketl.no/api/connectors/nominatim/reverse?lat=59.913&lon=10.752
curl \
-H "Accept: application/json" \
"https://data.ketl.no/api/connectors/nominatim/reverse?lat=59.913&lon=10.752"Autentiserat anrop — lägg till en av dessa headers: x-api-key: ketl_… · Authorization: Bearer … — Se fullständig referens i dokumentationen.
/lookupOppslag på OSM-ID-er
- osm_ids obligatorisk
- Kommaseparert liste OSM-IDer (N/W/R-prefiks)
osm_ids=R2978650
Visa curl-exempel
# GET https://data.ketl.no/api/connectors/nominatim/lookup?osm_ids=R2978650
curl \
-H "Accept: application/json" \
"https://data.ketl.no/api/connectors/nominatim/lookup?osm_ids=R2978650"Autentiserat anrop — lägg till en av dessa headers: x-api-key: ketl_… · Authorization: Bearer … — Se fullständig referens i dokumentationen.