Hvilke adresser ligger tæt på et punkt — eller inden for et område?

Tre spørgsmål, tre opslag

Alle tre giver adgangsadresser — huse og opgange. Skal du have de enkelte boliger med etage og dør, så brug /v1/adresser med samme cirkel eller polygon. Hvert kald og hver side tæller som ét kald.

De nærmeste adresser

Reverse-opslaget tager et punkt og giver de adresser, der ligger tættest på, med afstanden i meter. Som standard får du den ene nærmeste inden for 200 m. Med per_side beder du om flere, op til 20, og med radius udvider du søgningen til højst 1.000 m.

{
1  "punkt": { "lon": 12.5683, "lat": 55.6761 },
2  "antal": 3,
  "adresser": [
    {
      "betegnelse": "Rådhuspladsen 3, 1550 København V",
      "adgangsadresse_id": "0a3f507a-ec03-32b8-e044-0003ba298018",
4      "bfe_nummer": 100058855,
      "koordinat": { "lon": 12.568236, "lat": 55.67611 },
3      "afstand_m": 4,
      "…": "…"
    },
    {
      "betegnelse": "Rådhuspladsen 5, 1550 København V",
3      "afstand_m": 19,
      "…": "…"
    },
    {
      "betegnelse": "Rådhuspladsen 7, 1550 København V",
3      "afstand_m": 33,
      "…": "…"
    }
  ]
}

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

Har du mange punkter, så se Nærmeste adresse for mange punkter.

Alle adresser inden for en radius

Skal du have alle adresser i en afstand — ikke kun de 20 nærmeste — så brug listen med cirkel=x,y,radius. Radius er i meter, højst 10.000. Listen er sorteret efter vejnavn og husnummer, ikke efter afstand, så har du brug for afstanden, må du regne den ud fra koordinat selv. Filtrene kan kombineres: cirkel sammen med postnr giver kun adresserne i cirklen med det postnummer.

curl -G "https://api.grundfast.dk/v1/adgangsadresser" \
  --data-urlencode "cirkel=10.2107,56.1572,250" \
  --data-urlencode "per_side=1000" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svaret er { antal, side, per_side, srid, adgangsadresser }. antal er antallet på denne side, ikke det samlede antal. Der er en grænse for, hvor dybt du kan side: side × per_side må højst være 50.000. Rammer du den, så gør området mindre eller tilføj et filter.

Alle adresser inden for et område

polygon tager et JSON-array af ringe: den første er yderkanten, de næste er huller. En enkelt ring uden det yderste array accepteres også, og en ring, der ikke er lukket, bliver lukket for dig. Hver ring skal have mindst tre hjørner, alle ringe tilsammen højst 1.000, og polygonens udstrækning må højst være 0,3 breddegrader og 0,5 længdegrader — omkring 33 × 31 km. Send cirkel eller polygon, ikke begge.

Der findes ingen bbox-parameter på adresselisterne. Et kortudsnit skrives som et polygon med fire hjørner:

curl -G "https://api.grundfast.dk/v1/adgangsadresser" \
  --data-urlencode "polygon=[[[12.565,55.674],[12.575,55.674],[12.575,55.678],[12.565,55.678],[12.565,55.674]]]" \
  --data-urlencode "per_side=1000" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Koordinatsystem og rækkefølge

srid gælder både det, du sender, og det, du får: 4326 (WGS84, standard) eller 25832 (UTM32, meter). Rækkefølgen er altid x før y — længdegrad før breddegrad i WGS84, øst før nord i UTM32. Byttes de om, havner punktet uden for Danmark, og svaret er 400 med “x/y outside Denmark”. Sender du UTM32-meter uden srid=25832, siger svaret også det.

• koordinater på hvert hit er adressepunktet i det srid, du bad om: [lon, lat] eller [x, y] i meter.
• koordinat er altid WGS84 { lon, lat }, uanset srid — så kode, der kun kender WGS84, virker uændret.
• Med srid=25832 er radius og afstand stadig meter, og cirklens centrum skrives i meter: cirkel=724434,6175755,250.

Mere om de to systemer og omregning mellem dem står i Koordinater.

Direkte på et kort: GeoJSON

Med format=geojson er svaret en FeatureCollection med ét punkt pr. adresse. Felterne fra JSON-svaret ligger i properties, og punktet i geometry er i det srid, du bad om. Ved srid=25832 har samlingen crs sat, fordi GeoJSON ellers betyder WGS84. Det virker både på listerne og på reverse-opslaget.

curl -G "https://api.grundfast.dk/v1/adresser" \
  --data-urlencode "cirkel=10.2107,56.1572,100" \
  --data-urlencode "format=geojson" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY" > boliger.geojson

GeoJSON-svaret har ingen antal eller side. Side igennem på samme måde: en side med færre features end per_side er den sidste.

Det, der ikke findes

• Ingen bbox-parameter på adresselisterne. Brug et polygon som ovenfor.
• Ikke flere end 20 nærmeste. Skal du have flere, så hent alle i en cirkel og sortér selv efter afstand.
• Ingen sortering efter afstand på listerne. Kun reverse-opslaget sorterer efter afstand.
• Kun Danmark. Et punkt eller et hjørne uden for landet giver 400.