maptech 0.1.0

NORWEGIAN GEOLOCATION API

Instructions for agents and LLMs.

USAGE

- Send GET /address?lat={latitude}&lon={longitude} to find the nearest address.
- Send GET /geopoint?address={address} to find matching addresses and their coordinates.
- Send GET /object to search geographic objects.
- Send GET /drive?lat={latitude}&lon={longitude} for the roads, speed limits, cameras, camera sections and gas stations around a position, as used by the drive view. radius defaults to 1000 and can be 1 to 2000.
- Browsers requesting / with Accept: text/html get the drive view.
- URL-encode query parameter values. No request body is required.
- Coordinates use WGS84. GeoJSON coordinates are [longitude, latitude].
- Distances and radii are in metres.

PARAMETERS

- /address requires lat and lon; radius is optional.
- /geopoint requires address; postalcode, municipalitycode and limit are optional.
- Address text matching is exact and case-insensitive.
- /object accepts type, lat, lon, radius, id, filter.FIELD, sort, order and limit.
- Object types: road, address, camera, camera_section, speed_limit.
- Separate types with commas; omit type to search all five.
- Geographic searches require both lat and lon. The default radius is 1000; allowed range is 0 to 100000.
- Without coordinates, /object has no geographic restriction.
- Filters match exact values and combine with AND. Strings ignore case.
- Filter and sort fields: id, nvdbid, type, roadtype, addresscode, addressname, text, number, letter, municipalitycode, municipalityname, postalcode, postalplace, name, direction, roadreference, roadlinkid, startposition, endposition, lanes, limit.
- Numeric filters: number, startposition, endposition, limit. Other filters are strings.
- Use filter.limit for speed limits; limit controls result count.
- Sort defaults to distance with coordinates, otherwise id. Sorting by distance requires coordinates.
- Order is asc (default) or desc. Result limit defaults to 20; allowed integers are 1 to 100.

RESPONSES

- /address returns one address record with location and distance.
- /geopoint returns an array of address records with location points.
- /object returns an array of {type, location, distance, data}. Distance is omitted without coordinates.
- Empty searches return []; /address returns HTTP 404 when no address is in range.
- Errors use {"error":"message"}: HTTP 400 for invalid parameters and HTTP 500 for database failures.
- Nearby objects do not establish the caller's road or direction. Distance to a line is not driving distance.

ATTRIBUTION

Created by Tekki AS: https://tekki.no
Address data: Kartverket, Matrikkelen Adresse (CC BY 4.0).
https://creativecommons.org/licenses/by/4.0/
Road, camera and speed-limit data: Statens vegvesen, NVDB.
https://www.nvdb.no/
Camera and speed-limit exports: https://nvdb-eksport.atlas.vegvesen.no/
License for camera and speed-limit exports: https://data.norge.no/nlod/no
Gas station data: © OpenStreetMap contributors (ODbL 1.0).
https://opendatacommons.org/licenses/odbl/1-0/