Geocoder

Run the following command to install the `geocoder` components:

Nominatim's display_name is the complete administrative hierarchy, which is rarely what you want to show:

By default the geocoder requests addressdetails=1 and assembles a compact address from the structured fields instead — street, settlement and country only. Set format="full" to go back to the raw string, or pass a function for anything else.

Address layout differs by country along two axes: whether the house number comes before or after the street, and whether the postcode comes before or after the city. Each result is ordered using its own country_code, so a mixed result list stays correct.

Countries that are not mapped fall back to anglo. Pass convention to force one layout everywhere regardless of the result's country.

Pass a locationSnippet to take over the markup of each result. The formatAddress helper is exported, so you can still reuse the label logic — here it builds a two line entry with the street on top and the country muted underneath.

The default provider is the public Nominatim instance, whose usage policy asks for an identifying User-Agent or Referer, caps requests at one per second and forbids heavy use. For anything beyond light traffic, proxy the request through your own backend or run your own Nominatim instance.