Language Support

Supported languages for Localities API results and regional language availability.

  1. Language Support in Localities API

Language Support in Localities API

The Localities API supports multiple languages for location names, addresses, and administrative divisions. Language availability depends on the region and the specific location data available.

Supported Languages

The API uses ISO 639-1 alpha-2 codes to specify languages. The following languages are supported:

Regional Language Availability

Language support is regional. While English (en) is available as a common fallback, the service also includes support for many local languages. The table below outlines the primary languages supported by region.

Region Primary Languages Supported
Europe en, fr, de, es, it, nl, ru
The Americas en, es, fr
Asia Pacific en, zh, ja, ko, hi
Middle East & Africa en, ar, fr, pt

How Language is Determined

You can specify the language in your request using the language parameter in Autocomplete and Geocoding requests:

Shell
        # Request results in French
?language=fr

# Request results in Chinese
?language=zh

    

The Localities API determines the language of the results using the following priority:

  1. language Parameter: If the language parameter is supplied in the request, the API will use it.
  2. Accept-Language Header: If the language parameter is not supplied, the API will check for the browser’s or client’s Accept-Language header and use the first known language from it.
  3. Default Language: If neither the parameter nor the header provides a supported language, the service defaults to English.

Important Notes

Questions About Language Support

If you have questions about language availability in specific countries or regions, please contact support or check the API Reference for the most current information.

Was this article helpful?
Have more questions? Submit a request