기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 위치에 대한 교차 참조를 가져오는 방법
<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)를 참조하세요.