View a markdown version of this page

Comment obtenir des traductions d'adresses - Amazon Location Service
Cas d'utilisation potentielsExemplesConseils aux développeurs

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

AddressTranslationsvous 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

  • 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

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

  • Les valeurs valides pour AddressTranslations sont DistrictLocality,Region, etSubRegion.

  • Chaque traduction inclut un Type champ indiquant le type de variante de nom : BaseName (nom officiel)Abbreviation, Exonym (traduction dans une autre langue) ouSynonym. Shortened

  • Le Primary champ indique la variante de nom principale pour une langue donnée.