AWS location: Mark Places search page as V1 and point to V2 API
Summary
Changes the heading to 'Places (V1)', replaces the note with an Important deprecation notice listing the new geo-places operations, and updates related link labels to (V1).
Security assessment
Documentation-only deprecation/versioning update; no security-relevant content.
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/searching-for-places.md b/location/previous/developerguide/searching-for-places.md index f6ac31c59..a1aefd623 100644 --- a//location/previous/developerguide/searching-for-places.md +++ b//location/previous/developerguide/searching-for-places.md @@ -7 +7 @@ -# Searching place and geolocation data using Amazon Location +# Searching place and geolocation data with Places (V1) @@ -9 +9,5 @@ -###### Note +###### 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 operations are `Geocode`, `ReverseGeocode`, `SearchText`, `SearchNearby`, `Suggest`, `Autocomplete`, and `GetPlace`. 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. @@ -11 +15 @@ -We released a new version of the Places API, see the updated [Places Developer Guide](https://docs.aws.amazon.com/location/latest/developerguide/places.html) or [Places API](https://docs.aws.amazon.com/location/latest/APIReference/API_Operations_Amazon_Location_Service_Places_V2.html) for revised information. +The `SearchPlaceIndexForText`, `SearchPlaceIndexForPosition`, `SearchPlaceIndexForSuggestions`, and `PlaceIndex` resources described below are previous-generation. Use them only for existing applications. @@ -30 +34 @@ Once you create your resource, you can send requests using the AWS SDK for your -For an overview of searching place concepts, see [Learn about Places search in Amazon Location Service](./places-concepts.html). +For an overview of searching place concepts, see [Places (V1) concepts](./places-concepts.html). @@ -48 +52 @@ For an overview of searching place concepts, see [Learn about Places search in A - * [Managing your place index resources with Amazon Location](./managing-place-indexes.html) + * [Managing your place index resources (V1)](./managing-place-indexes.html) @@ -59 +63 @@ To use the Amazon Web Services Documentation, Javascript must be enabled. Please -Managing map resources +Managing map resources (V1)