- 2.47.0 (latest)
- 2.46.0
- 2.45.0
- 2.44.0
- 2.43.0
- 2.42.0
- 2.41.0
- 2.40.0
- 2.39.0
- 2.37.0
- 2.36.0
- 2.35.0
- 2.34.0
- 2.33.0
- 2.32.0
- 2.31.0
- 2.30.0
- 2.29.0
- 2.28.0
- 2.27.0
- 2.24.0
- 2.23.0
- 2.22.0
- 2.21.0
- 2.20.0
- 2.19.0
- 2.18.0
- 2.17.0
- 2.16.0
- 2.15.0
- 2.14.0
- 2.13.0
- 2.12.0
- 2.11.0
- 2.9.0
- 2.8.0
- 2.7.0
- 2.6.0
- 2.5.0
- 2.4.0
- 2.3.5
- 2.2.0
- 2.1.13
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 |