org.apache.tika.language.translate

Class GoogleTranslator

java.lang.Object

org.apache.tika.language.translate.GoogleTranslator

All Implemented Interfaces:

Translator

public class GoogleTranslator
extends Object
implements Translator

An implementation of a REST client to the Google Translate v2 API. Based on the great tutorial from hayageek.com. Set your API key in translator.google.properties.

Constructor Summary

Constructors

Constructor and Description
GoogleTranslator()

Method Summary

Methods

Modifier and Type	Method and Description
boolean	isAvailable()
String	translate(String text, String targetLanguage) Translate text to the given language.
String	translate(String text, String sourceLanguage, String targetLanguage) Translate text between given languages.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GoogleTranslator

public GoogleTranslator()

Method Detail

translate

public String translate(String text,
               String sourceLanguage,
               String targetLanguage)
                 throws Exception

Description copied from interface: Translator

Translate text between given languages. The following languages are supported: Arabic("ar"), Bulgarian("bg"), Catalan("ca"), Chinese-Simplified("zh-CHS"), Chinese-Traditional("zh-CHT"), Czech("cs"), Danish("da"), Dutch("nl"), English("en"), Estonian("et"), Innish("fi"), French("fr"), German("de"), Greek("el"), Haitian-Creole("ht"), Hebrew("he"), Hindi("hi"), Hmong-Daw("mww"), Hungarian("hu"), Indonesian("id"), Italian("it"), Japanese("ja"), Korean("ko"), Latvian("lv"), Lithuanian("lt"), Malay("ms"), Norwegian("no"), Persian("fa"), Polish("pl"), Portuguese("pt"), Romanian("ro"), Russian("ru"), Slovak("sk"), Slovenian("sl"), Spanish("es"), Swedish("sv"), Thai("th"), Turkish("tr"), Ukranian("uk"), Urdu("ur"), Vietnemese("vi").

Specified by:

translate in interface Translator

Parameters:

text - The text to translate.

sourceLanguage - The input text language (for example, "en").

targetLanguage - The desired language to translate to (for example, "fr").

Returns:

The translation result. If translation is unavailable, returns the same text back.

Throws:

Exception - When there is an error with the API call.

translate

public String translate(String text,
               String targetLanguage)
                 throws Exception

Description copied from interface: Translator

Translate text to the given language. This method attempts to auto-detect the source language of the text. The following languages are supported: Arabic("ar"), Bulgarian("bg"), Catalan("ca"), Chinese-Simplified("zh-CHS"), Chinese-Traditional("zh-CHT"), Czech("cs"), Danish("da"), Dutch("nl"), English("en"), Estonian("et"), Innish("fi"), French("fr"), German("de"), Greek("el"), Haitian-Creole("ht"), Hebrew("he"), Hindi("hi"), Hmong-Daw("mww"), Hungarian("hu"), Indonesian("id"), Italian("it"), Japanese("ja"), Korean("ko"), Latvian("lv"), Lithuanian("lt"), Malay("ms"), Norwegian("no"), Persian("fa"), Polish("pl"), Portuguese("pt"), Romanian("ro"), Russian("ru"), Slovak("sk"), Slovenian("sl"), Spanish("es"), Swedish("sv"), Thai("th"), Turkish("tr"), Ukranian("uk"), Urdu("ur"), Vietnemese("vi").

Specified by:

translate in interface Translator

Parameters:

text - The text to translate.

targetLanguage - The desired language to translate to (for example, "hi").

Returns:

The translation result. If translation is unavailable, returns the same text back.

Throws:

Exception - When there is an error with the API call.

isAvailable

public boolean isAvailable()

Specified by:

isAvailable in interface Translator

Returns:

true if this Translator is probably able to translate right now.