Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Comment obtenir des références croisées pour des lieux
<a name="how-to-search-cross-references"></a>

`CrossReferences`vous permet de récupérer les identifiants de fournisseurs tiers pour les lieux, ce qui permet de corréler les lieux entre des systèmes externes tels que Yelp et. TripAdvisor Vous devez inclure `CrossReferences` dans le paramètre de `AdditionalFeatures` demande.

## Cas d'utilisation potentiels
<a name="search-text-cross-references-use"></a>
+ **Enrichissement des données :** associez les sites de votre base de données à des plateformes d'évaluation tierces pour afficher les notes et les avis.
+ **Cross-platform corrélation :** reliez les enregistrements de localisation entre plusieurs systèmes à l'aide d'identifiants fournisseurs partagés.

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

### Obtenez des références croisées pour un restaurant
<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
```

------

## Conseils aux développeurs
<a name="search-text-cross-references-dev-tips"></a>
+ Cross-references ne sont disponibles que pour les résultats des points d'intérêt (POI).
+ Tous les lieux ne comportent pas de références croisées. Le champ est omis lorsqu'aucune référence fournisseur n'est disponible.
+ Le `Source` champ contient le nom du fournisseur tiers et `SourcePlaceId` l'identifiant utilisé par ce fournisseur.
+ Pour utiliser les identifiants renvoyés, reportez-vous à la documentation de l'API du fournisseur. Par exemple, consultez l'API [Yelp Places sur le site Web de Yelp ou l'API](https://docs.developer.yelp.com/docs/places-intro) de [contenu Tripadvisor](https://docs.terra.tripadvisor.com/docs/overview) sur le site Web de Tripadvisor.