Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Cara mendapatkan terjemahan alamat
<a name="how-to-geocode-translations"></a>

`AddressTranslations`memungkinkan Anda untuk mengambil semua terjemahan nama dan nama alternatif untuk komponen alamat dalam semua bahasa yang tersedia. Anda menentukan komponen alamat mana yang akan diterjemahkan menggunakan parameter `AddressTranslations` permintaan.

## Kasus penggunaan potensial
<a name="geocode-translations-use"></a>
+ **Aplikasi multibahasa:** Menampilkan komponen alamat dalam berbagai bahasa untuk pengguna internasional.
+ **Lokalisasi:** Tampilkan nama bahasa lokal dan bahasa pilihan pengguna untuk kota dan wilayah.

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

### Dapatkan terjemahan untuk lokalitas dan wilayah
<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
```

------

## Kiat pengembang
<a name="geocode-translations-dev-tips"></a>
+ Nilai yang valid untuk `AddressTranslations` are`District`,`Locality`,`Region`, dan`SubRegion`.
+ Setiap terjemahan menyertakan `Type` bidang yang menunjukkan jenis varian nama: `BaseName` (nama resmi),`Abbreviation`, `Exonym` (terjemahan ke bahasa lain)`Shortened`, atau`Synonym`.
+ `Primary`Bidang menunjukkan varian nama utama untuk bahasa tertentu.