Package com.google.cloud.translate

Interface Translate

  • All Superinterfaces:
    com.google.cloud.Service<TranslateOptions>
    public interface Translate
extends com.google.cloud.Service<TranslateOptions>
    An interface for Google Translation. Translate and its Option classes can be used concurrently without external synchronizations.
    See Also:
    Google Translation

    • 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