Vepler logo
v2.168.0

Street-level results on search suggest

Search suggest can now return one result per named street, with a representative coordinate, USRN, bounding box and property count, via a new granularity parameter.

Added

  • GET /v1/search/suggest accepts a new optional granularity query parameter, one of address (the default) or street. With granularity=street, the endpoint resolves a partial query to one result per named street instead of individual premises, and the existing lat, lng and radius_meters parameters, together with the town in the query, disambiguate streets that share a name.
  • A street result has type street and carries a representative centre location (lat and lng), a stable id of the form gb-usrn:<usrn>, and a metadata block with granularity, precision, country, usrn, boundingBox, propertyCount and confidence. Each response also includes a recommendationCode of A to accept or I to inspect.

Changed

  • The suggest result schema is now country-portable: results are keyed on the generic id and carry a country code, and usrn is optional, so key on id rather than usrn.

Affected endpoints