> ## Documentation Index
> Fetch the complete documentation index at: https://docs-attestly.code4source.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /v1/distance

> Encontra feições de referência mais próximas dentro de um raio.

Endpoint de descoberta para queries de proximidade. Envie um
polígono (ou ponto) e uma janela
`[min_distance_m, max_distance_m]`; receba as feições dentro desse
anel, ordenadas por distância crescente.

## Request

```json theme={null}
{
  "input": {
    "geometry": { "type": "Point", "coordinates": [-59.5, -2.5] },
    "min_distance_m": 0,
    "max_distance_m": 5000
  },
  "reference_areas_source": "icmbio_ucs_federais",
  "reference_areas_country_iso3": "BRA"
}
```

| Campo                          | Obrigatório | Notas                                  |
| ------------------------------ | ----------- | -------------------------------------- |
| `input.geometry`               | sim         | GeoJSON.                               |
| `input.max_distance_m`         | sim         | Limite superior inclusivo, em metros.  |
| `input.min_distance_m`         | não         | Limite inferior inclusivo. Default: 0. |
| `input.crs`                    | não         | CRS de origem. Default: `EPSG:4326`.   |
| `reference_areas_source`       | não         | Restringe a um source.                 |
| `reference_areas_country_iso3` | não         | Filtra sources por país.               |

## Response

```json theme={null}
{
  "data": {
    "hits": [
      {
        "reference_area": {
          "source_name": "icmbio_ucs_federais",
          "source_id": "uc-042",
          "name": "Parque Nacional da Amazônia",
          "country_iso3": "BRA",
          "properties": { }
        },
        "distance_m": 423.7
      }
    ],
    "reference_areas_check": "ok"
  }
}
```

`hits` são ordenados por `distance_m` crescente. Distâncias são
elipsoidais (WGS84) em metros.