Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# So erhalten Sie Adressübersetzungen
<a name="how-to-geocode-translations"></a>

`AddressTranslations`ermöglicht es Ihnen, alle Namensübersetzungen und alternativen Namen für Adresskomponenten in allen verfügbaren Sprachen abzurufen. Mithilfe des `AddressTranslations` Anforderungsparameters geben Sie an, welche Adresskomponenten übersetzt werden sollen.

## Mögliche Anwendungsfälle
<a name="geocode-translations-use"></a>
+ **Mehrsprachige Anwendungen:** Zeigen Sie Adresskomponenten in mehreren Sprachen für internationale Benutzer an.
+ **Lokalisierung:** Zeigt sowohl Namen in der Landessprache als auch in der vom Benutzer bevorzugte Sprache für Städte und Regionen an.

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

### Holen Sie sich Übersetzungen für Ort und Region
<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
```

------

## Tipps für Entwickler
<a name="geocode-translations-dev-tips"></a>
+ Gültige Werte für `AddressTranslations` sind `District``Locality`,`Region`, und`SubRegion`.
+ Jede Übersetzung enthält ein `Type` Feld, das die Art der Namensvariante angibt: `BaseName` (offizieller Name),`Abbreviation`, `Exonym` (Übersetzung in eine andere Sprache),`Shortened`, oder`Synonym`.
+ Das `Primary` Feld gibt die primäre Namensvariante für eine bestimmte Sprache an.