翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 場所の相互参照を取得する方法
<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 Content API](https://docs.terra.tripadvisor.com/docs/overview) を参照してください。