Places (Search) API Developer's Guide


Where possible, the Places (Search) API attempts to present the response data in a language specified by the Accept-Language request header.

According to the HTTP 1.1 specification, the Accept-Language header should contain the user's language preferences which the API uses to select the best available translation for the resource information. The sections below describe in more detail how these preferences influence the response.


Content such as reviews, editorials, and extended attributes of a place are returned in the requested language if translations are available in that language. If there are no translations available, the Places (Search) API falls back to the next best alternative, according to the chosen preferences.

The API aggregates content from different sources. Depending on the availability of translations for each content source, a resource may contain content in different languages. In this case, the API makes a selection that best matches the user's request given the available content.

Place Names and Addresses

Where available, exonyms of place names and addresses are returned. For example, if a user's preferred language is English, search results containing places in Munich have addresses using the names Munich, Germany instead of München, Deutschland.

If a place, for example in Munich, Germany, has an alternative name in English, the English name is returned as the place name and the original name is present in the alternativeNames attribute.

Addresses and vicinity in search result items are formatted according to the locality of the place.

Labels and Ready-to-Display Strings

Labels, category names and ready-to-display strings such the attribution attribute are translated into the requested language, if a translation is available. Otherwise the default is English. Currently, there are translations available for the following languages:

Table 1. Translation languages
Language name Accept-Language header value
Afrikaans af-ZA
Albanian sq-AL
Arabic ar-SA
Azeri (Latin) az-Latn-AZ
Basque eu-ES
Belarusian be-BY
Bulgarian bg-BG
Catalan ca-ES
Chinese (China) zh-CN
Chinese (Taiwan) zh-TW
Croatian hr-HR
Czech cs-CZ
Danish da-DK
Dutch nl-NL
English (British) en-GB
English (United States) en-US
Estonian et-EE
Farsi fa-IR
Filipino tl, fil, fil-PH
Finnish fi-FI
French fr-FR
French (Canada) fr-CA
Galician gl-ES
German de-DE
Greek el-GR
Hausa ha-Latn-NG
Hebrew he-IL
Hindi hi-IN
Hungarian hu-HU
Indonesian (Bahasa) id-ID
Italian it-IT
Japanese ja-JP
Kazakh kk-KZ
Korean ko-KR
Latvian lv-LV
Lithuanian lt-LT
Macedonian mk-MK
Malay (Bahasa) ms-MY
Norwegian (Bokmål) no, nb, nb-NO
Polish pl-PL
Portuguese (Brazil) pt-BR
Portuguese (Portugal) pt-PT
Romanian ro-RO
Russian ru-RU
Serbian (Latin) sr-Latn-CS
Slovak sk-SK
Slovenian sl-SI
Spanish (Mexico) es-MX
Spanish (Spain) es-ES
Swedish sv-SE
Thai th-TH
Turkish tr-TR
Ukrainian uk-UA
Uzbek (Latin) uz-Latn-UZ
Vietnamese vi-VN