View a markdown version of this page

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

How to get cross-references for places

CrossReferences allows you to retrieve third-party supplier identifiers for places, enabling correlation of places across external systems such as Yelp and TripAdvisor. You must include CrossReferences in the AdditionalFeatures request parameter.

Potential use cases

  • Data enrichment: Match places from your database with third-party review platforms to display ratings and reviews.

  • Cross-platform correlation: Link place records across multiple systems using shared supplier identifiers.

Examples

Sample request
{
    "QueryText": "Canlis Seattle",
    "BiasPosition": [-122.3321, 47.6062],
    "AdditionalFeatures": ["CrossReferences"]
}
Sample response
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointOfInterest",
            "Title": "Canlis, Seattle, WA, United States",
            "CrossReferences": [
                {
                    "Source": "Yelp",
                    "SourcePlaceId": "canlis-seattle",
                    "SourceCategories": [
                        {
                            "Id": "100-1000-0000",
                            "Name": "Restaurant"
                        }
                    ]
                },
                {
                    "Source": "TripAdvisor",
                    "SourcePlaceId": "d590427",
                    "SourceCategories": [
                        {
                            "Id": "100-1000-0000",
                            "Name": "Restaurant"
                        }
                    ]
                }
            ]
        }
    ]
}
cURL
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-text?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryText": "Canlis Seattle",
    "BiasPosition": [-122.3321, 47.6062],
    "AdditionalFeatures": ["CrossReferences"]
}'
AWS CLI
aws geo-places search-text --key ${YourKey} --query-text "Canlis Seattle" --bias-position -122.3321 47.6062 --additional-features CrossReferences

Developer tips

  • Cross-references are only available for point of interest (POI) results.

  • Not all places have cross-references. The field is omitted when no supplier references are available.

  • The Source field contains the name of the third-party supplier, and SourcePlaceId contains the identifier used by that supplier.

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