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
| Group | Prop | Default | Meaning |
|---|---|---|---|
| Settings | target | empty | Shared target ID. |
| Settings | placeholder | Search address... | Placeholder text shown inside the address input. |
| Settings | minimum_query_length | 3 | Number of characters required before lookup starts. |
| Settings | debounce_ms | 300 | Delay before address lookup requests are sent. |
| Query | lat_meta_key | latitude | Meta key used for result latitude values. |
| Query | lng_meta_key | longitude | Meta key used for result longitude values. |
| Styling | class | ome-map-address-facet-default | Root 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.