Translate

Examples

const {Translate} = require('@google-cloud/translate');

const translate = new Translate();

//-
// Detect the language from a single string input.
//-
translate.detect('Hello', (err, results) => {
  if (!err) {
    // results = {
    //   language: 'en',
    //   confidence: 1,
    //   input: 'Hello'
    // }
  }
});

//-
// Detect the languages used in multiple strings. Note that the results are
// now provided as an array.
//-
translate.detect([
  'Hello',
  'Hola'
], (err, results) => {
  if (!err) {
    // results = [
    //   {
    //     language: 'en',
    //     confidence: 1,
    //     input: 'Hello'
    //   },
    //   {
    //     language: 'es',
    //     confidence: 1,
    //     input: 'Hola'
    //   }
    // ]
  }
});

//-
// If the callback is omitted, we'll return a Promise.
//-
translate.detect('Hello').then((data) => {
  const results = data[0];
  const apiResponse = data[2];
});

Here's a full example:

  // Imports the Google Cloud client library
  const {Translate} = require('@google-cloud/translate').v2;

  // Creates a client
  const translate = new Translate();

  /**
   * TODO(developer): Uncomment the following line before running the sample.
   */
  // const text = 'The text for which to detect language, e.g. Hello, world!';

  // Detects the language. "text" can be a string for detecting the language of
  // a single piece of text, or an array of strings for detecting the languages
  // of multiple texts.
  async function detectLanguage() {
    let [detections] = await translate.detect(text);
    detections = Array.isArray(detections) ? detections : [detections];
    console.log('Detections:');
    detections.forEach(detection => {
      console.log(`${detection.input} => ${detection.language}`);
    });
  }

  detectLanguage();

Examples

Gets the language names in English:

  // Imports the Google Cloud client library
  const {Translate} = require('@google-cloud/translate').v2;

  // Creates a client
  const translate = new Translate();

  async function listLanguages() {
    // Lists available translation language with their names in English (the default).
    const [languages] = await translate.getLanguages();

    console.log('Languages:');
    languages.forEach(language => console.log(language));
  }

  listLanguages();

Gets the language names in a language other than English:

  // Imports the Google Cloud client library
  const {Translate} = require('@google-cloud/translate').v2;

  // Creates a client
  const translate = new Translate();

  /**
   * TODO(developer): Uncomment the following line before running the sample.
   */
  // const target = 'The target language for language names, e.g. ru';

  async function listLanguagesWithTarget() {
    // Lists available translation language with their names in a target language
    const [languages] = await translate.getLanguages(target);

    console.log('Languages:');
    languages.forEach(language => console.log(language));
  }

  listLanguagesWithTarget();

Examples

//-
// Pass a string and a language code to get the translation.
//-
translate.translate('Hello', 'es', (err, translation) => {
  if (!err) {
    // translation = 'Hola'
  }
});

//-
// The source language is auto-detected by default. To manually set it,
// provide an object.
//-
const options = {
  from: 'en',
  to: 'es'
};

translate.translate('Hello', options, (err, translation) => {
  if (!err) {
    // translation = 'Hola'
  }
});

//-
// Translate multiple strings of input. Note that the results are
// now provided as an array.
//-
const input = [
  'Hello',
  'How are you today?'
];

translate.translate(input, 'es', (err, translations) => {
  if (!err) {
    // translations = [
    //   'Hola',
    //   'Como estas hoy?'
    // ]
  }
});

//-
// If the callback is omitted, we'll return a Promise.
//-
translate.translate('Hello', 'es').then((data) => {
  const translation = data[0];
  const apiResponse = data[1];
});

Full translation example:

  // Imports the Google Cloud client library
  const {Translate} = require('@google-cloud/translate').v2;

  // Creates a client
  const translate = new Translate();

  /**
   * TODO(developer): Uncomment the following lines before running the sample.
   */
  // const text = 'The text to translate, e.g. Hello, world!';
  // const target = 'The target language, e.g. ru';

  async function translateText() {
    // Translates the text into the target language. "text" can be a string for
    // translating a single piece of text, or an array of strings for translating
    // multiple texts.
    let [translations] = await translate.translate(text, target);
    translations = Array.isArray(translations) ? translations : [translations];
    console.log('Translations:');
    translations.forEach((translation, i) => {
      console.log(`${text[i]} => (${target}) ${translation}`);
    });
  }

  translateText();

Translation using the premium model:

  // Imports the Google Cloud client library
  const {Translate} = require('@google-cloud/translate').v2;

  // Creates a client
  const translate = new Translate();

  /**
   * TODO(developer): Uncomment the following lines before running the sample.
   */
  // const text = 'The text to translate, e.g. Hello, world!';
  // const target = 'The target language, e.g. ru';
  // const model = 'The model to use, e.g. nmt';

  async function translateTextWithModel() {
    const options = {
      // The target language, e.g. "ru"
      to: target,
      // Make sure your project is on the allow list.
      // Possible values are "base" and "nmt"
      model: model,
    };

    // Translates the text into the target language. "text" can be a string for
    // translating a single piece of text, or an array of strings for translating
    // multiple texts.
    let [translations] = await translate.translate(text, options);
    translations = Array.isArray(translations) ? translations : [translations];
    console.log('Translations:');
    translations.forEach((translation, i) => {
      console.log(`${text[i]} => (${target}) ${translation}`);
    });
  }

  translateTextWithModel();