本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 如何取得位置的交叉參考
<a name="how-to-search-cross-references"></a>

`CrossReferences` 可讓您擷取位置的第三方供應商識別符，讓 Yelp 和 TripAdvisor 等外部系統間的位置相互關聯。您必須在`AdditionalFeatures`請求參數`CrossReferences`中包含 。

## 潛在的使用案例
<a name="search-text-cross-references-use"></a>
+ **資料擴充：**將資料庫中的位置與第三方檢閱平台進行比對，以顯示評分和檢閱。
+ **跨平台相互關聯：**使用共用供應商識別符跨多個系統連結位置記錄。

## 範例
<a name="search-text-cross-references-example"></a>

### 取得餐廳的交叉參考
<a name="search-text-cross-references-restaurant"></a>

------
#### [ 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
```

------

## 開發人員秘訣
<a name="search-text-cross-references-dev-tips"></a>
+ 交叉參考僅適用於興趣點 (POI) 結果。
+ 並非所有位置都有交叉參考。當沒有可用的供應商參考時，會省略 欄位。
+ `Source` 欄位包含第三方供應商的名稱，並`SourcePlaceId`包含該供應商使用的識別符。
+ 若要使用傳回的識別符，請參閱供應商的 API 文件。例如，請參閱 [Yelp 網站上的 Yelp Places API](https://docs.developer.yelp.com/docs/places-intro) 或 [Tripadvisor 網站上的 Tripadvisor 內容 API](https://docs.terra.tripadvisor.com/docs/overview)。