Nominatim — OpenStreetMap-geokoding
Nominatim er det offisielle geokodings-APIet bygget på OpenStreetMap-data. Gir fri-form og strukturert adresse → koordinat (geokoding), koordinat → adresse (omvendt geokoding), POI-søk og OSM-ID-oppslag — globalt, uten API-nøkkel. Komplementerer Kartverket (norsk primærkilde) med global dekning og stedsøk. ODbL-lisens, maks 1 req/s mot offentlig server (resultater caches).
—
Datamengde
Daglig
Oppdatering
4
MCP-verktøy
{
"data": "..."
}MCP-integrasjon
API-endepunkter
/searchFri-form adresse-/stedsøk
- q påkrevd
- Fritekst-adressesøk
q=Karl Johans gate, Oslo - country valgfri
- Begrens til ISO-3166-1 alpha-2 landkode(r), kommaseparert
country=no - countrycodes valgfri
- Alias for `country` (Nominatims eget navn). `country` vinner hvis begge er gitt.
countrycodes=no - limit valgfri
- Maks antall treff
limit=10 - viewbox valgfri
- Prioriter/begrens til bounding box: x1,y1,x2,y2 (lon/lat)
- bounded valgfri
- Når true sammen med viewbox: kun treff strengt innenfor boksen
Vis curl-eksempel
# 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"Autentisert kall — legg til én av disse headerne: x-api-key: ketl_… · Authorization: Bearer … — Se full referanse i dokumentasjonen.
/geocodeStrukturert geokoding (street/city/country)
- street valgfri
- Gate (minst ett av street/city/county/state/country/postalcode)
street=Karl Johans gate 1 - city valgfri
- By
city=Oslo - county valgfri
- Fylke. NORSKE fylker slås opp her — ikke via `state`
county=Oslo - state valgfri
- 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 valgfri
- Land
country=Norway - postalcode valgfri
- Postnummer
postalcode=0154 - limit valgfri
- Maks antall treff
limit=5
Vis curl-eksempel
# GET https://data.ketl.no/api/connectors/nominatim/geocode
curl \
-H "Accept: application/json" \
"https://data.ketl.no/api/connectors/nominatim/geocode"Autentisert kall — legg til én av disse headerne: x-api-key: ketl_… · Authorization: Bearer … — Se full referanse i dokumentasjonen.
/reverseOmvendt geokoding (koordinat → adresse)
- lat påkrevd
- Breddegrad (WGS84)
lat=59.913 - lon påkrevd
- Lengdegrad (WGS84)
lon=10.752 - zoom valgfri
- OSM-detaljnivå for treffet (0 = land, 10 = by, 18 = bygning). Utelat for Nominatims default.
zoom=18
Vis curl-eksempel
# 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"Autentisert kall — legg til én av disse headerne: x-api-key: ketl_… · Authorization: Bearer … — Se full referanse i dokumentasjonen.
/lookupOppslag på OSM-ID-er
- osm_ids påkrevd
- Kommaseparert liste OSM-IDer (N/W/R-prefiks)
osm_ids=R2978650
Vis curl-eksempel
# 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"Autentisert kall — legg til én av disse headerne: x-api-key: ketl_… · Authorization: Bearer … — Se full referanse i dokumentasjonen.