[ aws . location ]

search-place-index-for-position

Description

Reverse geocodes a given coordinate and returns a legible address. Allows you to search for Places or points of interest near a given position.

Note

By using Places, you agree that AWS may transmit your API queries to your selected third party provider for processing, which may be outside the AWS region you are currently using.

Because of licensing limitations, you may not use HERE to store results for locations in Japan. For more information, see the AWS Service Terms for Amazon Location Service.

See also: AWS API Documentation

See ‘aws help’ for descriptions of global parameters.

Synopsis

  search-place-index-for-position
--index-name <value>
[--max-results <value>]
--position <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]

Options

--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.

Output

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 for the Place index resource.

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)