Nominatim — OpenStreetMap-geokodning
Nominatim er det officielle geokodnings-API bygget på OpenStreetMap-data. Giver friform- og struktureret adresse → koordinat (geokodning), koordinat → adresse (omvendt geokodning), POI-søgning og OSM-ID-opslag — globalt, uden API-nøgle. Supplerer Kartverket (norsk primærkilde) med global dækning og stedsøgning. ODbL-licens, maks 1 req/s mod offentlig server (resultater caches).
—
Datamængde
Dagligt
Opdatering
4
MCP-værktøjer
{
"data": "..."
}MCP-integration
API-endepunkter
/searchFri-form adresse-/stedsøk
- q påkrævet
- 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"Autentificeret kald — tilføj én af disse headere: x-api-key: ketl_… · Authorization: Bearer … — Se den fulde reference i dokumentationen.
/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"Autentificeret kald — tilføj én af disse headere: x-api-key: ketl_… · Authorization: Bearer … — Se den fulde reference i dokumentationen.
/reverseOmvendt geokoding (koordinat → adresse)
- lat påkrævet
- Breddegrad (WGS84)
lat=59.913 - lon påkrævet
- 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"Autentificeret kald — tilføj én af disse headere: x-api-key: ketl_… · Authorization: Bearer … — Se den fulde reference i dokumentationen.
/lookupOppslag på OSM-ID-er
- osm_ids påkrævet
- 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"Autentificeret kald — tilføj én af disse headere: x-api-key: ketl_… · Authorization: Bearer … — Se den fulde reference i dokumentationen.