View a markdown version of this page

How to get cross-references for nearby places - Amazon Location Service
Potential use casesExamplesDeveloper tips

How to get cross-references for nearby places

Include CrossReferences in the AdditionalFeatures parameter to retrieve third-party supplier identifiers for each nearby place result.

Potential use cases

  • Review integration: Display third-party ratings alongside nearby search results.

  • Data matching: Correlate nearby places with records in external databases.

Examples

Sample request
{
    "QueryPosition": [-122.3321, 47.6062],
    "QueryRadius": 1000,
    "Filter": {
        "IncludeCategories": ["100-1000-0000"]
    },
    "AdditionalFeatures": ["CrossReferences"]
}
Sample response
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointOfInterest",
            "Title": "Pike Place Chowder, Seattle, WA",
            "CrossReferences": [
                {
                    "Source": "Yelp",
                    "SourcePlaceId": "pike-place-chowder-seattle"
                }
            ],
            "Distance": 245
        }
    ]
}
cURL
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-nearby?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryPosition": [-122.3321, 47.6062],
    "QueryRadius": 1000,
    "Filter": {
        "IncludeCategories": ["100-1000-0000"]
    },
    "AdditionalFeatures": ["CrossReferences"]
}'
AWS CLI
aws geo-places search-nearby --key ${YourKey} --query-position -122.3321 47.6062 --query-radius 1000 --filter '{"IncludeCategories": ["100-1000-0000"]}' --additional-features CrossReferences

Developer tips

  • To use the returned identifiers, refer to the supplier's API documentation. For example, see the Yelp Places API on the Yelp website or the Tripadvisor Content API on the Tripadvisor website.