Trying Out the New Features of Amazon Location Service Places: "Multilingual Addresses," "Travel Mode Optimization," and More
This page has been translated by machine translation. View original
Introduction
On July 10, 2026, several new features were added to the Places API of Amazon Location Service.
This article summarizes the main features added in this update by comparing them with the previous version.
| Feature | Old (before the update) | New (after the update) |
|---|---|---|
| Multilingual translation | Switch only one language with --language |
Retrieve multilingual variations for each address component in one go with --address-translations |
| Address name display control | Returns only normalized names | Choose between Matched / Administrative with --address-names-mode |
| Travel mode | None | Specify Car / Scooter / Truck with --travel-mode to optimize results |
| Drive-through attribute | None | DriveThrough is included in PlaceAttributes in the response |
| Additional address parsing info | ParsedQuery only |
Parsing.AdditionalInfo added (not returned in this verification) |
The support status of the new parameters and response attributes verified in this article is as follows.
| API | AddressTranslations | AddressNamesMode | TravelMode | DriveThrough (response) |
|---|---|---|---|---|
| Geocode | ✓ | ✓ | — | — |
| GetPlace | — | ✓ | — | ✓ |
| Suggest | — | — | ✓ | ✓ |
| SearchText | — | — | ✓ | ✓ |
| SearchNearby | — | — | — | ✓ |
- The "✓" for TravelMode indicates that the parameter can be specified. The effect on results varies depending on the API and search conditions. AddressNamesMode can also be used with ReverseGeocode.
Verification environment
- AWS CLI v2 (
aws geo-placessubcommand) - Region: ap-northeast-1 (Tokyo)
- Authentication: IAM (
geo-places:*permission) - IntendedUse: SingleUse (if you want to store results permanently, you need to specify
Storage)
AddressTranslations — Multilingual address translation
With --address-translations, you can retrieve multilingual variations of the specified address components in a single request. The components you can specify are the four types District, Locality, Region, and SubRegion (all can be specified at the same time).
We geocode the address of Hibiya Fort Tower (1-1-1 Nishishimbashi, Minato-ku, Tokyo) and retrieve translations for Locality (city/ward) and Region (prefecture).
aws geo-places geocode \
--query-text "東京都港区西新橋1-1-1 日比谷フォートタワー" \
--language ja \
--address-translations Locality Region \
--region ap-northeast-1 \
--no-cli-pager \
--output json
The multilingual variations of each component are returned in the Translations field of the response.
Here are the main ones excerpted from the translations of Locality (Minato Ward).
| Language code | Value | Type | Notes |
|---|---|---|---|
| ja | Minato Ward (Japanese script) | BaseName | Official name |
| ja | Minato (Japanese script) | Synonym | Abbreviation |
| ja-Hira | Minatoku (hiragana) | Exonym | Hiragana |
| ja-Kana | Minatoku (katakana) | Exonym | Katakana |
| ja-Latn | Minatoku | BaseName | Romanization (Transliterated: true) |
| en | Minato-ku | Exonym | English notation |
| en | Minato City | Exonym | English (city notation) |
| ko | Minato-gu (Korean script) | Exonym | Korean |
| zh | Minato Ward (Chinese script) | Exonym | Chinese (zh locale) |
| zh-Hant | Minato Ward (Traditional Chinese script) | Exonym | Traditional Chinese |
Translations for Region (Tokyo Metropolis) are returned in the same format.
| Language code | Value | Type |
|---|---|---|
| ja | Tokyo Metropolis (Japanese script) | BaseName |
| ja | Tokyo (Japanese script) | Synonym |
| ja-Hira | Toukyouto (hiragana) | Exonym |
| ja-Kana | Toukyouto (katakana) | Exonym |
| ja-Latn | Toukyouto | BaseName |
| en | Tokyo | Exonym |
| en | Tokyo Prefecture | Exonym |
| de | Präfektur Tokio | Exonym |
| ko | Tokyo-do (Korean script) | Exonym |
| zh | Tokyo Metropolis (Simplified Chinese script) | Exonym |
Full response (Translations part)
{
"Translations": {
"Locality": [
{
"Names": [
{"Value": "港区", "Language": "ja", "Type": "BaseName", "Primary": true},
{"Value": "港", "Language": "ja", "Type": "Synonym"},
{"Value": "みなとく", "Language": "ja-Hira", "Type": "Exonym"},
{"Value": "みなと", "Language": "ja-Hira", "Type": "Exonym"},
{"Value": "ミナトク", "Language": "ja-Kana", "Type": "Exonym"},
{"Value": "ミナト", "Language": "ja-Kana", "Type": "Exonym"},
{"Value": "Minatoku", "Language": "ja-Latn", "Type": "BaseName", "Primary": true, "Transliterated": true},
{"Value": "Minato", "Language": "ja-Latn", "Type": "Synonym", "Transliterated": true},
{"Value": "Minato-ku", "Language": "en", "Type": "Exonym"},
{"Value": "Minato City", "Language": "en", "Type": "Exonym"},
{"Value": "Minato Ward", "Language": "en", "Type": "Exonym"},
{"Value": "Minato", "Language": "en", "Type": "Exonym"},
{"Value": "미나토구", "Language": "ko", "Type": "Exonym"},
{"Value": "미나토", "Language": "ko", "Type": "Exonym"},
{"Value": "港区", "Language": "zh", "Type": "Exonym"},
{"Value": "港", "Language": "zh", "Type": "Exonym"},
{"Value": "港區", "Language": "zh-Hant", "Type": "Exonym"},
{"Value": "港", "Language": "zh-Hant", "Type": "Exonym"}
],
"Preference": "Primary"
}
],
"Region": [
{
"Names": [
{"Value": "東京都", "Language": "ja", "Type": "BaseName", "Primary": true},
{"Value": "東京", "Language": "ja", "Type": "Synonym"},
{"Value": "とうきょうと", "Language": "ja-Hira", "Type": "Exonym"},
{"Value": "とうきょう", "Language": "ja-Hira", "Type": "Exonym"},
{"Value": "トウキョウト", "Language": "ja-Kana", "Type": "Exonym"},
{"Value": "トウキョウ", "Language": "ja-Kana", "Type": "Exonym"},
{"Value": "Toukyouto", "Language": "ja-Latn", "Type": "BaseName", "Primary": true, "Transliterated": true},
{"Value": "Toukyou", "Language": "ja-Latn", "Type": "Synonym", "Transliterated": true},
{"Value": "Präfektur Tokio", "Language": "de", "Type": "Exonym"},
{"Value": "Tokio", "Language": "de", "Type": "Exonym"},
{"Value": "Tokyo", "Language": "en", "Type": "Exonym"},
{"Value": "Tokyo Prefecture", "Language": "en", "Type": "Exonym"},
{"Value": "도쿄도", "Language": "ko", "Type": "Exonym"},
{"Value": "도쿄", "Language": "ko", "Type": "Exonym"},
{"Value": "东京都", "Language": "zh", "Type": "Exonym"},
{"Value": "东京", "Language": "zh", "Type": "Exonym"}
],
"Preference": "Primary"
}
]
}
}
The main attributes confirmed in this response are as follows.
- Type:
BaseName(base name),Synonym(alternative name),Exonym(exonym: a name in another language/notation). In addition,Abbreviation(abbreviation),Shortened(shortened form), etc. may also be returned - Transliterated: When
true, it indicates that the conversion is by transliteration - Primary: The entry with
trueis the preferred notation in that language
We also tried a Berlin address. For Region (Berlin), translations in German, English, French, Chinese, Japanese (Berlin in katakana), Arabic, and others were returned.

It works the same way for a Vancouver address. For Region (British Columbia), French (Colombie-Britannique), Spanish (Columbia Británica), Chinese (the Chinese name of British Columbia), and others were returned.

AddressNamesMode — Controlling address name display
The --address-names-mode parameter was added to the Geocode API and the GetPlace API. In the Geocode API, you can control whether the names of address components (Locality, etc.) are returned as normalized names, names matching the input, or official administrative names. It can also be used with the GetPlace API, but as of now the only valid value in the API reference is Administrative.
We check the difference using Brooklyn in New York City. Brooklyn is administratively part of New York City (a borough), but as an address it is generally written as "Brooklyn, NY".
We deliberately enter an address in the Park Slope neighborhood of Brooklyn as "New York, NY" and check whether Matched mode returns a place name that matches the input text.
aws geo-places geocode \
--query-text "350 5th Av, New York, NY" \
--language en \
--address-names-mode Matched \
--region ap-northeast-1 \
--no-cli-pager \
--output json
These are the results of switching the --address-names-mode value between omitted (Default) / Matched / Administrative. The PlaceId and coordinates [-73.98423, 40.67199] are the same in all modes; only Locality and Title change.
| Mode | Locality | Title | Use case |
|---|---|---|---|
| Default (when omitted) | Brooklyn | 350 5th Ave, Brooklyn, NY 11215-2813, United States | Normalized place name. Suitable for general address notation |
| Matched | New York | 350 5th Ave, New York, NY 11215-2813, United States | Notation matching the user's input. Useful for highlighting search results, etc. |
| Administrative | New York | 350 5th Ave, New York, NY 11215-2813, United States | Higher-level administrative division name. Suitable for matching against administrative data |
TravelMode — Optimizing results by travel mode
When you specify a means of travel with --travel-mode, the relevance of search results is adjusted taking the travel mode into account. We search for "gas station" near Tokyo Station to check the effect.
This is an example command with --travel-mode Car added.
aws geo-places suggest \
--query-text "ガソリンスタンド" \
--bias-position "[139.7671,35.6812]" \
--travel-mode Car \
--language ja \
--region ap-northeast-1 \
--no-cli-pager \
--output json
We compare it with the case where --travel-mode is omitted.
The Suggest API returns not only POIs (store names) but also category candidates (QueryType=Category). Regardless of whether TravelMode is specified, the category candidate "gas station" is returned in first place, so we compare the POI results from second place onward.
| Rank | Without TravelMode | TravelMode=Car |
|---|---|---|
| 2 | ENEOS Dr.Drive Hongokucho SS | ENEOS Dr.Drive Hongokucho SS |
| 3 | ENEOS Dr.Drive Kayabacho SS | ENEOS Dr.Drive Kayabacho SS |
| 4 | ENEOS Dr.Drive Irifune-Sakuragawa SS | apollostation Self Nihonbashi SS |
| 5 | apollostation Self Nihonbashi SS | apollostation Self Hongo SS |
When Car is specified, Irifune-Sakuragawa SS (Irifune, Chuo-ku), which was in 4th place without TravelMode, falls out of the top 5, and apollostation Hongo SS (Hongo, Bunkyo-ku) enters the top ranks instead. The relevance adjustment by TravelMode is considered to be affecting the order of results.

DriveThrough attribute and FoodTypes/Categories filters
DriveThrough attribute
We check in the US and Japan whether DriveThrough is included in PlaceAttributes in the response.
We search for McDonald's in Dallas, Texas, USA.
aws geo-places search-text \
--query-text "McDonald's" \
--bias-position "[-96.797,32.7767]" \
--language en \
--max-results 5 \
--region ap-northeast-1 \
--no-cli-pager \
--output json
{
"Title": "McDonald's",
"Address": {
"Label": "McDonald's, 1000 Commerce St, Dallas, TX 75202-3716, United States"
},
"Categories": [{"Id": "fast_food", "LocalizedName": "Fast Food"}],
"FoodTypes": [
{"Id": "fast_food", "LocalizedName": "Fast Food"},
{"Id": "burgers", "LocalizedName": "Burgers"}
],
"PlaceAttributes": ["DriveThrough"]
}
PlaceAttributes: ["DriveThrough"] is returned.
On the other hand, when searching for McDonald's in Japan (using its Japanese name), DriveThrough could not be confirmed in PlaceAttributes, even in results that include drive-through-capable stores (such as the Yoga Interchange store).
aws geo-places search-text \
--query-text "マクドナルド" \
--bias-position "[139.7671,35.6812]" \
--language ja \
--max-results 5 \
--region ap-northeast-1 \
--no-cli-pager \
--output json
In this verification, the DriveThrough attribute was confirmed in US search results. On the other hand, in Japan, even for searches that include drive-through-capable stores, DriveThrough could not be confirmed in PlaceAttributes.

FoodTypes/Categories filters — Rich category data in Japan too
The DriveThrough attribute could not be confirmed in Japan in this verification, but the FoodTypes filter worked for locations in Japan as well. We search for burger restaurants near Yoga Station using the FoodTypes filter.
aws geo-places search-nearby \
--query-position "[139.6333,35.6264]" \
--max-results 10 \
--filter '{"IncludeFoodTypes": ["burgers"]}' \
--language ja \
--region ap-northeast-1 \
--no-cli-pager \
--output json
Freshness Burger, MOS Burger, McDonald's Yoga Interchange store, Shake Shack, and others were hit.

In a search specifying japanese-ramen near Nakano Station, "Dotonbori Kamukura Nakano Sun Mall store", "Hidakaya Nakano store", and others are hit.
aws geo-places search-nearby \
--query-position "[139.6659,35.7074]" \
--max-results 10 \
--filter '{"IncludeFoodTypes": ["japanese-ramen"]}' \
--language ja \
--region ap-northeast-1 \
--no-cli-pager \
--output json
Even within the range confirmed in the verification, detailed Japanese-cuisine subcategories were provided.
japanese-ramen(ramen)japanese-sushi(sushi)japanese-sushi_train(conveyor-belt sushi)japanese-izakaya(izakaya)japanese-yakiniku(yakiniku)japanese-yakitori/chicken(yakitori)japanese-tonkatsu(tonkatsu)japanese-udon/other_noodles(udon and other noodles)japanese-rice_bowl(rice bowl dishes)japanese-curry(curry)
Notes when specifying filters
The value passed to the filter must be specified by FoodTypes ID. Specifying by LocalizedName (Japanese name) results in a ValidationException. Available FoodTypes IDs can be checked in the FoodType list in the API reference.
# ❌ Specifying in Japanese → ValidationException
--filter '{"IncludeFoodTypes": ["ラーメン"]}'
# ✓ Specifying the FoodTypes ID
--filter '{"IncludeFoodTypes": ["japanese-ramen"]}'
On the other hand, when --language ja is specified, the LocalizedName in the response is returned in Japanese ("Japanese Food - Ramen", "Burgers", etc., in Japanese). The specification is asymmetric: the filter input is the FoodTypes ID, while the display name in the response is in the specified language.
Category distribution by area
By specifying --query-radius 3000 (3 km) to widen the SearchNearby search range, you can see that the category distribution differs depending on the area.
| Area | Characteristic categories | FoodTypes tendencies |
|---|---|---|
| Nakano Station (downtown) | karaoke, internet_cafe, gambling-lottery-betting | japanese-izakaya, japanese-sushi_train, korean, thai, indian |
| Yoga Station (residential area) | police_box, post_office, dry_cleaning_and_laundry, coaching_institute | burgers, fast_food, japanese-tonkatsu |
In this verification, the area near Nakano Station had high dining diversity, with izakaya, conveyor-belt sushi, and various international cuisines appearing, while the area near Yoga Station was dominated by daily-life infrastructure categories such as police boxes, post offices, and dry cleaners.
Summary
We verified the new features added to the Amazon Location Service Places API using the AWS CLI.
With AddressTranslations, we confirmed that multilingual notations in Japanese, English, Korean, Chinese, German, and more can be retrieved for each address component in a single request. With AddressNamesMode, using a Brooklyn address as an example, we confirmed that the notation of Locality and Title changes depending on the difference between Default / Matched / Administrative.
TravelMode can be used in Suggest and SearchText to adjust the relevance of search results taking the travel mode into account. In this verification, we were able to confirm ranking differences with the Suggest API in a gas station search near Tokyo Station.
The DriveThrough attribute was confirmed in US search results but not in search results in Japan. On the other hand, the FoodTypes filter and Categories in the response are usable for locations in Japan as well, and multiple Japanese-cuisine subcategories were confirmed.
With multilingual address display, control of address name display, search that considers travel mode, and restaurant category search, this was an update that lets you handle the search and display aspects of the Places API more flexibly.
Reference links
