# Map Radius Facet

> Radius choice control for map address proximity facets.

# Map Radius Facet

`Map Radius Facet` is an atomic choice control for proximity distance. It does not emit a facet clause by itself. The same-target [Map Address Facet](/facets/component-families/map-address-facet) combines the selected address coordinate and selected radius into `geo_radius`.

## Required Setup

- Use the same target ID on `Map Radius Facet`, [Map Address Facet](/facets/component-families/map-address-facet), [Map Facet](/facets/component-families/map-facet), and [Facet Target](/facets/component-families/facet-target).
- Add `Map Radius Facet Option` children with numeric radius values.
- Choose `Miles` or `Kilometers`; option values are interpreted in that unit.
- Set matching latitude and longitude meta keys on the address and map components.

## Props

| Group    | Prop            | Default | Meaning                                                        |
| -------- | --------------- | ------- | -------------------------------------------------------------- |
| Settings | `target`        | empty   | Shared target ID.                                              |
| Settings | `unit`          | `mi`    | Interprets option values as miles (`mi`) or kilometers (`km`). |
| Settings | `default_value` | empty   | Radius selected on load/reset.                                 |

Option labels are authored manually. Use labels like `25 miles`, `40 km`, or any wording that fits the site.

## Runtime Behavior

Selecting a radius does not filter by itself. When a same-target address is selected, the address and radius controls emit `geo_radius` with the selected latitude, longitude, radius value, and unit. The paired map centers on the selected address, fits the selected radius, and draws the radius circle.

The public `ome:map-radius-change` event exposes a numeric radius snapshot or `null`. Its payload and its relationship to the same-target Map Address event are documented in the [Facet Events API](/facets/custom-events).

### Select dropdown floats

In select mode, the radius dropdown floats over the page via Etch's shared UIChoice host (the same floating mechanism used by the Select Facet). It no longer pushes page layout down when opened.