Reverse geocodes a given coordinate and returns a legible address. Allows you to search for Places or points of interest near a given position.
See also: AWS API Documentation
See ‘aws help’ for descriptions of global parameters.
search-place-index-for-position
--index-name <value>
[--max-results <value>]
--position <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
--index-name
(string)
The name of the place index resource you want to use for the search.
--max-results
(integer)
An optional paramer. The maximum number of results returned per request.
Default value:
50
--position
(list)
Specifies a coordinate for the query defined by a longitude, and latitude.
The first position is the X coordinate, or longitude.
The second position is the Y coordinate, or latitude.
For example,
position=xLongitude&position=yLatitude
.(double)
Syntax:
double double ...
--cli-input-json
| --cli-input-yaml
(string)
Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton
. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml
.
--generate-cli-skeleton
(string)
Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input
, prints a sample input JSON that can be used as an argument for --cli-input-json
. Similarly, if provided yaml-input
it will print a sample input YAML that can be used with --cli-input-yaml
. If provided with the value output
, it validates the command inputs and returns a sample output JSON for that command.
See ‘aws help’ for descriptions of global parameters.
Results -> (list)
Returns a list of Places closest to the specified position. Each result contains additional information about the Places returned.
(structure)
Specifies a single point of interest, or Place as a result of a search query obtained from a dataset configured in the place index resource.
Place -> (structure)
Contains details about the relevant point of interest.
AddressNumber -> (string)
The numerical portion of an address, such as a building number.
Country -> (string)
A country/region specified using ISO 3166 3-digit country/region code. For example,
CAN
.Geometry -> (structure)
Places uses a point geometry to specify a location or a Place.
Point -> (list)
A single point geometry specifies a location for a Place using WGS 84 coordinates:
x — Specifies the x coordinate or longitude.
y — Specifies the y coordinate or latitude.
(double)
Label -> (string)
The full name and address of the point of interest such as a city, region, or country. For example,
123 Any Street, Any Town, USA
.Municipality -> (string)
A name for a local area, such as a city or town name. For example,
Toronto
.Neighborhood -> (string)
The name of a community district. For example,
Downtown
.PostalCode -> (string)
A group of numbers and letters in a country-specific format, which accompanies the address for the purpose of identifying a location.
Region -> (string)
A name for an area or geographical division, such as a province or state name. For example,
British Columbia
.Street -> (string)
The name for a street or a road to identify a location. For example,
Main Street
.SubRegion -> (string)
A country, or an area that’s part of a larger region . For example,
Metro Vancouver
.
Summary -> (structure)
Contains a summary of the request.
DataSource -> (string)
The data provider of geospatial data. Indicates one of the available providers:
Esri
HERE
For additional details on data providers, see Amazon Location Service data providers .
MaxResults -> (integer)
An optional parameter. The maximum number of results returned per request.
Default value:
50
Position -> (list)
The position given in the reverse geocoding request.
(double)