Visualize & map¶
Interactive maps and HTML renders. Requires the [viz] extra. The command-line
entry points (umbra map, gallery, quicklook, view, swipe, change,
timescan, demo) are in the CLI reference; the geocoding helper
below is importable directly.
Resolve a place name to its (bbox, display_name).
bbox is (min_lon, min_lat, max_lon, max_lat) -- the order
:meth:umbra_py.UmbraCatalog.search expects. display_name is
Nominatim's full label for the match (e.g. "California, United States")
so callers can confirm what was resolved.
Raises :class:~umbra_py.exceptions.GeocodeError if the query is empty, the
place can't be found, or the service is unreachable / returns malformed
data.