Reverse geocoding
Reverse geocoding is a process that converts a set of coordinates into meaningful text, such as an address, a region, a business name, or point of interest. You can use place index resources to submit reverse geocoding requests and incorporate data retrieved from reverse geocoding to display data on a map for your web or mobile application.
This section guides you through how to send a simple reverse geocoding request.
Reverse geocoding
You can submit a simple request to reverse geocode a set of coordinates and
convert them to a meaningful address, a point of interest or a general location
without an address using the SearchPlaceIndexForPosition operation. A simple request
contains the following required parameter:
-
Position– A set of coordinates that you want to convert to an address, point of interest, or general location. Defined using the format[longitude,latitude].
To specify a maximum number of results per pages, add the following optional parameter:
-
MaxResults– Limits the maximum number of results returned in the query response.
If you want to specify a preferred language for the results of your query, use the following optional parameter:
-
Language– A language code to be used for rendering results. The value must be a valid BCP 47language code. For example, enfor English.
Note
If Language is not specified, or the specified language is not
supported for a result, the partner's default language for that result will be
used.
You can use the AWS CLI or the Amazon Location APIs.
Example response
The following is an example response when calling the SearchPlaceIndexForPosition operation from the Amazon Location
Places APIs. The results return relevant places and
the request summary. Two responses are shown, based on selecting Esri or Here
as the partner.
