SDK for PHP 3.x
Amazon Location Service Places V2 2020-11-19
- Client: Aws\GeoPlaces\GeoPlacesClient
- Service ID: geo-places
- Version: 2020-11-19
This page describes the parameters and results for the operations of the Amazon Location Service Places V2 (2020-11-19), and shows how to use the Aws\GeoPlaces\GeoPlacesClient object to call the described operations. This documentation is specific to the 2020-11-19 API version of the service.
Operation Summary
Each of the following operations can be created from a client using
$client->getCommand('CommandName'), where "CommandName" is the
name of one of the following operations. Note: a command is a value that
encapsulates an operation and the parameters used to create an HTTP request.
You can also create and send a command immediately using the magic methods
available on a client object: $client->commandName(/* parameters */).
You can send the command asynchronously (returning a promise) by appending the
word "Async" to the operation name: $client->commandNameAsync(/* parameters */).
- Autocomplete ( array $params = [] )
- The autocomplete operation speeds up and increases the accuracy of entering addresses by providing a list of address candidates matching a partially entered address.
- Geocode ( array $params = [] )
- The Geocode action allows you to obtain coordinates, addresses, and other information about places.
- GetPlace ( array $params = [] )
- Finds a place by its unique ID.
- ReverseGeocode ( array $params = [] )
- The ReverseGeocode operation allows you to retrieve addresses and place information from coordinates.
- SearchNearby ( array $params = [] )
- Search nearby a specified location.
- SearchText ( array $params = [] )
- Use the SearchText operation to search for geocode and place information.
- Suggest ( array $params = [] )
- The Suggest operation finds addresses or place candidates based on incomplete or misspelled queries.
Operations
Autocomplete
$result = $client->autocomplete([/* ... */]); $promise = $client->autocompleteAsync([/* ... */]);
The autocomplete operation speeds up and increases the accuracy of entering addresses by providing a list of address candidates matching a partially entered address. Results are sorted from most to least matching. Filtering and biasing can be used to increase the relevance of the results if additional search context is known
Parameter Syntax
$result = $client->autocomplete([
'AdditionalFeatures' => ['<string>', ...],
'BiasPosition' => [<float>, ...],
'Filter' => [
'BoundingBox' => [<float>, ...],
'Circle' => [
'Center' => [<float>, ...], // REQUIRED
'Radius' => <integer>, // REQUIRED
],
'IncludeCountries' => ['<string>', ...],
'IncludePlaceTypes' => ['<string>', ...],
],
'IntendedUse' => 'SingleUse',
'Key' => '<string>',
'Language' => '<string>',
'MaxResults' => <integer>,
'PoliticalView' => '<string>',
'PostalCodeMode' => 'MergeAllSpannedLocalities|EnumerateSpannedLocalities',
'QueryText' => '<string>', // REQUIRED
]);
Parameter Details
Members
- AdditionalFeatures
-
- Type: Array of strings
A list of optional additional parameters that can be requested for each result.
- BiasPosition
-
- Type: Array of doubles
The position in longitude and latitude that the results should be close to. Typically, place results returned are ranked higher the closer they are to this position. Stored in
[lng, lat]and in the WSG84 format.The fields
BiasPosition,FilterBoundingBox, andFilterCircleare mutually exclusive. - Filter
-
- Type: AutocompleteFilter structure
A structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
- IntendedUse
-
- Type: string
Indicates if the results will be stored. Defaults to
SingleUse, if left empty. - Key
-
- Type: string
Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
- Language
-
- Type: string
A list of BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
- MaxResults
-
- Type: int
An optional limit for the number of results returned in a single call.
- PoliticalView
-
- Type: string
The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
- PostalCodeMode
-
- Type: string
The
PostalCodeModeaffects how postal code results are returned. If a postal code spans multiple localities and this value is empty, partial district or locality information may be returned under a single postal code result entry. If it's populated with the valuecityLookup, all cities in that postal code are returned. - QueryText
-
- Required: Yes
- Type: string
The free-form text query to match addresses against. This is usually a partially typed address from an end user in an address box or form.
Result Syntax
[
'PricingBucket' => '<string>',
'ResultItems' => [
[
'Address' => [
'AddressNumber' => '<string>',
'Block' => '<string>',
'Building' => '<string>',
'Country' => [
'Code2' => '<string>',
'Code3' => '<string>',
'Name' => '<string>',
],
'District' => '<string>',
'Intersection' => ['<string>', ...],
'Label' => '<string>',
'Locality' => '<string>',
'PostalCode' => '<string>',
'Region' => [
'Code' => '<string>',
'Name' => '<string>',
],
'Street' => '<string>',
'StreetComponents' => [
[
'BaseName' => '<string>',
'Direction' => '<string>',
'Language' => '<string>',
'Prefix' => '<string>',
'Suffix' => '<string>',
'Type' => '<string>',
'TypePlacement' => 'BeforeBaseName|AfterBaseName',
'TypeSeparator' => '<string>',
],
// ...
],
'SubBlock' => '<string>',
'SubDistrict' => '<string>',
'SubRegion' => [
'Code' => '<string>',
'Name' => '<string>',
],
],
'Distance' => <integer>,
'Highlights' => [
'Address' => [
'AddressNumber' => [
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
'Block' => [
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
'Building' => [
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
'Country' => [
'Code' => [
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
'Name' => [
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
],
'District' => [
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
'Intersection' => [
[
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
// ...
],
'Label' => [
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
'Locality' => [
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
'PostalCode' => [
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
'Region' => [
'Code' => [
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
'Name' => [
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
],
'Street' => [
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
'SubBlock' => [
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
'SubDistrict' => [
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
'SubRegion' => [
'Code' => [
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
'Name' => [
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
],
],
'Title' => [
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
],
'Language' => '<string>',
'PlaceId' => '<string>',
'PlaceType' => 'Country|Region|SubRegion|Locality|District|SubDistrict|PostalCode|Block|SubBlock|Intersection|Street|PointOfInterest|PointAddress|InterpolatedAddress',
'PoliticalView' => '<string>',
'Title' => '<string>',
],
// ...
],
]
Result Details
Members
- PricingBucket
-
- Required: Yes
- Type: string
The pricing bucket for which the query is charged at.
For more inforamtion on pricing, please visit Amazon Location Service Pricing.
- ResultItems
-
- Type: Array of AutocompleteResultItem structures
List of places or results returned for a query.
Errors
- InternalServerException:
The request processing has failed because of an unknown error, exception or failure.
- AccessDeniedException:
You don't have sufficient access to perform this action.
- ValidationException:
The input fails to satisfy the constraints specified by an AWS service.
- ThrottlingException:
The request was denied due to request throttling.
Geocode
$result = $client->geocode([/* ... */]); $promise = $client->geocodeAsync([/* ... */]);
The Geocode action allows you to obtain coordinates, addresses, and other information about places.
Parameter Syntax
$result = $client->geocode([
'AdditionalFeatures' => ['<string>', ...],
'BiasPosition' => [<float>, ...],
'Filter' => [
'IncludeCountries' => ['<string>', ...],
'IncludePlaceTypes' => ['<string>', ...],
],
'IntendedUse' => 'SingleUse|Storage',
'Key' => '<string>',
'Language' => '<string>',
'MaxResults' => <integer>,
'PoliticalView' => '<string>',
'QueryComponents' => [
'AddressNumber' => '<string>',
'Country' => '<string>',
'District' => '<string>',
'Locality' => '<string>',
'PostalCode' => '<string>',
'Region' => '<string>',
'Street' => '<string>',
'SubRegion' => '<string>',
],
'QueryText' => '<string>',
]);
Parameter Details
Members
- AdditionalFeatures
-
- Type: Array of strings
A list of optional additional parameters, such as time zone, that can be requested for each result.
- BiasPosition
-
- Type: Array of doubles
The position, in longitude and latitude, that the results should be close to. Typically, place results returned are ranked higher the closer they are to this position. Stored in
[lng, lat]and in the WSG84 format.The fields
BiasPosition,FilterBoundingBox, andFilterCircleare mutually exclusive. - Filter
-
- Type: GeocodeFilter structure
A structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
- IntendedUse
-
- Type: string
Indicates if the results will be stored. Defaults to
SingleUse, if left empty. - Key
-
- Type: string
Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
- Language
-
- Type: string
A list of BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
- MaxResults
-
- Type: int
An optional limit for the number of results returned in a single call.
- PoliticalView
-
- Type: string
The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
- QueryComponents
-
- Type: GeocodeQueryComponents structure
A structured free text query allows you to search for places by the name or text representation of specific properties of the place.
- QueryText
-
- Type: string
The free-form text query to match addresses against. This is usually a partially typed address from an end user in an address box or form.
Result Syntax
[
'PricingBucket' => '<string>',
'ResultItems' => [
[
'AccessPoints' => [
[
'Position' => [<float>, ...],
],
// ...
],
'Address' => [
'AddressNumber' => '<string>',
'Block' => '<string>',
'Building' => '<string>',
'Country' => [
'Code2' => '<string>',
'Code3' => '<string>',
'Name' => '<string>',
],
'District' => '<string>',
'Intersection' => ['<string>', ...],
'Label' => '<string>',
'Locality' => '<string>',
'PostalCode' => '<string>',
'Region' => [
'Code' => '<string>',
'Name' => '<string>',
],
'Street' => '<string>',
'StreetComponents' => [
[
'BaseName' => '<string>',
'Direction' => '<string>',
'Language' => '<string>',
'Prefix' => '<string>',
'Suffix' => '<string>',
'Type' => '<string>',
'TypePlacement' => 'BeforeBaseName|AfterBaseName',
'TypeSeparator' => '<string>',
],
// ...
],
'SubBlock' => '<string>',
'SubDistrict' => '<string>',
'SubRegion' => [
'Code' => '<string>',
'Name' => '<string>',
],
],
'AddressNumberCorrected' => true || false,
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Distance' => <integer>,
'FoodTypes' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Primary' => true || false,
],
// ...
],
'MapView' => [<float>, ...],
'MatchScores' => [
'Components' => [
'Address' => [
'AddressNumber' => <float>,
'Block' => <float>,
'Building' => <float>,
'Country' => <float>,
'District' => <float>,
'Intersection' => [<float>, ...],
'Locality' => <float>,
'PostalCode' => <float>,
'Region' => <float>,
'SubBlock' => <float>,
'SubDistrict' => <float>,
'SubRegion' => <float>,
],
'Title' => <float>,
],
'Overall' => <float>,
],
'PlaceId' => '<string>',
'PlaceType' => 'Country|Region|SubRegion|Locality|District|SubDistrict|PostalCode|Block|SubBlock|Intersection|Street|PointOfInterest|PointAddress|InterpolatedAddress',
'PoliticalView' => '<string>',
'Position' => [<float>, ...],
'PostalCodeDetails' => [
[
'PostalAuthority' => 'Usps',
'PostalCode' => '<string>',
'PostalCodeType' => 'UspsZip|UspsZipPlus4',
'UspsZip' => [
'ZipClassificationCode' => 'Military|PostOfficeBoxes|Unique',
],
'UspsZipPlus4' => [
'RecordTypeCode' => 'Firm|General|HighRise|PostOfficeBox|Rural|Street',
],
],
// ...
],
'TimeZone' => [
'Name' => '<string>',
'Offset' => '<string>',
'OffsetSeconds' => <integer>,
],
'Title' => '<string>',
],
// ...
],
]
Result Details
Members
- PricingBucket
-
- Required: Yes
- Type: string
The pricing bucket for which the query is charged at.
For more inforamtion on pricing, please visit Amazon Location Service Pricing.
- ResultItems
-
- Type: Array of GeocodeResultItem structures
List of places or results returned for a query.
Errors
- InternalServerException:
The request processing has failed because of an unknown error, exception or failure.
- AccessDeniedException:
You don't have sufficient access to perform this action.
- ValidationException:
The input fails to satisfy the constraints specified by an AWS service.
- ThrottlingException:
The request was denied due to request throttling.
GetPlace
$result = $client->getPlace([/* ... */]); $promise = $client->getPlaceAsync([/* ... */]);
Finds a place by its unique ID. A PlaceId is returned by other place operations.
Parameter Syntax
$result = $client->getPlace([
'AdditionalFeatures' => ['<string>', ...],
'IntendedUse' => 'SingleUse|Storage',
'Key' => '<string>',
'Language' => '<string>',
'PlaceId' => '<string>', // REQUIRED
'PoliticalView' => '<string>',
]);
Parameter Details
Members
- AdditionalFeatures
-
- Type: Array of strings
A list of optional additional parameters such as time zone that can be requested for each result.
- IntendedUse
-
- Type: string
Indicates if the results will be stored. Defaults to
SingleUse, if left empty. - Key
-
- Type: string
Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
- Language
-
- Type: string
A list of BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
- PlaceId
-
- Required: Yes
- Type: string
The
PlaceIdof the place you wish to receive the information for. - PoliticalView
-
- Type: string
The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
Result Syntax
[
'AccessPoints' => [
[
'Position' => [<float>, ...],
],
// ...
],
'AccessRestrictions' => [
[
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Restricted' => true || false,
],
// ...
],
'Address' => [
'AddressNumber' => '<string>',
'Block' => '<string>',
'Building' => '<string>',
'Country' => [
'Code2' => '<string>',
'Code3' => '<string>',
'Name' => '<string>',
],
'District' => '<string>',
'Intersection' => ['<string>', ...],
'Label' => '<string>',
'Locality' => '<string>',
'PostalCode' => '<string>',
'Region' => [
'Code' => '<string>',
'Name' => '<string>',
],
'Street' => '<string>',
'StreetComponents' => [
[
'BaseName' => '<string>',
'Direction' => '<string>',
'Language' => '<string>',
'Prefix' => '<string>',
'Suffix' => '<string>',
'Type' => '<string>',
'TypePlacement' => 'BeforeBaseName|AfterBaseName',
'TypeSeparator' => '<string>',
],
// ...
],
'SubBlock' => '<string>',
'SubDistrict' => '<string>',
'SubRegion' => [
'Code' => '<string>',
'Name' => '<string>',
],
],
'AddressNumberCorrected' => true || false,
'BusinessChains' => [
[
'Id' => '<string>',
'Name' => '<string>',
],
// ...
],
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Contacts' => [
'Emails' => [
[
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Label' => '<string>',
'Value' => '<string>',
],
// ...
],
'Faxes' => [
[
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Label' => '<string>',
'Value' => '<string>',
],
// ...
],
'Phones' => [
[
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Label' => '<string>',
'Value' => '<string>',
],
// ...
],
'Websites' => [
[
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Label' => '<string>',
'Value' => '<string>',
],
// ...
],
],
'FoodTypes' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Primary' => true || false,
],
// ...
],
'MapView' => [<float>, ...],
'OpeningHours' => [
[
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Components' => [
[
'OpenDuration' => '<string>',
'OpenTime' => '<string>',
'Recurrence' => '<string>',
],
// ...
],
'Display' => ['<string>', ...],
'OpenNow' => true || false,
],
// ...
],
'Phonemes' => [
'Address' => [
'Block' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'Country' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'District' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'Locality' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'Region' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'Street' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'SubBlock' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'SubDistrict' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'SubRegion' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
],
'Title' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
],
'PlaceId' => '<string>',
'PlaceType' => 'Country|Region|SubRegion|Locality|District|SubDistrict|PostalCode|Block|SubBlock|Intersection|Street|PointOfInterest|PointAddress|InterpolatedAddress',
'PoliticalView' => '<string>',
'Position' => [<float>, ...],
'PostalCodeDetails' => [
[
'PostalAuthority' => 'Usps',
'PostalCode' => '<string>',
'PostalCodeType' => 'UspsZip|UspsZipPlus4',
'UspsZip' => [
'ZipClassificationCode' => 'Military|PostOfficeBoxes|Unique',
],
'UspsZipPlus4' => [
'RecordTypeCode' => 'Firm|General|HighRise|PostOfficeBox|Rural|Street',
],
],
// ...
],
'PricingBucket' => '<string>',
'TimeZone' => [
'Name' => '<string>',
'Offset' => '<string>',
'OffsetSeconds' => <integer>,
],
'Title' => '<string>',
]
Result Details
Members
- AccessPoints
-
- Type: Array of AccessPoint structures
Position of the access point in
(lng,lat). - AccessRestrictions
-
- Type: Array of AccessRestriction structures
Indicates known access restrictions on a vehicle access point. The index correlates to an access point and indicates if access through this point has some form of restriction.
- Address
-
- Type: Address structure
The place's address.
- AddressNumberCorrected
-
- Type: boolean
Boolean indicating if the address provided has been corrected.
- BusinessChains
-
- Type: Array of BusinessChain structures
The Business Chains associated with the place.
- Categories
-
- Type: Array of Category structures
Categories of results that results must belong to.
- Contacts
-
- Type: Contacts structure
List of potential contact methods for the result/place.
- FoodTypes
-
- Type: Array of FoodType structures
List of food types offered by this result.
- MapView
-
- Type: Array of doubles
The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set of four coordinates:
[{westward lng}, {southern lat}, {eastward lng}, {northern lat}] - OpeningHours
-
- Type: Array of OpeningHours structures
List of opening hours objects.
- Phonemes
-
- Type: PhonemeDetails structure
How the various components of the result's address are pronounced in various languages.
- PlaceId
-
- Required: Yes
- Type: string
The
PlaceIdof the place you wish to receive the information for. - PlaceType
-
- Required: Yes
- Type: string
A
PlaceTypeis a category that the result place must belong to. - PoliticalView
-
- Type: string
The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
- Position
-
- Type: Array of doubles
The position, in longitude and latitude.
- PostalCodeDetails
-
- Type: Array of PostalCodeDetails structures
Contains details about the postal code of the place/result.
- PricingBucket
-
- Required: Yes
- Type: string
The pricing bucket for which the query is charged at.
For more inforamtion on pricing, please visit Amazon Location Service Pricing.
- TimeZone
-
- Type: TimeZone structure
The time zone in which the place is located.
- Title
-
- Required: Yes
- Type: string
The localized display name of this result item based on request parameter
language.
Errors
- InternalServerException:
The request processing has failed because of an unknown error, exception or failure.
- AccessDeniedException:
You don't have sufficient access to perform this action.
- ValidationException:
The input fails to satisfy the constraints specified by an AWS service.
- ThrottlingException:
The request was denied due to request throttling.
ReverseGeocode
$result = $client->reverseGeocode([/* ... */]); $promise = $client->reverseGeocodeAsync([/* ... */]);
The ReverseGeocode operation allows you to retrieve addresses and place information from coordinates.
Parameter Syntax
$result = $client->reverseGeocode([
'AdditionalFeatures' => ['<string>', ...],
'Filter' => [
'IncludePlaceTypes' => ['<string>', ...],
],
'IntendedUse' => 'SingleUse|Storage',
'Key' => '<string>',
'Language' => '<string>',
'MaxResults' => <integer>,
'PoliticalView' => '<string>',
'QueryPosition' => [<float>, ...], // REQUIRED
'QueryRadius' => <integer>,
]);
Parameter Details
Members
- AdditionalFeatures
-
- Type: Array of strings
A list of optional additional parameters, such as time zone that can be requested for each result.
- Filter
-
- Type: ReverseGeocodeFilter structure
A structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
- IntendedUse
-
- Type: string
Indicates if the results will be stored. Defaults to
SingleUse, if left empty. - Key
-
- Type: string
Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
- Language
-
- Type: string
A list of BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
- MaxResults
-
- Type: int
An optional limit for the number of results returned in a single call.
- PoliticalView
-
- Type: string
The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
- QueryPosition
-
- Required: Yes
- Type: Array of doubles
The position, in
[lng, lat]for which you are querying nearby resultsfor. Results closer to the position will be ranked higher then results further away from the position - QueryRadius
-
- Type: long (int|float)
The maximum distance in meters from the QueryPosition from which a result will be returned.
Result Syntax
[
'PricingBucket' => '<string>',
'ResultItems' => [
[
'AccessPoints' => [
[
'Position' => [<float>, ...],
],
// ...
],
'Address' => [
'AddressNumber' => '<string>',
'Block' => '<string>',
'Building' => '<string>',
'Country' => [
'Code2' => '<string>',
'Code3' => '<string>',
'Name' => '<string>',
],
'District' => '<string>',
'Intersection' => ['<string>', ...],
'Label' => '<string>',
'Locality' => '<string>',
'PostalCode' => '<string>',
'Region' => [
'Code' => '<string>',
'Name' => '<string>',
],
'Street' => '<string>',
'StreetComponents' => [
[
'BaseName' => '<string>',
'Direction' => '<string>',
'Language' => '<string>',
'Prefix' => '<string>',
'Suffix' => '<string>',
'Type' => '<string>',
'TypePlacement' => 'BeforeBaseName|AfterBaseName',
'TypeSeparator' => '<string>',
],
// ...
],
'SubBlock' => '<string>',
'SubDistrict' => '<string>',
'SubRegion' => [
'Code' => '<string>',
'Name' => '<string>',
],
],
'AddressNumberCorrected' => true || false,
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Distance' => <integer>,
'FoodTypes' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Primary' => true || false,
],
// ...
],
'MapView' => [<float>, ...],
'PlaceId' => '<string>',
'PlaceType' => 'Country|Region|SubRegion|Locality|District|SubDistrict|PostalCode|Block|SubBlock|Intersection|Street|PointOfInterest|PointAddress|InterpolatedAddress',
'PoliticalView' => '<string>',
'Position' => [<float>, ...],
'PostalCodeDetails' => [
[
'PostalAuthority' => 'Usps',
'PostalCode' => '<string>',
'PostalCodeType' => 'UspsZip|UspsZipPlus4',
'UspsZip' => [
'ZipClassificationCode' => 'Military|PostOfficeBoxes|Unique',
],
'UspsZipPlus4' => [
'RecordTypeCode' => 'Firm|General|HighRise|PostOfficeBox|Rural|Street',
],
],
// ...
],
'TimeZone' => [
'Name' => '<string>',
'Offset' => '<string>',
'OffsetSeconds' => <integer>,
],
'Title' => '<string>',
],
// ...
],
]
Result Details
Members
- PricingBucket
-
- Required: Yes
- Type: string
The pricing bucket for which the query is charged at.
For more inforamtion on pricing, please visit Amazon Location Service Pricing.
- ResultItems
-
- Type: Array of ReverseGeocodeResultItem structures
List of places or results returned for a query.
Errors
- InternalServerException:
The request processing has failed because of an unknown error, exception or failure.
- AccessDeniedException:
You don't have sufficient access to perform this action.
- ValidationException:
The input fails to satisfy the constraints specified by an AWS service.
- ThrottlingException:
The request was denied due to request throttling.
SearchNearby
$result = $client->searchNearby([/* ... */]); $promise = $client->searchNearbyAsync([/* ... */]);
Search nearby a specified location.
Parameter Syntax
$result = $client->searchNearby([
'AdditionalFeatures' => ['<string>', ...],
'Filter' => [
'BoundingBox' => [<float>, ...],
'ExcludeBusinessChains' => ['<string>', ...],
'ExcludeCategories' => ['<string>', ...],
'ExcludeFoodTypes' => ['<string>', ...],
'IncludeBusinessChains' => ['<string>', ...],
'IncludeCategories' => ['<string>', ...],
'IncludeCountries' => ['<string>', ...],
'IncludeFoodTypes' => ['<string>', ...],
],
'IntendedUse' => 'SingleUse|Storage',
'Key' => '<string>',
'Language' => '<string>',
'MaxResults' => <integer>,
'NextToken' => '<string>',
'PoliticalView' => '<string>',
'QueryPosition' => [<float>, ...], // REQUIRED
'QueryRadius' => <integer>,
]);
Parameter Details
Members
- AdditionalFeatures
-
- Type: Array of strings
A list of optional additional parameters, such as time zone, that can be requested for each result.
- Filter
-
- Type: SearchNearbyFilter structure
A structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
- IntendedUse
-
- Type: string
Indicates if the results will be stored. Defaults to
SingleUse, if left empty. - Key
-
- Type: string
Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
- Language
-
- Type: string
A list of BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
- MaxResults
-
- Type: int
An optional limit for the number of results returned in a single call.
- NextToken
-
- Type: string
If
nextTokenis returned, there are more results available. The value ofnextTokenis a unique pagination token for each page. - PoliticalView
-
- Type: string
The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
- QueryPosition
-
- Required: Yes
- Type: Array of doubles
The position, in
[lng, lat]for which you are querying nearby resultsfor. Results closer to the position will be ranked higher then results further away from the position - QueryRadius
-
- Type: long (int|float)
The maximum distance in meters from the QueryPosition from which a result will be returned.
Result Syntax
[
'NextToken' => '<string>',
'PricingBucket' => '<string>',
'ResultItems' => [
[
'AccessPoints' => [
[
'Position' => [<float>, ...],
],
// ...
],
'AccessRestrictions' => [
[
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Restricted' => true || false,
],
// ...
],
'Address' => [
'AddressNumber' => '<string>',
'Block' => '<string>',
'Building' => '<string>',
'Country' => [
'Code2' => '<string>',
'Code3' => '<string>',
'Name' => '<string>',
],
'District' => '<string>',
'Intersection' => ['<string>', ...],
'Label' => '<string>',
'Locality' => '<string>',
'PostalCode' => '<string>',
'Region' => [
'Code' => '<string>',
'Name' => '<string>',
],
'Street' => '<string>',
'StreetComponents' => [
[
'BaseName' => '<string>',
'Direction' => '<string>',
'Language' => '<string>',
'Prefix' => '<string>',
'Suffix' => '<string>',
'Type' => '<string>',
'TypePlacement' => 'BeforeBaseName|AfterBaseName',
'TypeSeparator' => '<string>',
],
// ...
],
'SubBlock' => '<string>',
'SubDistrict' => '<string>',
'SubRegion' => [
'Code' => '<string>',
'Name' => '<string>',
],
],
'AddressNumberCorrected' => true || false,
'BusinessChains' => [
[
'Id' => '<string>',
'Name' => '<string>',
],
// ...
],
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Contacts' => [
'Emails' => [
[
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Label' => '<string>',
'Value' => '<string>',
],
// ...
],
'Faxes' => [
[
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Label' => '<string>',
'Value' => '<string>',
],
// ...
],
'Phones' => [
[
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Label' => '<string>',
'Value' => '<string>',
],
// ...
],
'Websites' => [
[
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Label' => '<string>',
'Value' => '<string>',
],
// ...
],
],
'Distance' => <integer>,
'FoodTypes' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Primary' => true || false,
],
// ...
],
'MapView' => [<float>, ...],
'OpeningHours' => [
[
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Components' => [
[
'OpenDuration' => '<string>',
'OpenTime' => '<string>',
'Recurrence' => '<string>',
],
// ...
],
'Display' => ['<string>', ...],
'OpenNow' => true || false,
],
// ...
],
'Phonemes' => [
'Address' => [
'Block' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'Country' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'District' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'Locality' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'Region' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'Street' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'SubBlock' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'SubDistrict' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'SubRegion' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
],
'Title' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
],
'PlaceId' => '<string>',
'PlaceType' => 'Country|Region|SubRegion|Locality|District|SubDistrict|PostalCode|Block|SubBlock|Intersection|Street|PointOfInterest|PointAddress|InterpolatedAddress',
'PoliticalView' => '<string>',
'Position' => [<float>, ...],
'TimeZone' => [
'Name' => '<string>',
'Offset' => '<string>',
'OffsetSeconds' => <integer>,
],
'Title' => '<string>',
],
// ...
],
]
Result Details
Members
- NextToken
-
- Type: string
If
nextTokenis returned, there are more results available. The value ofnextTokenis a unique pagination token for each page. - PricingBucket
-
- Required: Yes
- Type: string
The pricing bucket for which the query is charged at.
For more inforamtion on pricing, please visit Amazon Location Service Pricing.
- ResultItems
-
- Type: Array of SearchNearbyResultItem structures
List of places or results returned for a query.
Errors
- InternalServerException:
The request processing has failed because of an unknown error, exception or failure.
- AccessDeniedException:
You don't have sufficient access to perform this action.
- ValidationException:
The input fails to satisfy the constraints specified by an AWS service.
- ThrottlingException:
The request was denied due to request throttling.
SearchText
$result = $client->searchText([/* ... */]); $promise = $client->searchTextAsync([/* ... */]);
Use the SearchText operation to search for geocode and place information. You can then complete a follow-up query suggested from the Suggest API via a query id.
Parameter Syntax
$result = $client->searchText([
'AdditionalFeatures' => ['<string>', ...],
'BiasPosition' => [<float>, ...],
'Filter' => [
'BoundingBox' => [<float>, ...],
'Circle' => [
'Center' => [<float>, ...], // REQUIRED
'Radius' => <integer>, // REQUIRED
],
'IncludeCountries' => ['<string>', ...],
],
'IntendedUse' => 'SingleUse|Storage',
'Key' => '<string>',
'Language' => '<string>',
'MaxResults' => <integer>,
'NextToken' => '<string>',
'PoliticalView' => '<string>',
'QueryId' => '<string>',
'QueryText' => '<string>',
]);
Parameter Details
Members
- AdditionalFeatures
-
- Type: Array of strings
A list of optional additional parameters, such as time zone, that can be requested for each result.
- BiasPosition
-
- Type: Array of doubles
The position, in longitude and latitude, that the results should be close to. Typically, place results returned are ranked higher the closer they are to this position. Stored in
[lng, lat]and in the WSG84 format.The fields
BiasPosition,FilterBoundingBox, andFilterCircleare mutually exclusive. - Filter
-
- Type: SearchTextFilter structure
A structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
- IntendedUse
-
- Type: string
Indicates if the results will be stored. Defaults to
SingleUse, if left empty. - Key
-
- Type: string
Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
- Language
-
- Type: string
A list of BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
- MaxResults
-
- Type: int
An optional limit for the number of results returned in a single call.
- NextToken
-
- Type: string
If
nextTokenis returned, there are more results available. The value ofnextTokenis a unique pagination token for each page. - PoliticalView
-
- Type: string
The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
- QueryId
-
- Type: string
The query Id.
- QueryText
-
- Type: string
The free-form text query to match addresses against. This is usually a partially typed address from an end user in an address box or form.
Result Syntax
[
'NextToken' => '<string>',
'PricingBucket' => '<string>',
'ResultItems' => [
[
'AccessPoints' => [
[
'Position' => [<float>, ...],
],
// ...
],
'AccessRestrictions' => [
[
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Restricted' => true || false,
],
// ...
],
'Address' => [
'AddressNumber' => '<string>',
'Block' => '<string>',
'Building' => '<string>',
'Country' => [
'Code2' => '<string>',
'Code3' => '<string>',
'Name' => '<string>',
],
'District' => '<string>',
'Intersection' => ['<string>', ...],
'Label' => '<string>',
'Locality' => '<string>',
'PostalCode' => '<string>',
'Region' => [
'Code' => '<string>',
'Name' => '<string>',
],
'Street' => '<string>',
'StreetComponents' => [
[
'BaseName' => '<string>',
'Direction' => '<string>',
'Language' => '<string>',
'Prefix' => '<string>',
'Suffix' => '<string>',
'Type' => '<string>',
'TypePlacement' => 'BeforeBaseName|AfterBaseName',
'TypeSeparator' => '<string>',
],
// ...
],
'SubBlock' => '<string>',
'SubDistrict' => '<string>',
'SubRegion' => [
'Code' => '<string>',
'Name' => '<string>',
],
],
'AddressNumberCorrected' => true || false,
'BusinessChains' => [
[
'Id' => '<string>',
'Name' => '<string>',
],
// ...
],
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Contacts' => [
'Emails' => [
[
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Label' => '<string>',
'Value' => '<string>',
],
// ...
],
'Faxes' => [
[
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Label' => '<string>',
'Value' => '<string>',
],
// ...
],
'Phones' => [
[
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Label' => '<string>',
'Value' => '<string>',
],
// ...
],
'Websites' => [
[
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Label' => '<string>',
'Value' => '<string>',
],
// ...
],
],
'Distance' => <integer>,
'FoodTypes' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Primary' => true || false,
],
// ...
],
'MapView' => [<float>, ...],
'OpeningHours' => [
[
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Components' => [
[
'OpenDuration' => '<string>',
'OpenTime' => '<string>',
'Recurrence' => '<string>',
],
// ...
],
'Display' => ['<string>', ...],
'OpenNow' => true || false,
],
// ...
],
'Phonemes' => [
'Address' => [
'Block' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'Country' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'District' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'Locality' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'Region' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'Street' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'SubBlock' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'SubDistrict' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'SubRegion' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
],
'Title' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
],
'PlaceId' => '<string>',
'PlaceType' => 'Country|Region|SubRegion|Locality|District|SubDistrict|PostalCode|Block|SubBlock|Intersection|Street|PointOfInterest|PointAddress|InterpolatedAddress',
'PoliticalView' => '<string>',
'Position' => [<float>, ...],
'TimeZone' => [
'Name' => '<string>',
'Offset' => '<string>',
'OffsetSeconds' => <integer>,
],
'Title' => '<string>',
],
// ...
],
]
Result Details
Members
- NextToken
-
- Type: string
If
nextTokenis returned, there are more results available. The value ofnextTokenis a unique pagination token for each page. - PricingBucket
-
- Required: Yes
- Type: string
The pricing bucket for which the query is charged at.
For more inforamtion on pricing, please visit Amazon Location Service Pricing.
- ResultItems
-
- Type: Array of SearchTextResultItem structures
List of places or results returned for a query.
Errors
- InternalServerException:
The request processing has failed because of an unknown error, exception or failure.
- AccessDeniedException:
You don't have sufficient access to perform this action.
- ValidationException:
The input fails to satisfy the constraints specified by an AWS service.
- ThrottlingException:
The request was denied due to request throttling.
Suggest
$result = $client->suggest([/* ... */]); $promise = $client->suggestAsync([/* ... */]);
The Suggest operation finds addresses or place candidates based on incomplete or misspelled queries. You then select the best query to submit based on the returned results.
Parameter Syntax
$result = $client->suggest([
'AdditionalFeatures' => ['<string>', ...],
'BiasPosition' => [<float>, ...],
'Filter' => [
'BoundingBox' => [<float>, ...],
'Circle' => [
'Center' => [<float>, ...], // REQUIRED
'Radius' => <integer>, // REQUIRED
],
'IncludeCountries' => ['<string>', ...],
],
'IntendedUse' => 'SingleUse',
'Key' => '<string>',
'Language' => '<string>',
'MaxQueryRefinements' => <integer>,
'MaxResults' => <integer>,
'PoliticalView' => '<string>',
'QueryText' => '<string>', // REQUIRED
]);
Parameter Details
Members
- AdditionalFeatures
-
- Type: Array of strings
A list of optional additional parameters, such as time zone, that can be requested for each result.
- BiasPosition
-
- Type: Array of doubles
The position, in longitude and latitude, that the results should be close to. Typically, place results returned are ranked higher the closer they are to this position. Stored in
[lng, lat]and in the WSG84 format.The fields
BiasPosition,FilterBoundingBox, andFilterCircleare mutually exclusive. - Filter
-
- Type: SuggestFilter structure
A structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
- IntendedUse
-
- Type: string
Indicates if the results will be stored. Defaults to
SingleUse, if left empty. - Key
-
- Type: string
Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
- Language
-
- Type: string
A list of BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
- MaxQueryRefinements
-
- Type: int
Maximum number of query terms to be returned for use with a search text query.
- MaxResults
-
- Type: int
An optional limit for the number of results returned in a single call.
- PoliticalView
-
- Type: string
The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
- QueryText
-
- Required: Yes
- Type: string
The free-form text query to match addresses against. This is usually a partially typed address from an end user in an address box or form.
Result Syntax
[
'PricingBucket' => '<string>',
'QueryRefinements' => [
[
'EndIndex' => <integer>,
'OriginalTerm' => '<string>',
'RefinedTerm' => '<string>',
'StartIndex' => <integer>,
],
// ...
],
'ResultItems' => [
[
'Highlights' => [
'Address' => [
'Label' => [
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
],
'Title' => [
[
'EndIndex' => <integer>,
'StartIndex' => <integer>,
'Value' => '<string>',
],
// ...
],
],
'Place' => [
'AccessPoints' => [
[
'Position' => [<float>, ...],
],
// ...
],
'AccessRestrictions' => [
[
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Restricted' => true || false,
],
// ...
],
'Address' => [
'AddressNumber' => '<string>',
'Block' => '<string>',
'Building' => '<string>',
'Country' => [
'Code2' => '<string>',
'Code3' => '<string>',
'Name' => '<string>',
],
'District' => '<string>',
'Intersection' => ['<string>', ...],
'Label' => '<string>',
'Locality' => '<string>',
'PostalCode' => '<string>',
'Region' => [
'Code' => '<string>',
'Name' => '<string>',
],
'Street' => '<string>',
'StreetComponents' => [
[
'BaseName' => '<string>',
'Direction' => '<string>',
'Language' => '<string>',
'Prefix' => '<string>',
'Suffix' => '<string>',
'Type' => '<string>',
'TypePlacement' => 'BeforeBaseName|AfterBaseName',
'TypeSeparator' => '<string>',
],
// ...
],
'SubBlock' => '<string>',
'SubDistrict' => '<string>',
'SubRegion' => [
'Code' => '<string>',
'Name' => '<string>',
],
],
'BusinessChains' => [
[
'Id' => '<string>',
'Name' => '<string>',
],
// ...
],
'Categories' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Name' => '<string>',
'Primary' => true || false,
],
// ...
],
'Distance' => <integer>,
'FoodTypes' => [
[
'Id' => '<string>',
'LocalizedName' => '<string>',
'Primary' => true || false,
],
// ...
],
'MapView' => [<float>, ...],
'Phonemes' => [
'Address' => [
'Block' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'Country' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'District' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'Locality' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'Region' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'Street' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'SubBlock' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'SubDistrict' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
'SubRegion' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
],
'Title' => [
[
'Language' => '<string>',
'Preferred' => true || false,
'Value' => '<string>',
],
// ...
],
],
'PlaceId' => '<string>',
'PlaceType' => 'Country|Region|SubRegion|Locality|District|SubDistrict|PostalCode|Block|SubBlock|Intersection|Street|PointOfInterest|PointAddress|InterpolatedAddress',
'PoliticalView' => '<string>',
'Position' => [<float>, ...],
'TimeZone' => [
'Name' => '<string>',
'Offset' => '<string>',
'OffsetSeconds' => <integer>,
],
],
'Query' => [
'QueryId' => '<string>',
'QueryType' => 'Category|BusinessChain',
],
'SuggestResultItemType' => 'Place|Query',
'Title' => '<string>',
],
// ...
],
]
Result Details
Members
- PricingBucket
-
- Required: Yes
- Type: string
The pricing bucket for which the query is charged at.
For more inforamtion on pricing, please visit Amazon Location Service Pricing.
- QueryRefinements
-
- Type: Array of QueryRefinement structures
Maximum number of query terms to be returned for use with a search text query.
- ResultItems
-
- Type: Array of SuggestResultItem structures
List of places or results returned for a query.
Errors
- InternalServerException:
The request processing has failed because of an unknown error, exception or failure.
- AccessDeniedException:
You don't have sufficient access to perform this action.
- ValidationException:
The input fails to satisfy the constraints specified by an AWS service.
- ThrottlingException:
The request was denied due to request throttling.
Shapes
AccessDeniedException
Description
You don't have sufficient access to perform this action.
Members
- Message
-
- Required: Yes
- Type: string
AccessPoint
Description
Position of the access point represented by longitude and latitude for a vehicle.
Members
- Position
-
- Type: Array of doubles
The position, in longitude and latitude.
AccessRestriction
Description
Indicates if the access location is restricted. Index correlates to that of an access point and indicates if access through this point has some form of restriction.
Members
- Categories
-
- Type: Array of Category structures
Categories of results that results must belong too.
- Restricted
-
- Type: boolean
The restriction.
Address
Description
The place address.
Members
- AddressNumber
-
- Type: string
The number that identifies an address within a street.
- Block
-
- Type: string
Name of the block.
Example:
Sunny Mansion 203 block: 2 Chome - Building
-
- Type: string
The name of the building at the address.
- Country
-
- Type: Country structure
The country component of the address.
- District
-
- Type: string
The district or division of a locality associated with this address.
- Intersection
-
- Type: Array of strings
Name of the streets in the intersection.
Example:
["Friedrichstraße","Unter den Linden"] - Label
-
- Type: string
Assembled address value built out of the address components, according to the regional postal rules. This is the correctly formatted address.
- Locality
-
- Type: string
The locality or city of the address.
Example:
Vancouver. - PostalCode
-
- Type: string
An alphanumeric string included in a postal address to facilitate mail sorting, such as post code, postcode, or ZIP code, for which the result should posses.
- Region
-
- Type: Region structure
The region or state results should be present in.
Example:
North Rhine-Westphalia. - Street
-
- Type: string
The name of the street results should be present in.
- StreetComponents
-
- Type: Array of StreetComponents structures
Components of the street.
Example: Younge from the "Younge street".
- SubBlock
-
- Type: string
Name of sub-block.
Example:
Sunny Mansion 203 sub-block: 4 - SubDistrict
-
- Type: string
A subdivision of a district.
Example:
Minden-Lübbecke. - SubRegion
-
- Type: SubRegion structure
The sub-region or county for which results should be present in.
AddressComponentMatchScores
Description
Indicates how well the entire input matches the returned. It is equal to 1 if all input tokens are recognized and matched.
Members
- AddressNumber
-
- Type: double
The house number or address results should have.
- Block
-
- Type: double
Name of the block.
Example:
Sunny Mansion 203 block: 2 Chome - Building
-
- Type: double
The name of the building at the address.
- Country
-
- Type: double
The alpha-2 or alpha-3 character code for the country that the results will be present in.
- District
-
- Type: double
The district or division of a city the results should be present in.
- Intersection
-
- Type: Array of doubles
Name of the streets in the intersection.
Example:
["Friedrichstraße","Unter den Linden"] - Locality
-
- Type: double
The city or locality results should be present in.
Example:
Vancouver. - PostalCode
-
- Type: double
An alphanumeric string included in a postal address to facilitate mail sorting, such as post code, postcode, or ZIP code, for which the result should posses.
- Region
-
- Type: double
The region or state results should be to be present in.
Example:
North Rhine-Westphalia. - SubBlock
-
- Type: double
Name of sub-block.
Example:
Sunny Mansion 203 sub-block: 4 - SubDistrict
-
- Type: double
A subdivision of a district.
Example:
Minden-Lübbecke - SubRegion
-
- Type: double
The sub-region or county for which results should be present in.
AddressComponentPhonemes
Description
How to pronounce the various components of the address or place.
Members
- Block
-
- Type: Array of PhonemeTranscription structures
How to pronounce the name of the block.
- Country
-
- Type: Array of PhonemeTranscription structures
The alpha-2 or alpha-3 character code for the country that the results will be present in.
- District
-
- Type: Array of PhonemeTranscription structures
How to pronounce the district or division of a city results should be present in.
- Locality
-
- Type: Array of PhonemeTranscription structures
How to pronounce the city or locality results should be present in.
Example:
Vancouver. - Region
-
- Type: Array of PhonemeTranscription structures
How to pronounce the region or state results should be to be present in.
- Street
-
- Type: Array of PhonemeTranscription structures
How to pronounce the name of the street results should be present in.
- SubBlock
-
- Type: Array of PhonemeTranscription structures
How to pronounce the name of the sub-block.
- SubDistrict
-
- Type: Array of PhonemeTranscription structures
How to pronounce the sub-district or division of a city results should be present in.
- SubRegion
-
- Type: Array of PhonemeTranscription structures
How to pronounce the sub-region or county for which results should be present in.
AutocompleteAddressHighlights
Description
Describes how the parts of the response element matched the input query by returning the sections of the response which matched to input query terms.
Members
- AddressNumber
-
- Type: Array of Highlight structures
The house number or address results should have.
- Block
-
- Type: Array of Highlight structures
Name of the block. Example: Sunny Mansion 203 block: 2 Chome
- Building
-
- Type: Array of Highlight structures
The name of the building at the address.
- Country
-
- Type: CountryHighlights structure
The alpha-2 or alpha-3 character code for the country that the results will be present in.
- District
-
- Type: Array of Highlight structures
The district or division of a city the results should be present in.
- Intersection
-
- Type: Array of Highlight structuress
Name of the streets in the intersection. For example: e.g. ["Friedrichstraße","Unter den Linden"]
- Label
-
- Type: Array of Highlight structures
Indicates the starting and ending indexes for result items where they are identified to match the input query. This should be used to provide emphasis to output display to make selecting the correct result from a list easier for end users.
- Locality
-
- Type: Array of Highlight structures
The city or locality results should be present in.
Example:
Vancouver. - PostalCode
-
- Type: Array of Highlight structures
An alphanumeric string included in a postal address to facilitate mail sorting, such as post code, postcode, or ZIP code for which the result should posses.
- Region
-
- Type: RegionHighlights structure
The region or state results should be to be present in.
Example:
North Rhine-Westphalia. - Street
-
- Type: Array of Highlight structures
The name of the street results should be present in.
- SubBlock
-
- Type: Array of Highlight structures
Name of sub-block. Example Sunny Mansion 203 sub-block: 4
- SubDistrict
-
- Type: Array of Highlight structures
Indicates the starting and ending index of the title in the text query that match the found title.
- SubRegion
-
- Type: SubRegionHighlights structure
The sub-region or county for which results should be present in.
AutocompleteFilter
Description
Autocomplete structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
Members
- BoundingBox
-
- Type: Array of doubles
The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set 4 coordinates:
[{westward lng}, {southern lat}, {eastward lng}, {northern lat}] - Circle
-
- Type: FilterCircle structure
The
Circlethat all results must be in. - IncludeCountries
-
- Type: Array of strings
A list of countries that all results must be in. Countries are represented by either their alpha-2 or alpha-3 character codes.
- IncludePlaceTypes
-
- Type: Array of strings
The included place types.
AutocompleteHighlights
Description
Describes how the parts of the response element matched the input query by returning the sections of the response which matched to input query terms.
Members
- Address
-
- Type: AutocompleteAddressHighlights structure
Describes how part of the result address match the input query.
- Title
-
- Type: Array of Highlight structures
Indicates where the title field in the result matches the input query.
AutocompleteResultItem
Description
A result matching the input query text.
Members
- Address
-
- Type: Address structure
The address associated with this result.
- Distance
-
- Type: long (int|float)
The distance in meters between the center of the search area and this result. Useful to evaluate how far away from the original bias position the result is.
- Highlights
-
- Type: AutocompleteHighlights structure
Indicates the starting and ending index of the place in the text query that match the found title.
- Language
-
- Type: string
A list of BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
- PlaceId
-
- Required: Yes
- Type: string
The PlaceId of the place associated with this result. This can be used to look up additional details about the result via GetPlace.
- PlaceType
-
- Required: Yes
- Type: string
PlaceType describes the type of result entry returned.
- PoliticalView
-
- Type: string
The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
- Title
-
- Required: Yes
- Type: string
A formatted string for display when presenting this result to an end user.
BusinessChain
Description
A businesschain is a chain of businesses that belong to the same brand. For example 7-11.
Members
- Id
-
- Type: string
The Business Chain Id.
- Name
-
- Type: string
The business chain name.
Category
Description
Category of the Place returned.
Members
- Id
-
- Required: Yes
- Type: string
The category ID.
- LocalizedName
-
- Type: string
Localized name of the category type.
- Name
-
- Required: Yes
- Type: string
The category name.
- Primary
-
- Type: boolean
Boolean which indicates if this category is the primary offered by the place.
ComponentMatchScores
Description
Indicates how well the input matches the returned element. It is equal to 1 if all input tokens are recognized and matched to the title in the result.
Members
- Address
-
- Type: AddressComponentMatchScores structure
The place's address.
- Title
-
- Type: double
Indicates the starting and ending index of the title in the text query that match the found title.
ContactDetails
Description
Details related to contacts.
Members
- Categories
-
- Type: Array of Category structures
Categories of results that results must belong too.
- Label
-
- Type: string
The contact's label.
- Value
-
- Type: string
The contact's value.
Contacts
Description
A list of potential contact methods for the result/place.
Members
- Emails
-
- Type: Array of ContactDetails structures
List of emails for contacts of the result.
- Faxes
-
- Type: Array of ContactDetails structures
List of fax addresses for the result contact.
- Phones
-
- Type: Array of ContactDetails structures
List of phone numbers for the results contact.
- Websites
-
- Type: Array of ContactDetails structures
List of website URLs that belong to the result.
Country
Description
The alpha-2 or alpha-3 character code for the country that the results will be present in.
Members
- Code2
-
- Type: string
Country, represented by its alpha 2-character code.
- Code3
-
- Type: string
Country, represented by its alpha t-character code.
- Name
-
- Type: string
Name of the country.
CountryHighlights
Description
Indicates the starting and ending index of the country in the text query that match the found title.
Members
FilterCircle
Description
The Circle that all results must be in.
Members
- Center
-
- Required: Yes
- Type: Array of doubles
The center position, in longitude and latitude, of the
FilterCircle. - Radius
-
- Required: Yes
- Type: long (int|float)
The radius, in meters, of the
FilterCircle.
FoodType
Description
List of Food types offered by this result.
Members
- Id
-
- Type: string
The Food Type Id.
- LocalizedName
-
- Required: Yes
- Type: string
Localized name of the food type.
- Primary
-
- Type: boolean
Boolean which indicates if this food type is the primary offered by the place. For example, if a location serves fast food, but also dessert, he primary would likely be fast food.
GeocodeFilter
Description
Geocode structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
Members
- IncludeCountries
-
- Type: Array of strings
A list of countries that all results must be in. Countries are represented by either their alpha-2 or alpha-3 character codes.
- IncludePlaceTypes
-
- Type: Array of strings
The included place types.
GeocodeQueryComponents
Description
A structured free text query allows you to search for places by the name or text representation of specific properties of the place.
Members
- AddressNumber
-
- Type: string
The house number or address results should have.
- Country
-
- Type: string
The alpha-2 or alpha-3 character code for the country that the results will be present in.
- District
-
- Type: string
The district or division of a city the results should be present in.
- Locality
-
- Type: string
City or locality results should be present in.
Example:
Vancouver. - PostalCode
-
- Type: string
An alphanumeric string included in a postal address to facilitate mail sorting, such as post code, postcode, or ZIP code for which the result should posses.
- Region
-
- Type: string
The region or state results should be to be present in.
Example:
North Rhine-Westphalia. - Street
-
- Type: string
The name of the street results should be present in.
- SubRegion
-
- Type: string
The sub-region or county for which results should be present in.
GeocodeResultItem
Description
The Geocoded result.
Members
- AccessPoints
-
- Type: Array of AccessPoint structures
Position of the access point represent by longitude and latitude.
- Address
-
- Type: Address structure
The place's address.
- AddressNumberCorrected
-
- Type: boolean
Boolean indicating if the address provided has been corrected.
- Categories
-
- Type: Array of Category structures
Categories of results that results must belong to.
- Distance
-
- Type: long (int|float)
The distance in meters from the QueryPosition.
- FoodTypes
-
- Type: Array of FoodType structures
List of food types offered by this result.
- MapView
-
- Type: Array of doubles
The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set 4 coordinates:
[{westward lng}, {southern lat}, {eastward lng}, {northern lat}] - MatchScores
-
- Type: MatchScoreDetails structure
Indicates how well the entire input matches the returned. It is equal to 1 if all input tokens are recognized and matched.
- PlaceId
-
- Required: Yes
- Type: string
The
PlaceIdof the place you wish to receive the information for. - PlaceType
-
- Required: Yes
- Type: string
A
PlaceTypeis a category that the result place must belong to. - PoliticalView
-
- Type: string
The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
- Position
-
- Type: Array of doubles
The position in longitude and latitude.
- PostalCodeDetails
-
- Type: Array of PostalCodeDetails structures
Contains details about the postal code of the place/result.
- TimeZone
-
- Type: TimeZone structure
The time zone in which the place is located.
- Title
-
- Required: Yes
- Type: string
The localized display name of this result item based on request parameter
language.
Highlight
Description
Describes how parts of the result response match the input query.
Members
- EndIndex
-
- Type: int
End index of the highlight.
- StartIndex
-
- Type: int
Start index of the highlight.
- Value
-
- Type: string
The highlight's value.
InternalServerException
Description
The request processing has failed because of an unknown error, exception or failure.
Members
- Message
-
- Required: Yes
- Type: string
MatchScoreDetails
Description
Details related to the match score.
Members
- Components
-
- Type: ComponentMatchScores structure
Indicates how well the component input matches the returned. It is equal to 1 if all input tokens are recognized and matched.
- Overall
-
- Type: double
Indicates how well the entire input matches the returned. It is equal to 1 if all input tokens are recognized and matched.
OpeningHours
Description
List of opening hours objects.
Members
- Categories
-
- Type: Array of Category structures
Categories of results that results must belong too.
- Components
-
- Type: Array of OpeningHoursComponents structures
Components of the opening hours object.
- Display
-
- Type: Array of strings
List of opening hours in the format they are displayed in. This can vary by result and in most cases represents how the result uniquely formats their opening hours.
- OpenNow
-
- Type: boolean
Boolean which indicates if the result/place is currently open.
OpeningHoursComponents
Description
Components of the opening hours object.
Members
- OpenDuration
-
- Type: string
String which represents the duration of the opening period, such as
"PT12H00M". - OpenTime
-
- Type: string
String which represents the opening hours, such as
"T070000". - Recurrence
-
- Type: string
Days or periods when the provided opening hours are in affect.
Example:
FREQ:DAILY;BYDAY:MO,TU,WE,TH,SU
PhonemeDetails
Description
The phoneme details.
Members
- Address
-
- Type: AddressComponentPhonemes structure
How to pronounce the address.
- Title
-
- Type: Array of PhonemeTranscription structures
List of
PhonemeTranscription. SeePhonemeTranscriptionfor fields.
PhonemeTranscription
Description
How to pronounce the various components of the address or place.
Members
- Language
-
- Type: string
A list of BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
- Preferred
-
- Type: boolean
Boolean which indicates if it the preferred pronunciation.
- Value
-
- Type: string
Value which indicates how to pronounce the value.
PostalCodeDetails
Description
Contains details about the postal code of the place or result.
Members
- PostalAuthority
-
- Type: string
The postal authority or entity. This could be a governmental authority, a regulatory authority, or a designated postal operator.
- PostalCode
-
- Type: string
An alphanumeric string included in a postal address to facilitate mail sorting, such as post code, postcode, or ZIP code for which the result should posses.
- PostalCodeType
-
- Type: string
The postal code type.
- UspsZip
-
- Type: UspsZip structure
The ZIP Classification Code, or in other words what type of postal code is it.
- UspsZipPlus4
-
- Type: UspsZipPlus4 structure
The USPS ZIP+4 Record Type Code.
QueryRefinement
Description
Suggestions for refining individual query terms. Suggestions are returned as objects which note the term, suggested replacement, and its index in the query.
Members
- EndIndex
-
- Required: Yes
- Type: int
End index of the parsed query.
- OriginalTerm
-
- Required: Yes
- Type: string
The sub-string of the original query that is replaced by this query term.
- RefinedTerm
-
- Required: Yes
- Type: string
The term that will be suggested to the user.
- StartIndex
-
- Required: Yes
- Type: int
Start index of the parsed component.
Region
Description
The region or state results should be to be present in.
Example: North Rhine-Westphalia.
Members
- Code
-
- Type: string
Abbreviated code for a the state, province or region of the country.
Example:
BC. - Name
-
- Type: string
Name for a the state, province, or region of the country.
Example:
British Columbia.
RegionHighlights
Description
Indicates the starting and ending index of the region in the text query that match the found title.
Members
ReverseGeocodeFilter
Description
The included place types.
Members
- IncludePlaceTypes
-
- Type: Array of strings
The included place types.
ReverseGeocodeResultItem
Description
The returned location from the Reverse Geocode action.
Members
- AccessPoints
-
- Type: Array of AccessPoint structures
Position of the access point represent by longitude and latitude.
- Address
-
- Type: Address structure
The place's address.
- AddressNumberCorrected
-
- Type: boolean
Boolean indicating if the address provided has been corrected.
- Categories
-
- Type: Array of Category structures
Categories of results that results must belong to.
- Distance
-
- Type: long (int|float)
The distance in meters from the QueryPosition.
- FoodTypes
-
- Type: Array of FoodType structures
List of food types offered by this result.
- MapView
-
- Type: Array of doubles
The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set 4 coordinates:
[{westward lng}, {southern lat}, {eastward lng}, {northern lat}] - PlaceId
-
- Required: Yes
- Type: string
The
PlaceIdof the place you wish to receive the information for. - PlaceType
-
- Required: Yes
- Type: string
A
PlaceTypeis a category that the result place must belong to. - PoliticalView
-
- Type: string
The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
- Position
-
- Type: Array of doubles
The position in longitude and latitude.
- PostalCodeDetails
-
- Type: Array of PostalCodeDetails structures
Contains details about the postal code of the place/result.
- TimeZone
-
- Type: TimeZone structure
The time zone in which the place is located.
- Title
-
- Required: Yes
- Type: string
The localized display name of this result item based on request parameter
language.
SearchNearbyFilter
Description
SearchNearby structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
Members
- BoundingBox
-
- Type: Array of doubles
The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set 4 coordinates:
[{westward lng}, {southern lat}, {eastward lng}, {northern lat}] - ExcludeBusinessChains
-
- Type: Array of strings
The Business Chains associated with the place.
- ExcludeCategories
-
- Type: Array of strings
Categories of results that results are excluded from.
- ExcludeFoodTypes
-
- Type: Array of strings
Food types that results are excluded from.
- IncludeBusinessChains
-
- Type: Array of strings
The Business Chains associated with the place.
- IncludeCategories
-
- Type: Array of strings
Categories of results that results must belong too.
- IncludeCountries
-
- Type: Array of strings
A list of countries that all results must be in. Countries are represented by either their alpha-2 or alpha-3 character codes.
- IncludeFoodTypes
-
- Type: Array of strings
Food types that results are included from.
SearchNearbyResultItem
Description
The search results of nearby places.
Members
- AccessPoints
-
- Type: Array of AccessPoint structures
Position of the access point represent by longitude and latitude.
- AccessRestrictions
-
- Type: Array of AccessRestriction structures
Indicates known access restrictions on a vehicle access point. The index correlates to an access point and indicates if access through this point has some form of restriction.
- Address
-
- Type: Address structure
The place's address.
- AddressNumberCorrected
-
- Type: boolean
Boolean indicating if the address provided has been corrected.
- BusinessChains
-
- Type: Array of BusinessChain structures
The Business Chains associated with the place.
- Categories
-
- Type: Array of Category structures
Categories of results that results must belong to.
- Contacts
-
- Type: Contacts structure
List of potential contact methods for the result/place.
- Distance
-
- Type: long (int|float)
The distance in meters from the QueryPosition.
- FoodTypes
-
- Type: Array of FoodType structures
List of food types offered by this result.
- MapView
-
- Type: Array of doubles
The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set 4 coordinates:
[{westward lng}, {southern lat}, {eastward lng}, {northern lat}] - OpeningHours
-
- Type: Array of OpeningHours structures
List of opening hours objects.
- Phonemes
-
- Type: PhonemeDetails structure
How the various components of the result's address are pronounced in various languages.
- PlaceId
-
- Required: Yes
- Type: string
The
PlaceIdof the place you wish to receive the information for. - PlaceType
-
- Required: Yes
- Type: string
A
PlaceTypeis a category that the result place must belong to. - PoliticalView
-
- Type: string
The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
- Position
-
- Type: Array of doubles
The position in longitude and latitude.
- TimeZone
-
- Type: TimeZone structure
The time zone in which the place is located.
- Title
-
- Required: Yes
- Type: string
The item's title.
SearchTextFilter
Description
SearchText structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
Members
- BoundingBox
-
- Type: Array of doubles
The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set 4 coordinates:
[{westward lng}, {southern lat}, {eastward lng}, {northern lat}] - Circle
-
- Type: FilterCircle structure
The
Circlethat all results must be in. - IncludeCountries
-
- Type: Array of strings
A list of countries that all results must be in. Countries are represented by either their alpha-2 or alpha-3 character codes.
SearchTextResultItem
Description
The text search result.
Members
- AccessPoints
-
- Type: Array of AccessPoint structures
Position of the access point represent by longitude and latitude.
- AccessRestrictions
-
- Type: Array of AccessRestriction structures
Indicates known access restrictions on a vehicle access point. The index correlates to an access point and indicates if access through this point has some form of restriction.
- Address
-
- Type: Address structure
The place's address.
- AddressNumberCorrected
-
- Type: boolean
Boolean indicating if the address provided has been corrected.
- BusinessChains
-
- Type: Array of BusinessChain structures
The Business Chains associated with the place.
- Categories
-
- Type: Array of Category structures
Categories of results that results must belong to.
- Contacts
-
- Type: Contacts structure
List of potential contact methods for the result/place.
- Distance
-
- Type: long (int|float)
The distance in meters from the QueryPosition.
- FoodTypes
-
- Type: Array of FoodType structures
List of food types offered by this result.
- MapView
-
- Type: Array of doubles
The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set 4 coordinates:
[{westward lng}, {southern lat}, {eastward lng}, {northern lat}] - OpeningHours
-
- Type: Array of OpeningHours structures
List of opening hours objects.
- Phonemes
-
- Type: PhonemeDetails structure
How the various components of the result's address are pronounced in various languages.
- PlaceId
-
- Required: Yes
- Type: string
The
PlaceIdof the place you wish to receive the information for. - PlaceType
-
- Required: Yes
- Type: string
A
PlaceTypeis a category that the result place must belong to. - PoliticalView
-
- Type: string
The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
- Position
-
- Type: Array of doubles
The position, in longitude and latitude.
- TimeZone
-
- Type: TimeZone structure
The time zone in which the place is located.
- Title
-
- Required: Yes
- Type: string
The item's title.
StreetComponents
Description
Components of a street.
Members
- BaseName
-
- Type: string
Base name part of the street name.
Example: Younge from the “Younge street".
- Direction
-
- Type: string
Indicates the official directional identifiers assigned to highways.
- Language
-
- Type: string
A BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
- Prefix
-
- Type: string
A prefix is a directional identifier that precedes, but is not included in, the base name of a road.
Example: E for East.
- Suffix
-
- Type: string
A suffix is a directional identifier that follows, but is not included in, the base name of a road.
Example W for West.
- Type
-
- Type: string
Street type part of the street name.
Example:
“avenue". - TypePlacement
-
- Type: string
Defines if the street type is before or after the base name.
- TypeSeparator
-
- Type: string
What character(s) separates the string from its type.
SubRegion
Description
The sub-region.
Members
- Code
-
- Type: string
Abbreviated code for the county or sub-region.
- Name
-
- Type: string
Name for the county or sub-region.
SubRegionHighlights
Description
Indicates the starting and ending index of the sub-region in the text query that match the found title.
Members
SuggestAddressHighlights
Description
Describes how the parts of the textQuery matched the input query by returning the sections of the response which matched to textQuery terms.
Members
- Label
-
- Type: Array of Highlight structures
Indicates the starting and ending indexes of the places in the result which were identified to match the textQuery. This result is useful for providing emphasis to results where the user query directly matched to make selecting the correct result from a list easier for an end user.
SuggestFilter
Description
SuggestFilter structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
Members
- BoundingBox
-
- Type: Array of doubles
The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set 4 coordinates:
[{westward lng}, {southern lat}, {eastward lng}, {northern lat}] - Circle
-
- Type: FilterCircle structure
The
Circlethat all results must be in. - IncludeCountries
-
- Type: Array of strings
A list of countries that all results must be in. Countries are represented by either their alpha-2 or alpha-3 character codes.
SuggestHighlights
Description
Describes how the parts of the textQuery matched the input query by returning the sections of the response which matched to textQuery terms.
Members
- Address
-
- Type: SuggestAddressHighlights structure
The place's address.
- Title
-
- Type: Array of Highlight structures
Indicates the starting and ending index of the title in the text query that match the found title.
SuggestPlaceResult
Description
The suggested place results.
Members
- AccessPoints
-
- Type: Array of AccessPoint structures
Position of the access point represent by longitude and latitude.
- AccessRestrictions
-
- Type: Array of AccessRestriction structures
Indicates known access restrictions on a vehicle access point. The index correlates to an access point and indicates if access through this point has some form of restriction.
- Address
-
- Type: Address structure
The place's address.
- BusinessChains
-
- Type: Array of BusinessChain structures
The Business Chains associated with the place.
- Categories
-
- Type: Array of Category structures
Categories of results that results must belong to.
- Distance
-
- Type: long (int|float)
The distance in meters from the QueryPosition.
- FoodTypes
-
- Type: Array of FoodType structures
List of food types offered by this result.
- MapView
-
- Type: Array of doubles
The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set 4 coordinates:
[{westward lng}, {southern lat}, {eastward lng}, {northern lat}] - Phonemes
-
- Type: PhonemeDetails structure
How the various components of the result's address are pronounced in various languages.
- PlaceId
-
- Type: string
The
PlaceIdof the place you wish to receive the information for. - PlaceType
-
- Type: string
A
PlaceTypeis a category that the result place must belong to. - PoliticalView
-
- Type: string
The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
- Position
-
- Type: Array of doubles
The position, in longitude and latitude.
- TimeZone
-
- Type: TimeZone structure
The time zone in which the place is located.
SuggestQueryResult
Description
The suggested query results.
Members
- QueryId
-
- Type: string
QueryId can be used to complete a follow up query through the SearchText API. The QueryId retains context from the original Suggest request such as filters, political view and language. See the SearchText API documentation for more details SearchText API docs.
- QueryType
-
- Type: string
The query type. Category qeuries will search for places which have an entry matching the given category, for example "doctor office". BusinessChain queries will search for instances of a given business.
SuggestResultItem
Description
The resulting item from the suggested query.
Members
- Highlights
-
- Type: SuggestHighlights structure
Describes how the parts of the response element matched the input query by returning the sections of the response which matched to input query terms.
- Place
-
- Type: SuggestPlaceResult structure
The suggested place by its unique ID.
- Query
-
- Type: SuggestQueryResult structure
The suggested query results.
- SuggestResultItemType
-
- Required: Yes
- Type: string
The result type. Place results represent the final result for a point of interest, Query results represent a follow up query which can be completed through the SearchText operation.
- Title
-
- Required: Yes
- Type: string
The display title that should be used when presenting this option to the end user.
ThrottlingException
Description
The request was denied due to request throttling.
Members
- Message
-
- Required: Yes
- Type: string
TimeZone
Description
The time zone in which the place is located.
Members
- Name
-
- Required: Yes
- Type: string
The time zone name.
- Offset
-
- Type: string
Time zone offset of the timezone from UTC.
- OffsetSeconds
-
- Type: long (int|float)
The offset of the time zone from UTC, in seconds.
UspsZip
Description
The USPS zip code.
Members
- ZipClassificationCode
-
- Type: string
The ZIP Classification Code, or in other words what type of postal code is it.
UspsZipPlus4
Description
The USPS zip+4 code.
Members
- RecordTypeCode
-
- Type: string
The USPS ZIP+4 Record Type Code.
ValidationException
Description
The input fails to satisfy the constraints specified by an AWS service.
Members
- FieldList
-
- Required: Yes
- Type: Array of ValidationExceptionField structures
Test stub for FieldList.
- Message
-
- Required: Yes
- Type: string
- Reason
-
- Required: Yes
- Type: string
Test stub for reason
ValidationExceptionField
Description
The input fails to satisfy the constraints specified by the Amazon Location service.
Members
- Message
-
- Required: Yes
- Type: string
The error message.
- Name
-
- Required: Yes
- Type: string
The name of the resource.