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 |