@aws-sdk/client-location 3.41.0 → 3.46.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/CHANGELOG.md +47 -0
  2. package/dist-cjs/Location.js +15 -0
  3. package/dist-cjs/commands/SearchPlaceIndexForSuggestionsCommand.js +36 -0
  4. package/dist-cjs/commands/index.js +1 -0
  5. package/dist-cjs/endpoints.js +1 -0
  6. package/dist-cjs/models/models_0.js +50 -3
  7. package/dist-cjs/protocols/Aws_restJson1.js +244 -2
  8. package/dist-cjs/runtimeConfig.js +0 -2
  9. package/dist-es/Location.js +15 -0
  10. package/dist-es/commands/SearchPlaceIndexForSuggestionsCommand.js +39 -0
  11. package/dist-es/commands/index.js +1 -0
  12. package/dist-es/endpoints.js +1 -0
  13. package/dist-es/models/models_0.js +28 -4
  14. package/dist-es/protocols/Aws_restJson1.js +253 -6
  15. package/dist-es/runtimeConfig.js +0 -2
  16. package/dist-types/Location.d.ts +40 -10
  17. package/dist-types/LocationClient.d.ts +3 -2
  18. package/dist-types/commands/BatchEvaluateGeofencesCommand.d.ts +4 -0
  19. package/dist-types/commands/BatchUpdateDevicePositionCommand.d.ts +11 -3
  20. package/dist-types/commands/CalculateRouteCommand.d.ts +2 -3
  21. package/dist-types/commands/CreatePlaceIndexCommand.d.ts +4 -2
  22. package/dist-types/commands/SearchPlaceIndexForSuggestionsCommand.d.ts +44 -0
  23. package/dist-types/commands/SearchPlaceIndexForTextCommand.d.ts +3 -2
  24. package/dist-types/commands/index.d.ts +1 -0
  25. package/dist-types/models/models_0.d.ts +488 -117
  26. package/dist-types/protocols/Aws_restJson1.d.ts +3 -0
  27. package/dist-types/ts3.4/Location.d.ts +5 -0
  28. package/dist-types/ts3.4/LocationClient.d.ts +3 -2
  29. package/dist-types/ts3.4/commands/SearchPlaceIndexForSuggestionsCommand.d.ts +17 -0
  30. package/dist-types/ts3.4/commands/index.d.ts +1 -0
  31. package/dist-types/ts3.4/models/models_0.d.ts +128 -6
  32. package/dist-types/ts3.4/protocols/Aws_restJson1.d.ts +3 -0
  33. package/package.json +36 -43
@@ -7,8 +7,10 @@ export interface CreatePlaceIndexCommandInput extends CreatePlaceIndexRequest {
7
7
  export interface CreatePlaceIndexCommandOutput extends CreatePlaceIndexResponse, __MetadataBearer {
8
8
  }
9
9
  /**
10
- * <p>Creates a place index resource in your AWS account, which supports functions with
11
- * geospatial data sourced from your chosen data provider.</p>
10
+ * <p>Creates a place index resource in your AWS account. Use a place index resource to
11
+ * geocode addresses and other text queries by using the <code>SearchPlaceIndexForText</code> operation,
12
+ * and reverse geocode coordinates by using the <code>SearchPlaceIndexForPosition</code> operation, and
13
+ * enable autosuggestions by using the <code>SearchPlaceIndexForSuggestions</code> operation.</p>
12
14
  * @example
13
15
  * Use a bare-bones client and the command you need to make an API call.
14
16
  * ```javascript
@@ -0,0 +1,44 @@
1
+ import { Command as $Command } from "@aws-sdk/smithy-client";
2
+ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
3
+ import { LocationClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../LocationClient";
4
+ import { SearchPlaceIndexForSuggestionsRequest, SearchPlaceIndexForSuggestionsResponse } from "../models/models_0";
5
+ export interface SearchPlaceIndexForSuggestionsCommandInput extends SearchPlaceIndexForSuggestionsRequest {
6
+ }
7
+ export interface SearchPlaceIndexForSuggestionsCommandOutput extends SearchPlaceIndexForSuggestionsResponse, __MetadataBearer {
8
+ }
9
+ /**
10
+ * <p>Generates suggestions for addresses and points of interest based on partial or
11
+ * misspelled free-form text. This operation is also known as autocomplete, autosuggest,
12
+ * or fuzzy matching.</p>
13
+ * <p>Optional parameters let you narrow your search results by bounding box or
14
+ * country, or bias your search toward a specific position on the globe.</p>
15
+ * <note>
16
+ * <p>You can search for suggested place names near a specified position by using <code>BiasPosition</code>, or
17
+ * filter results within a bounding box by using <code>FilterBBox</code>. These parameters are mutually exclusive;
18
+ * using both <code>BiasPosition</code> and <code>FilterBBox</code> in the same command returns an error.</p>
19
+ * </note>
20
+ * @example
21
+ * Use a bare-bones client and the command you need to make an API call.
22
+ * ```javascript
23
+ * import { LocationClient, SearchPlaceIndexForSuggestionsCommand } from "@aws-sdk/client-location"; // ES Modules import
24
+ * // const { LocationClient, SearchPlaceIndexForSuggestionsCommand } = require("@aws-sdk/client-location"); // CommonJS import
25
+ * const client = new LocationClient(config);
26
+ * const command = new SearchPlaceIndexForSuggestionsCommand(input);
27
+ * const response = await client.send(command);
28
+ * ```
29
+ *
30
+ * @see {@link SearchPlaceIndexForSuggestionsCommandInput} for command's `input` shape.
31
+ * @see {@link SearchPlaceIndexForSuggestionsCommandOutput} for command's `response` shape.
32
+ * @see {@link LocationClientResolvedConfig | config} for LocationClient's `config` shape.
33
+ *
34
+ */
35
+ export declare class SearchPlaceIndexForSuggestionsCommand extends $Command<SearchPlaceIndexForSuggestionsCommandInput, SearchPlaceIndexForSuggestionsCommandOutput, LocationClientResolvedConfig> {
36
+ readonly input: SearchPlaceIndexForSuggestionsCommandInput;
37
+ constructor(input: SearchPlaceIndexForSuggestionsCommandInput);
38
+ /**
39
+ * @internal
40
+ */
41
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: LocationClientResolvedConfig, options?: __HttpHandlerOptions): Handler<SearchPlaceIndexForSuggestionsCommandInput, SearchPlaceIndexForSuggestionsCommandOutput>;
42
+ private serialize;
43
+ private deserialize;
44
+ }
@@ -9,13 +9,14 @@ export interface SearchPlaceIndexForTextCommandOutput extends SearchPlaceIndexFo
9
9
  /**
10
10
  * <p>Geocodes free-form text, such as an address, name, city, or region to allow you to
11
11
  * search for Places or points of interest. </p>
12
- * <p>Includes the option to apply additional parameters to narrow your list of
13
- * results.</p>
12
+ * <p>Optional parameters let you narrow your search results by bounding box or
13
+ * country, or bias your search toward a specific position on the globe.</p>
14
14
  * <note>
15
15
  * <p>You can search for places near a given position using <code>BiasPosition</code>, or
16
16
  * filter results within a bounding box using <code>FilterBBox</code>. Providing both
17
17
  * parameters simultaneously returns an error.</p>
18
18
  * </note>
19
+ * <p>Search results are returned in order of highest to lowest relevance.</p>
19
20
  * @example
20
21
  * Use a bare-bones client and the command you need to make an API call.
21
22
  * ```javascript
@@ -40,6 +40,7 @@ export * from "./ListTrackerConsumersCommand";
40
40
  export * from "./ListTrackersCommand";
41
41
  export * from "./PutGeofenceCommand";
42
42
  export * from "./SearchPlaceIndexForPositionCommand";
43
+ export * from "./SearchPlaceIndexForSuggestionsCommand";
43
44
  export * from "./SearchPlaceIndexForTextCommand";
44
45
  export * from "./TagResourceCommand";
45
46
  export * from "./UntagResourceCommand";