Find nærmeste adresse

De adgangsadresser, der ligger nærmest et punkt, sorteret efter afstand i meter.

GEThttps://api.grundfast.dk/v1/adgangsadresser/reverse

Erstatter DAWA’s /adgangsadresser/reverse. Du kan sende lon/lat i WGS84 eller DAWA’s x/y med srid (4326 eller 25832), så en eksisterende DAWA-klient kan beholde sine parametre. Punktet skal ligge i Danmark.

Forskellen fra DAWA: svaret er et objekt { punkt, antal, adresser } i stedet for én adresse, og per_side bestemmer, hvor mange af de nærmeste du får. Standard er 1. Hver adresse har afstand_m og bfe_nummer med, og koordinater er altid WGS84 lon/lat. Ligger ingen adresse inden for radius, er svaret 200 med antal: 0.

Godkendelse · API-nøgle

Send din nøgle som Authorization: Bearer gf_live_… — eller gf_test_… for gratis sandbox-kald. Se Godkendelse og nøgler.

Afregning

Ét kald.

Eksempel

curl "https://api.grundfast.dk/v1/adgangsadresser/reverse?lon=12.5696&lat=55.6757&per_side=3" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · eksempel200json

{
  "punkt": { "lon": 12.5696, "lat": 55.6757 },
  "antal": 3,
  "adresser": [
    {
      "betegnelse": "Rådhuspladsen 1, 1550 København V",
      "adgangsadresse_id": "0a3f507a-ec01-32b8-e044-0003ba298018",
      "bfe_nummer": 6033528,
      "vejnavn": "Rådhuspladsen",
      "husnr": "1",
      "postnr": "1550",
      "postnrnavn": "København V",
      "kommunekode": "0101",
      "koordinat": { "lon": 12.5695777, "lat": 55.6756275 },
      "afstand_m": 8
    },
    {
      "betegnelse": "Vester Voldgade 72, 1552 København V",
      "adgangsadresse_id": "74806df4-97a9-4c0c-a6cb-df07b5429e07",
      "bfe_nummer": 6033528,
      "vejnavn": "Vester Voldgade",
      "husnr": "72",
      "postnr": "1552",
      "postnrnavn": "København V",
      "kommunekode": "0101",
      "koordinat": { "lon": 12.5700489, "lat": 55.6757814 },
      "afstand_m": 30
    },
    {
      "betegnelse": "H.C. Andersens Boulevard 21A, 1553 København V",
      "adgangsadresse_id": "200e295b-228d-45fc-9928-5415de152140",
      "bfe_nummer": 6033528,
      "vejnavn": "H.C. Andersens Boulevard",
      "husnr": "21A",
      "postnr": "1553",
      "postnrnavn": "København V",
      "kommunekode": "0101",
      "koordinat": { "lon": 12.5693531, "lat": 55.6753475 },
      "afstand_m": 42
    }
  ],
  "meta": {
    "kilde": "Datafordeler DAR via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

Parametre

lonnumberqueryvalgfri: Længdegrad i WGS84. Påkrævet sammen med lat, medmindre du sender x/y.Eksempel: 12.5696
latnumberqueryvalgfri: Breddegrad i WGS84. Påkrævet sammen med lon, medmindre du sender x/y.Eksempel: 55.6757
xnumberqueryvalgfri: DAWA-stil: længdegrad (srid 4326) eller easting i meter (srid 25832). Bruges sammen med y.
ynumberqueryvalgfri: DAWA-stil: breddegrad (srid 4326) eller northing i meter (srid 25832). Bruges sammen med x.
sridstringqueryvalgfri: Koordinatsystemet for x/y og for svaret: 4326 (WGS84) eller 25832 (UTM32N). Når den er sat, får hver adresse også koordinater i det system.Standard:4326Værdier:432625832
formatstringqueryvalgfri: geojson giver en FeatureCollection med ét punkt pr. adresse i stedet for JSON-objektet.Standard:jsonVærdier:jsongeojson
radiusintegerqueryvalgfri: Søgeradius i meter, højst 1000. En tom eller ikke-positiv værdi giver standarden.Standard:200
per_sideintegerqueryvalgfri: Hvor mange af de nærmeste adresser du vil have, højst 20.Standard:1Eksempel: 3

Felter i svaret

adresser[].afstand_minteger: Afstand i hele meter fra punktet til adgangspunktet. Listen er sorteret stigende.
adresser[].adgangsadresse_idstring (UUID): DAR-husnummerets UUID — samme id som DAWA’s adgangsadresse-id.
adresser[].bfe_nummerinteger | null: BFE på det jordstykke, adgangspunktet ligger på — nøglen videre til BBR og Matriklen.
punkt{ lon, lat }: Det punkt, der blev søgt fra, i WGS84 — også når du sendte x/y i UTM32N.

Statuskoder

Status	Betydning
200	Svaret er leveret.
400	Hverken `lon`/`lat` eller `x`/`y` er sat, værdierne er ikke tal, `srid` er andet end 4326 eller 25832, eller punktet ligger uden for Danmark.
401	Nøglen mangler eller er ugyldig.
429	Burst-grænsen eller månedskvoten er nået. Se `Retry-After`.
503	Adresseindekset er ikke slået til eller endnu ikke indlæst i dette miljø.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

Prøv det

Live-kald fra siden

Kræver din nøgle

Bruges ofte sammen med

Læs mere om DAWA-kompatibel, og hvad data kan bruges til, på produktsiden.

curl "https://api.grundfast.dk/v1/adgangsadresser/reverse?lon=12.5696&lat=55.6757&per_side=3" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · eksempel200json

{
  "punkt": { "lon": 12.5696, "lat": 55.6757 },
  "antal": 3,
  "adresser": [
    {
      "betegnelse": "Rådhuspladsen 1, 1550 København V",
      "adgangsadresse_id": "0a3f507a-ec01-32b8-e044-0003ba298018",
      "bfe_nummer": 6033528,
      "vejnavn": "Rådhuspladsen",
      "husnr": "1",
      "postnr": "1550",
      "postnrnavn": "København V",
      "kommunekode": "0101",
      "koordinat": { "lon": 12.5695777, "lat": 55.6756275 },
      "afstand_m": 8
    },
    {
      "betegnelse": "Vester Voldgade 72, 1552 København V",
      "adgangsadresse_id": "74806df4-97a9-4c0c-a6cb-df07b5429e07",
      "bfe_nummer": 6033528,
      "vejnavn": "Vester Voldgade",
      "husnr": "72",
      "postnr": "1552",
      "postnrnavn": "København V",
      "kommunekode": "0101",
      "koordinat": { "lon": 12.5700489, "lat": 55.6757814 },
      "afstand_m": 30
    },
    {
      "betegnelse": "H.C. Andersens Boulevard 21A, 1553 København V",
      "adgangsadresse_id": "200e295b-228d-45fc-9928-5415de152140",
      "bfe_nummer": 6033528,
      "vejnavn": "H.C. Andersens Boulevard",
      "husnr": "21A",
      "postnr": "1553",
      "postnrnavn": "København V",
      "kommunekode": "0101",
      "koordinat": { "lon": 12.5693531, "lat": 55.6753475 },
      "afstand_m": 42
    }
  ],
  "meta": {
    "kilde": "Datafordeler DAR via Grundfast",
    "grundfast_version": "0.1.0"
  }
}