Skip to main content

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 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, Map Facet, and 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​

GroupPropDefaultMeaning
SettingstargetemptyShared target ID.
SettingsunitmiInterprets option values as miles (mi) or kilometers (km).
Settingsdefault_valueemptyRadius 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.

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.