Internationalization¶

Encoding

The G Adventures API is UTF-8 encoded for both requests and responses. Request headers with an Accept-Charset set to anything other than utf-8 will be rejected with an HTTP status code of 406.

Language

The G Adventures API currently supports the following languages:

• Chinese Simplified (简体中文) zh-hans

• Chinese Traditional (繁體中文) zh-hant

• Danish (Dansk) da

• Dutch (Nederlands) nl

• English en

• French (Français) fr

• German (Deutsch) de

• Italian (Italiano) it

• Japanese (日本語) ja

• Korean (한국어) ko

• Norwegian (Norsk) no

• Portuguese (Português) pt

• Spanish (Español) es

• Swedish (Svenska) sv

The two-character form of each language can be specified by setting the Accept-Language in the HTTP request header when making requests to the API.

The coverage of our language support is divided into a few categories, and support for a language does not necessarily mean all content is translated. The primary items we translate in the G Adventures API are itineraries and tour dossiers. Coverage is as follows:

• German has the short Itinerary information for all products. There may not be full translations for all full itineraries, or related addons on any particular Itinerary.

• French and Dutch have a majority of Itinerary information translated. Like with German, it’s generally the short itinerary information.

• Italian and Spanish, have about 240 itineraries translated.

• Japanese, both forms of Chinese, and Korean have a limited, but growing number of Itineraries translated.

When there is no translation for a specific piece of content in the language requested, we fall back to English.

Any Accept-Language header content sent that doesn’t exist will return a 406 error. If no Accept-Language is specified, then en will be the default return. If a valid, non en Accept-Language header is provided for searchable/listable resources _AND_ if no matches are found for the original language requested, GAPI will fallback to searching our en data index to try and return a matching response.