google-translator for Dart

To translate text, instantiate GoogleTranslator and use the translate method. You can specify the source language using the from parameter and the target language using the to parameter. If you omit the from parameter, the library will attempt to auto-detect the source language.

The translate method returns a Translation object containing the translated text and metadata about the source and target languages.

final translator = GoogleTranslator();

// Explicitly defining source and target languages
final translation = await translator.translate("I love Brazil!", from: 'en', to: 'pt');
print(translation.text); // Eu amo o Brasil!

// Auto-detecting source language
final autoDetected = await translator.translate("Hello", to: 'es');
print(autoDetected.text); // Hola

Warning

This package is developed for educational purposes only. It works by crawling the Google Translate website and is not an official API. Because it relies on web crawling, it may break at any time. For production or critical usage, it is recommended to use the official Google Translate API.

The library provides an extension method on the String class, allowing you to call .translate() directly on any string instance. You must still provide the to parameter (and optionally from).

print(await "example".translate(to: 'pt'));
// prints exemplo

If you want to output the translation directly to the console without handling the Translation object, use the translateAndPrint method.

translator.translateAndPrint("This means 'testing' in chinese", to: 'zh-cn');
// prints 这意味着用中文'测试'

The translate method returns a Translation object. This object provides access to the original text, the detected source language, the translated text, and the target language.

Key properties:

• source: The original text.
• sourceLanguage: The language of the original text.
• text: The translated text.
• targetLanguage: The language the text was translated into.

var translation = await translator.translate('Translation', from: 'en', to: 'es');
print('${translation.source} (${translation.sourceLanguage}) == ${translation.text} (${translation.targetLanguage})');
// prints Translation (English) == Traducción (Spanish)

Use LanguageList.contains(String codeOrLang) to verify if a specific ISO code or a language name is supported by the API. This method is case-insensitive regarding the name (it performs a camel-case check internally).

// Checking by ISO code
bool isSupportedCode = LanguageList.contains('en'); // true

// Checking by language name
bool isSupportedName = LanguageList.contains('English'); // true

If the default Google Translate base URL (translate.googleapis.com) is not working in your specific region or network environment, you can override it using the baseUrl setter.

final translator = GoogleTranslator();
translator.baseUrl = 'alternative.translate.url';

When initializing GoogleTranslator, you can specify a client type via the ClientType enum to change how the request is sent to Google. This is useful if your IP is being blocked by the default client.

• ClientType.siteGT: Uses the 't' client parameter (default).
• ClientType.extensionGT: Uses the 'gtx' client parameter. This is intended for cases where the standard client might be blocking your IP.

// Use the extension client to avoid IP blocking
final translator = GoogleTranslator(client: ClientType.extensionGT);

The translateAndPrint method is a convenience function that performs the translation and immediately prints the resulting Translation object to the console.

final translator = GoogleTranslator();
translator.translateAndPrint('Hello', from: 'en', to: 'fr');

The LanguageList class provides access to all languages supported by the Google Translate API. You can retrieve a Language object using its ISO code via the [] operator. If the code is not supported, it throws a LanguageNotSupportedException.

// Accessing a language by its ISO code
final spanish = LanguageList['es'];
print(spanish.name); // Spanish

// Automatic language detection code
final auto = LanguageList['auto'];
print(auto.name); // Automatic