com.google.cloud.translate

Interface Translate

All Superinterfaces:

Service<TranslateOptions>

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

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	Translate.LanguageListOption Class for specifying supported language listing options.
static class	Translate.TranslateOption Class for specifying translate options.

Method Summary

Modifier and Type	Method and Description
List<Detection>	detect(List<String> texts) Detects the language of the provided texts.
List<Detection>	detect(String... texts) Detects the language of the provided texts.
Detection	detect(String text) Detects the language of the provided text.
List<Language>	listSupportedLanguages(Translate.LanguageListOption... options) Returns the list of languages supported by Google Translation.
List<Translation>	translate(List<String> texts, Translate.TranslateOption... options) Translates the provided texts.
Translation	translate(String text, Translate.TranslateOption... options) Translates the provided text.

Methods inherited from interface com.google.cloud.Service

getOptions

Method Detail

listSupportedLanguages

List<Language> listSupportedLanguages(Translate.LanguageListOption... options)

Returns the list of languages supported by Google Translation. If an option from Translate.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\n", 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\n", language.getName(), language.getCode());
 }
 

detect

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("\t%s\n", detection);
 }
 

Parameters:

texts - the texts for which language should be detected

Returns:

a list of objects containing information on the language detection, one for each provided text, in order

detect

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!");
 

Parameters:

texts - the texts for which language should be detected

Returns:

a list of objects containing information on the language detection, one for each provided text, in order

detect

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!");
 

translate

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:

texts - the texts to translate

Returns:

a list of objects containing information on the language translation, one for each provided text, in order

Throws:

TranslateException - upon failure or if Translate.TranslateOption.model(String) is used by a non-whitelisted user

translate

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:\n\t%s\n", 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:\nText: %s\n",
     translation.getTranslatedText());
 

Parameters:

text - the text to translate

Returns:

an object containing information on the language translation

Throws:

TranslateException - upon failure or if Translate.TranslateOption.model(String) is used by a non-whitelisted user