Merge remote-tracking branch 'upstream/main' into fix/houston-cctv-pack

.env.example

@@ -268,6 +268,32 @@ 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. Nominatim stays off unless NOMINATIM_URL is set; Photon
+# uses its public service when PHOTON_URL is unset.
+# NOMINATIM_URL: search endpoint for last-resort place search and voice
+# outlines (e.g. https://nominatim.example.org/search). A configured URL
+# selects the endpoint explicitly. Unset, empty and invalid values disable
+# Nominatim; nothing falls back to nominatim.openstreetmap.org. Use an endpoint
+# you operate or are authorized to use. Answers are cached (outlines 90 days,
+# places 30 days, no-results 24 h in .gev-cache/nominatim).
+# Explicit public-service configuration retains per-install pacing and caps;
+# these do not establish an application-wide allowance or authorize public use.
+# NOMINATIM_URL=
+# Public-instance requests per UTC day, outlines and search together. Not
+# applied to your own NOMINATIM_URL.
+# NOMINATIM_DAILY_CAP=50
+# Public-instance pacing is shared through .gev-cache/nominatim/state.json. If
+# the server stopped mid-request (or its disk filled), it leaves a
+# state.json.dispatch.* marker and refuses public lookups ("unfinished durable
+# Nominatim dispatch") for ten minutes rather than risk breaking the spacing;
+# the next lookup after that removes the marker and resumes with fresh spacing.
+# 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. Only https endpoints are accepted (the page's
+# Content-Security-Policy allows no plain-http origin); any other value disables it.
+# PHOTON_URL=
+
 # Optional: who may frame the app in embed mode (?embed=1), as CSP
 # frame-ancestors sources such as "https://example.com", or * for any page.
 # Unset, no page may frame it. Other pages of the app can never be framed.