Suggest

Source: src/AWS/GeoPlaces/Suggest.ts

Runtime binding for geo-places:Suggest — suggest places and query refinements for a free-form (possibly misspelled or partial) query, ranked by relevance. Unlike Autocomplete, Suggest returns place suggestions (with PlaceIds) and query suggestions, tuned for point-of-interest discovery.

geo-places is a standalone, pay-per-call Amazon Location API with no resource to manage: the binding takes no arguments and grants the function geo-places:Suggest. Requests and responses are raw distilled types (no marshalling).

Suggesting Places

Provide the SuggestHttp implementation layer on the Function effect (.pipe(Effect.provide(AWS.GeoPlaces.SuggestHttp))), bind in the init phase, then call the client at runtime.

// init
const suggest = yield* AWS.GeoPlaces.Suggest();

// runtime
const result = yield* suggest({
  QueryText: "coffee",
  BiasPosition: [-122.3493, 47.6205], // [lng, lat]
  MaxResults: 5,
});
const first = result.ResultItems?.[0]?.Title;