Interface Translate (2.21.0)

public interface Translate extends Service<TranslateOptions>

An interface for Google Translation. Translate and its Option classes can be used concurrently without external synchronizations. See Also: Google Translation

Implements

com.google.cloud.Service<com.google.cloud.translate.TranslateOptions>

Methods

detect(String text)

public abstract Detection detect(String text)

Detects the language of the provided text. Returns an object containing information on the language detection.

Example of detecting the language of a text:


 Detection detection = translate.detect("Hello, World!");

Parameter
Name	Description
`text`	`String`

Returns
Type	Description
`Detection`

detect(String[] texts)

public abstract List<Detection> detect(String[] texts)

Detects the language of the provided texts.

Example of detecting the language of some texts:


 List<Detection> detections = translate.detect("Hello, World!", "¡Hola Mundo!");

Parameter
Name	Description
`texts`	`String[]` the texts for which language should be detected

Returns
Type	Description
`List<Detection>`	a list of objects containing information on the language detection, one for each provided text, in order

detect(List<String> texts)

public abstract List<Detection> detect(List<String> texts)

Detects the language of the provided texts.

Example of detecting the language of some texts:


 // TODO(developer): Uncomment these lines.
 // import com.google.cloud.translate.*;
 // Translate translate = TranslateOptions.getDefaultInstance().getService();

 List<String> texts = new LinkedList<>();
 texts.add("Hello, World!");
 texts.add("¡Hola Mundo!");
 List<Detection> detections = translate.detect(texts);

 System.out.println("Language(s) detected:");
 for (Detection detection : detections) {
   System.out.printf("  %s
", detection);
 }

Parameter
Name	Description
`texts`	`List<String>` the texts for which language should be detected

Returns
Type	Description
`List<Detection>`	a list of objects containing information on the language detection, one for each provided text, in order

listSupportedLanguages(Translate.LanguageListOption[] options)

public abstract List<Language> listSupportedLanguages(Translate.LanguageListOption[] options)

Returns the list of languages supported by Google Translation. If an option from LanguageListOption#targetLanguage(String) is provided, the value of Language#getName() is localized according to the provided target language. If no such option is passed, the value of Language#getName() is localized according to TranslateOptions#getTargetLanguage().

Example of listing supported languages, localized according to TranslateOptions#getTargetLanguage():


 // TODO(developer): Uncomment these lines.
 // import com.google.cloud.translate.*;
 // Translate translate = TranslateOptions.getDefaultInstance().getService();

 List<Language> languages = translate.listSupportedLanguages();

 for (Language language : languages) {
   System.out.printf("Name: %s, Code: %s
", language.getName(), language.getCode());
 }

Example of listing supported languages, localized according to a provided language:


 // TODO(developer): Uncomment these lines.
 // import com.google.cloud.translate.*;
 // Translate translate = TranslateOptions.getDefaultInstance().getService();

 List<Language> languages = translate.listSupportedLanguages(
         Translate.LanguageListOption.targetLanguage("es"));

 for (Language language : languages) {
   System.out.printf("Name: %s, Code: %s
", language.getName(), language.getCode());
 }

Parameter
Name	Description
`options`	`LanguageListOption[]`

Returns
Type	Description
`List<Language>`

translate(String text, Translate.TranslateOption[] options)

public abstract Translation translate(String text, Translate.TranslateOption[] options)

Translates the provided text.

Example of translating a text:


 // TODO(developer): Uncomment these lines.
 // import com.google.cloud.translate.*;
 // Translate translate = TranslateOptions.getDefaultInstance().getService();

 Translation translation = translate.translate("¡Hola Mundo!");
 System.out.printf("Translated Text:
    %s
", translation.getTranslatedText());

Example of translating a text, specifying source and target language and premium model:


 Translation translation = translate.translate(
     "Hola Mundo!",
     Translate.TranslateOption.sourceLanguage("es"),
     Translate.TranslateOption.targetLanguage("de"),
     // Use "base" for standard edition, "nmt" for the premium model.
     Translate.TranslateOption.model("nmt"));

 System.out.printf(
     "TranslatedText:
Text: %s
",
     translation.getTranslatedText());

Parameters
Name	Description
`text`	`String` the text to translate
`options`	`TranslateOption[]`

Returns
Type	Description
`Translation`	an object containing information on the language translation

translate(List<String> texts, Translate.TranslateOption[] options)

public abstract List<Translation> translate(List<String> texts, Translate.TranslateOption[] options)

Translates the provided texts.

Example of translating some texts:


 List<String> texts = new LinkedList<>();
 texts.add("Hello, World!");
 texts.add("¡Hola Mundo!");
 List<Translation> translations = translate.translate(texts);

Example of translating some texts, specifying source and target language:


 List<String> texts = new LinkedList<>();
 texts.add("¡Hola Mundo!");
 List<Translation> translations = translate.translate(
     texts,
     Translate.TranslateOption.sourceLanguage("es"),
     Translate.TranslateOption.targetLanguage("de"));

Parameters
Name	Description
`texts`	`List<String>` the texts to translate
`options`	`TranslateOption[]`

Returns
Type	Description
`List<Translation>`	a list of objects containing information on the language translation, one for each provided text, in order