# Find nærmeste adresse

`GET /v1/adgangsadresser/reverse` · DAWA-kompatibel

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

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:** `Authorization: Bearer gf_live_…` (eller `gf_test_…`)

**Afregning:** Ét kald.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `lon` | query | number | nej | Længdegrad i WGS84. Påkrævet sammen med `lat`, medmindre du sender `x`/`y`. |
| `lat` | query | number | nej | Breddegrad i WGS84. Påkrævet sammen med `lon`, medmindre du sender `x`/`y`. |
| `x` | query | number | nej | DAWA-stil: længdegrad (srid 4326) eller easting i meter (srid 25832). Bruges sammen med `y`. |
| `y` | query | number | nej | DAWA-stil: breddegrad (srid 4326) eller northing i meter (srid 25832). Bruges sammen med `x`. |
| `srid` | query | string | nej | 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. |
| `format` | query | string | nej | `geojson` giver en FeatureCollection med ét punkt pr. adresse i stedet for JSON-objektet. |
| `radius` | query | integer | nej | Søgeradius i meter, højst 1000. En tom eller ikke-positiv værdi giver standarden. |
| `per_side` | query | integer | nej | Hvor mange af de nærmeste adresser du vil have, højst 20. |

## Eksempel

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

## Svar (200)

```json
{
  "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"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `adresser[].afstand_m` | integer | Afstand i hele meter fra punktet til adgangspunktet. Listen er sorteret stigende. |
| `adresser[].adgangsadresse_id` | string (UUID) | DAR-husnummerets UUID — samme id som DAWA’s adgangsadresse-`id`. |
| `adresser[].bfe_nummer` | integer \| 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. |

## Fejl

| Status | Betydning |
| --- | --- |
| 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ø. |