feat(outlines): voice outlines without Overpass — bundled US places and neighborhoods, guarded Nominatim, OpenFreeMap streets and buildings

.env.example

@@ -186,3 +186,24 @@ AISSTREAM_API_KEY=
 
 # Optional: comma-separated Overpass URLs; use only instances you run or pay for.
 OVERPASS_UPSTREAMS=
+
+# Optional: place-lookup endpoints. Lookups try bundled data first, then the
+# endpoint set here, or the public service under its usage limits when unset.
+# NOMINATIM_URL: search endpoint for last-resort place search and voice
+# outlines (e.g. https://nominatim.example.org/search). A configured URL
+# replaces the public service: nothing falls back to nominatim.openstreetmap.org,
+# and an invalid value disables Nominatim. Unset uses the public
+# nominatim.openstreetmap.org: one request at a time, 1.1 s apart, a short
+# queue, cached answers (outlines 90 days, places 30 days, no-results 24 h in
+# .gev-cache/nominatim) and a daily cap per install. Set it empty to disable.
+# The public service's limit applies to all installs of this app together; the
+# per-install cap bounds each install, not the total, so heavy or shared
+# deployments should point this at their own server.
+# NOMINATIM_URL=
+# Public-instance requests per UTC day, outlines and search together. Not
+# applied to your own NOMINATIM_URL.
+# NOMINATIM_DAILY_CAP=50
+# PHOTON_URL: keyless place search endpoint used by the browser
+# (e.g. https://photon.example.org/api/). Unset uses photon.komoot.io; set it
+# empty to disable.
+# PHOTON_URL=