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 traductions d'adresses
<a name="how-to-geocode-translations"></a>

`AddressTranslations`vous permet de récupérer toutes les traductions de noms et les noms alternatifs des composants d'adresse dans toutes les langues disponibles. Vous spécifiez les composants d'adresse à traduire à l'aide du paramètre de `AddressTranslations` requête.

## Cas d'utilisation potentiels
<a name="geocode-translations-use"></a>
+ **Applications multilingues :** affichez les composants d'adresse dans plusieurs langues pour les utilisateurs internationaux.
+ **Localisation : affiche** à la fois les noms en langue locale et dans la langue préférée de l'utilisateur pour les villes et les régions.

## Exemples
<a name="geocode-translations-example"></a>

### Obtenez des traductions pour la localité et la région
<a name="geocode-translations-city-region"></a>

------
#### [ Sample request ]

```
{
    "QueryText": "1 Rue de Rivoli, Paris",
    "AddressTranslations": ["Locality", "Region"]
}
```

------
#### [ Sample response ]

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointAddress",
            "Title": "1 Rue de Rivoli, 75004 Paris, France",
            "Translations": {
                "Locality": [
                    {
                        "Names": [
                            {
                                "Value": "Paris",
                                "Language": "fr",
                                "Type": "BaseName",
                                "Primary": true
                            },
                            {
                                "Value": "Parigi",
                                "Language": "it",
                                "Type": "Exonym"
                            },
                            {
                                "Value": "パリ",
                                "Language": "ja",
                                "Type": "Exonym"
                            }
                        ],
                        "Preference": "Primary"
                    }
                ],
                "Region": [
                    {
                        "Names": [
                            {
                                "Value": "Île-de-France",
                                "Language": "fr",
                                "Type": "BaseName",
                                "Primary": true
                            },
                            {
                                "Value": "IDF",
                                "Language": "fr",
                                "Type": "Abbreviation"
                            }
                        ],
                        "Preference": "Primary"
                    }
                ]
            }
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/geocode?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryText": "1 Rue de Rivoli, Paris",
    "AddressTranslations": ["Locality", "Region"]
}'
```

------
#### [ AWS CLI ]

```
aws geo-places geocode --key ${YourKey} --query-text "1 Rue de Rivoli, Paris" --address-translations Locality Region
```

------

## Conseils aux développeurs
<a name="geocode-translations-dev-tips"></a>
+ Les valeurs valides pour `AddressTranslations` sont `District``Locality`,`Region`, et`SubRegion`.
+ Chaque traduction inclut un `Type` champ indiquant le type de variante de nom : `BaseName` (nom officiel)`Abbreviation`, `Exonym` (traduction dans une autre langue) ou`Synonym`. `Shortened`
+ Le `Primary` champ indique la variante de nom principale pour une langue donnée.