AWS location: Adds Places API V1 deprecation notice and updates API links
Summary
Adds an Important notice that this page documents the previous Places API (V1), introduces the V2 `geo-places` operations, and repoints API reference links from `location-places/latest` to `location/previous`.
Security assessment
Purely editorial API versioning/deprecation guidance and link updates; no mention of vulnerabilities, credentials, encryption, or access control.
Evidence
+**This page documents the previous Places API (V1). Use it only for existing applications.** The Places V2 API is the latest version. Use it for all new applications; see the latest [Amazon Location Service Places](https://docs.aws.amazon.com/location/latest/developerguide/places.html) developer guide.
Diff
diff --git a/location/previous/developerguide/managing-place-indexes.md b/location/previous/developerguide/managing-place-indexes.md index 90706e0cf..57371e80e 100644 --- a//location/previous/developerguide/managing-place-indexes.md +++ b//location/previous/developerguide/managing-place-indexes.md @@ -9 +9,9 @@ List your place index resourcesGet place index resource detailsDelete a place in -# Managing your place index resources with Amazon Location +# Managing your place index resources (V1) + +###### Important + +**This page documents the previous Places API (V1). Use it only for existing applications.** The Places V2 API is the latest version. Use it for all new applications; see the latest [Amazon Location Service Places](https://docs.aws.amazon.com/location/latest/developerguide/places.html) developer guide. + +The latest API calls `Geocode`, `ReverseGeocode`, `SearchText`, `SearchNearby`, `Suggest`, `Autocomplete`, and `GetPlace` directly. These operations are under the `geo-places` namespace. They are exposed as `@aws-sdk/client-geo-places` for JavaScript and `boto3.client('geo-places')` for Python. + +There is no `PlaceIndex` resource to create, describe, or delete. @@ -34 +42 @@ API -Use the `[ListPlaceIndexes](https://docs.aws.amazon.com/location-places/latest/APIReference/API_ListPlaceIndexes.html)` operation from the Amazon Location Places APIs. +Use the `[ListPlaceIndexes](https://docs.aws.amazon.com/location/previous/APIReference/API_ListPlaceIndexes.html)` operation from the Amazon Location Places APIs. @@ -41 +49 @@ The following example is an API request to get a list of place index resources i -The following is an example response for `[ListPlaceIndexes](https://docs.aws.amazon.com/location-places/latest/APIReference/API_ListPlaceIndexes.html)`: +The following is an example response for `[ListPlaceIndexes](https://docs.aws.amazon.com/location/previous/APIReference/API_ListPlaceIndexes.html)`: @@ -88 +96 @@ API -Use the `[DescribePlaceIndex](https://docs.aws.amazon.com/location-places/latest/APIReference/API_DescribePlaceIndex.html)` operation from the Amazon Location Place APIs. +Use the `[DescribePlaceIndex](https://docs.aws.amazon.com/location/previous/APIReference/API_DescribePlaceIndex.html)` operation from the Amazon Location Place APIs. @@ -95 +103 @@ The following example is an API request to get the place index resource details -The following is an example response for `[DescribePlaceIndex](https://docs.aws.amazon.com/location-places/latest/APIReference/API_DescribePlaceIndex.html)`: +The following is an example response for `[DescribePlaceIndex](https://docs.aws.amazon.com/location/previous/APIReference/API_DescribePlaceIndex.html)`: @@ -151 +159 @@ API -Use the `[DeletePlaceIndex](https://docs.aws.amazon.com/location-places/latest/APIReference/API_DeletePlaceIndex.html)` operation from the Amazon Location Places APIs. +Use the `[DeletePlaceIndex](https://docs.aws.amazon.com/location/previous/APIReference/API_DeletePlaceIndex.html)` operation from the Amazon Location Places APIs. @@ -158 +166 @@ The following example is an API request to delete the place index resource `Exam -The following is an example success response for `[DeletePlaceIndex](https://docs.aws.amazon.com/location-places/latest/APIReference/API_DeletePlaceIndex.html)`: +The following is an example success response for `[DeletePlaceIndex](https://docs.aws.amazon.com/location/previous/APIReference/API_DeletePlaceIndex.html)`: @@ -182 +190 @@ Tutorial: Database enrichment -Calculating routes +Calculating routes (V1)