# How to reverse geocode in a specific language
<a name="how-to-reverse-geocode-specific-language"></a>

 The feature allows the selection of a preferred response language from BCP47-compliant codes. It detects the query language based on name variants and uses the preferred language for unmatched tokens and ambiguous cases. If no requested language, the **Places** API provides results in the official country language, but prioritizes the regional language in regions where it differs. As a fallback strategy, if any address elements are unavailable in the requested language, **Places** APIs return addresses in the default language.

## Potential use cases
<a name="potential-use-geocode-language"></a>

One potential use case is to localize the query and/or the result.

## Examples
<a name="reverse-geocode-language-examples"></a>

### Get result in a specific language
<a name="reverse-geocode-language-result"></a>

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

```
{
    "QueryPosition": [
                139.69172,
                35.6895
            ],
    "Language": "JA"
}
```

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

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointAddress",
            "Title": "2-8-1 Nishishinjuku, Shinjuku-ku, Tokyo 160-0023, Japan",
            "Address": {
                "Label": "2-8-1 Nishishinjuku, Shinjuku-ku, Tokyo 160-0023, Japan",
                "Country": {
                    "Code2": "JP",
                    "Code3": "JPN",
                    "Name": "Japan"
                },
                "Region": {
                    "Name": "Tokyo"
                },
                "SubRegion": {},
                "Locality": "Shinjuku-ku",
                "SubDistrict": "Nishishinjuku",
                "PostalCode": "160-0023",
                "Block": "2 Chome",
                "SubBlock": "8",
                "AddressNumber": "1"
            },
            "Position": [
                139.69171,
                35.68949
            ],
            "Distance": 1,
            "MapView": [
                139.69071,
                35.68861,
                139.69251,
                35.69048
            ],
            "AccessPoints": [
                {
                    "Position": [
                        139.69206,
                        35.68954
                    ]
                }
            ]
        }
    ]
}
```

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

```
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/reverse-geocode?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryPosition": [
                139.69172,
                35.6895
            ],
    "Language": "JA"
}'
```

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

```
aws geo-places reverse-geocode --key ${YourKey} --query-position 139.69172 35.6895 --language "JA"
```

------