Sign in
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

Changed in 2 of the 22 revisions of this API.13

  • 6ea7213160811See the full diff
    • ▲

      for the query request parameter mode, default value was changed from bm25 to hybrid

      request-parameter-default-value-changed

  • eb694aedc5553See the full diff
    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added