ATLAS

Translations

ATDW is excited to announce the integration of machine translation technology to translate the ATDW profiles into 10 different languages.


This guide will inform and assist distributors regarding the available languages, what content is translated and how the translated profile content is made available in different endpoints so, these can be consumed and displayed as required on the distributor websites.

Note

  • ATDW has taken the initiative to perform a one-off bulk translation of all current live ATDW profiles.
  • The translations are being released in stages and will be made available in the API as we progress through each stages.
  • Translations that are not yet avaliable will return English as the fallback language.
  • The on-going translations of new or updated content made by the tourism operator is on pilot trial for 3 months.

Available Languages

ATDW profiles have been translated in the following 10 different languages.

The "language code" in the table below must be passed in the ATDW API request to return the translations in the specified language.


Language Language Code
Chinese Simplified CHINESE-S
Chinese Traditional CHINESE-T
German GERMAN
French FRENCH
Japanese JAPANESE
Italian ITALIAN
Korean KOREAN
Portuguese PORT-EUR
Spanish SPAN-EUR
Indonesian INDONESIAN

Translated Contents (fields)

Following is the high-level information on what contents (fields) within a profile are translated:

  • In Scope
    • Product-level including admin fields
    • Product-level deals and offers fields
    • Service-level fields
  • Out of Scope
    • Service-level deals and offers fields

The following table shows the detailed information on fields that returns the translated contents:

Translation Content Standards


API Endpoints

Please see below the usage for each API endpoint.

Note:

  • To return translations, use the request parameter - "mv=language_code". Mv refers to market variant (
  • Refer "Available Languages" above for the correct language code to pass in the API request.
  • Only one language per request allowed i.e., comma separated language code not allowed in the request parameter.

Search API

API Request https://atlas.atdw-online.com.au/api/atlas/products?key=YOUR_KEY&mv=JAPANESE&order=lang
Definition Return all profiles in Japanese language sorting by profiles with translations at the top of the search results.
Additional Info
  • The Search API returns high-level information of the profiles only so, not all translated contents are returned in the Search API endpoint.
  • The "order=lang" request parameter returns all the translated content at the top of the search results. Profiles yet to be translated will be returned in English which is the fallback language.
  • The Search API filter - field list can be used to return translations for short description, attributes, etc.
  • Make use of the pagination and output formatting as required.
  • The API response use the same field to toggle the display between English and the translated content.

Get Product API

API Request https://atlas.atdw-online.com.au/api/atlas/product?key=YOUR_KEY&productid=56b26d1f2880253d74c53903&mv=JAPANESE
Definition Return detailed information of a specific profile with the ID: 56b26d1f2880253d74c53903 (name: The Louise) in Japanese.
Additional Info
  • The Get Product API returns detailed information of a specific profile and high-level information of all service(s) applicable to the profile.
  • The translated contents are returned in a separate field that ends with "mv" alongside the English content.
    • For example, "product_name" returns the English content and "product_name_mv" returns the translated content in the language requested.
  • In addition, the "product comments" field in the API response returns all available language translation for the profile description only.
  • Translations for the product-level Deals (if exists) are returned within the Get Product API response.

Get Service API

API Request https://atlas.atdw-online.com.au/api/atlas/productservice?key=YOUR_KEY&productid=56b26d1f2880253d74c53903&serviceid=57561b16025a70d7471f75f5&mv=JAPANESE
Definition Return detailed information of a specific service with the ID: 57561b16025a70d7471f75f5 (name: 2 Bedroom Premium Suite) in Japanese that belongs to the profile - "The Louise" (id: 56b26d1f2880253d74c53903).
Additional Info
  • The Get Service API returns detailed information of a specific service that belong to a profile. Service is applicable to Accommodation, Hire, Journey, Tour and Transport categories only.
  • The translated contents are returned in a separate field that ends with "mv" alongside the English content.
    • For example, "service_name" returns the English content and "service_name_mv" returns the translated content in the language requested.
  • The "service comments" field in the API response returns all available language translation for the service description only.
  • Translations for the service-level Deals (if exists) are returned within the Get Service API response.

Static API

API Request Categories: https://atlas.atdw-online.com.au/api/atlas/categories?key=YOUR_KEY&mv=JAPANESE
Classifications: https://atlas.atdw-online.com.au/api/atlas/producttypes?key=YOUR_KEY&cats=accomm,attraction&mv=JAPANESE
Attribute Types: https://atlas.atdw-online.com.au/api/atlas/attributetypes?key=YOUR_KEY&mv=JAPANESE
Attributes: https://atlas.atdw-online.com.au/api/atlas/attributes?key=YOUR_KEY&types=INDIGENOUS,INTERNET&mv=JAPANESE
Definition Return translations for all the static content - Categories, Classifications, Attribute Types and Attributes.
Additional Info
  • The static content is created by ATDW to support the content curation and these are not supplied by the Tourism Operators/Profile Owners.
  • The API response use the same field to toggle the display between English and the translated content.
  • ATDW periodically reviews and add/modify/remove the static contents. Until the translations are available for these, the English content will be displayed as the fallback language.




For further information please contact [email protected] for support.