View a markdown version of this page

Como obter referências cruzadas para lugares - Amazon Location Service
Casos de uso possíveisExemplosDicas para o desenvolvedor

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Como obter referências cruzadas para lugares

CrossReferencespermite que você recupere identificadores de fornecedores terceirizados para locais, permitindo a correlação de lugares em sistemas externos, como Yelp e. TripAdvisor Você deve incluir CrossReferences no parâmetro de AdditionalFeatures solicitação.

Casos de uso possíveis

  • Enriquecimento de dados: combine locais do seu banco de dados com plataformas de avaliação de terceiros para exibir classificações e avaliações.

  • Cross-platform correlação: vincule registros de localização em vários sistemas usando identificadores de fornecedores compartilhados.

Exemplos

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

Dicas para o desenvolvedor

  • Cross-references só estão disponíveis para resultados de pontos de interesse (POI).

  • Nem todos os lugares têm referências cruzadas. O campo é omitido quando não há referências de fornecedores disponíveis.

  • O Source campo contém o nome do fornecedor terceirizado e SourcePlaceId contém o identificador usado por esse fornecedor.

  • Para usar os identificadores retornados, consulte a documentação da API do fornecedor. Por exemplo, veja a API do Yelp Places no site do Yelp ou a API de conteúdo do Tripadvisor no site do Tripadvisor.