explore

Explore Search

Corpus-wide place search (CORPUS_SEARCH_DESIGN.md §4.2). lat/lng bias to a ~50km box with auto-widen.

mode defaults to the shipping product one: hybrid, so a client that sends q/limit/sid only (all of them do) gets the BM25 + ANN fusion. It is ungated — the admin preview's eval toggle picks bm25/semantic, and neither costs more embedding budget than the default already spends.

preview stays admin-only — it marks a serve as excluded from training data, so honouring it from arbitrary callers would let real user searches opt themselves out. Coerced rather than 400'd: it is absent from every shipping client's query string, so a request carrying it is hand-rolled, not a client that needs an error.

get/explore/search

Query parameters

qstring required
latnumber nullable
lngnumber nullable
labelstring nullable
limitinteger
previewboolean
mode'bm25' | 'semantic' | 'hybrid'
sidstring nullable

Headers

x-client-buildstring nullable

Response

Successful Response

request_idstring required
anchor_labelstring nullable
next_offsetinteger nullable
titlestring nullable
rail_kind'bridge' nullable
cluster_indexinteger nullable

Changes