Skip to main content

Map Address Facet

Map Address Facet lets visitors search an address or ZIP code through the OME LocationIQ proxy. It stores the selected label, latitude, longitude, and provider ID on the component root, then combines with a same-target Map Radius Facet to emit a geo_radius value.

Required Setup

  • Configure a LocationIQ token in OME settings.
  • Store latitude and longitude meta on each result post.
  • Use the same target ID on Map Address Facet, Map Radius Facet, Map Facet, and Facet Target.
  • Set matching latitude and longitude meta keys on the address and map components.

Props

GroupPropDefaultMeaning
SettingstargetemptyShared target ID.
SettingsplaceholderSearch address...Placeholder text shown inside the address input.
Settingsminimum_query_length3Number of characters required before lookup starts.
Settingsdebounce_ms300Delay before address lookup requests are sent.
Querylat_meta_keylatitudeMeta key used for result latitude values.
Querylng_meta_keylongitudeMeta key used for result longitude values.
Stylingclassome-map-address-facet-defaultRoot wrapper class.

Runtime Behavior

Typing opens geocode suggestions. Selecting a suggestion filters the target when a radius is selected, centers the paired map, fits the selected radius, and draws the radius circle. Clearing the address clears the radius filter and removes the map circle.