Searching place and geolocation data with Places (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 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.
The SearchPlaceIndexForText,
SearchPlaceIndexForPosition,
SearchPlaceIndexForSuggestions, and PlaceIndex resources
described below are previous-generation. Use them only for existing
applications.
Amazon Location includes the ability to search the geolocation, or place, data of your chosen provider. There are several kinds of searching available.
-
Geocoding – Geocoding is the process of searching for addresses, regions, business names, or other points of interest, based on text input. It returns details and the location (in latitude and longitude) of the results found.
-
Reverse geocoding – Reverse geocoding allows you to find places near a given location.
-
Autocomplete – Autocomplete is the process of making automatic suggestions as the user types in a query. For example, if they type
Parone suggestion might beParis, France.
Amazon Location lets you choose a data provider for place search operations by creating and configuring a place index resource.
Once you create your resource, you can send requests using the AWS SDK for your preferred language, Amplify, or the REST API endpoints. You can use data from the response to mark locations on a map, enrich position data, and to convert positions into human-readable text.
Note
For an overview of searching place concepts, see Places (V1) concepts.
