Skip to main content

nearbies

Creates, updates, deletes, gets or lists a nearbies resource.

Overview

Namenearbies
TypeResource
Idaws.geo_places.nearbies

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
next_tokenstringIf nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page.
pricing_bucketstringThe pricing bucket for which the query is charged at. For more information on pricing, please visit Amazon Location Service Pricing.
result_itemsarrayList of places or results returned for a query.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
search_nearbyselectregionkeySearchNearby queries for points of interest within a radius from a central coordinates, returning place results with optional filters such as categories, business chains, food types and more. The API returns details such as a place name, address, phone, category, food type, contact, opening hours. Also, the API can return phonemes, time zones and more based on requested parameters. Not supported in ap-southeast-1 and ap-southeast-5 regions for GrabMaps customers. For more information, see Search Nearby in the Amazon Location Service Developer Guide.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)
keystringOptional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.

SELECT examples

SearchNearby queries for points of interest within a radius from a central coordinates, returning place results with optional filters such as categories, business chains, food types and more. The API returns details such as a place name, address, phone, category, food type, contact, opening hours. Also, the API can return phonemes, time zones and more based on requested parameters. Not supported in ap-southeast-1 and ap-southeast-5 regions for GrabMaps customers. For more information, see Search Nearby in the Amazon Location Service Developer Guide.

SELECT
next_token,
pricing_bucket,
result_items
FROM aws.geo_places.nearbies
WHERE region = '{{ region }}' -- required
AND key = '{{ key }}'
;