Convert Figma logo to code with AI

matheuss logogoogle-translate-api

A free and unlimited API for Google Translate :dollar::no_entry_sign:

3,014
626
3,014
88
View on GitHubView on NPM

Top Related Projects

googleapis's avatar

google-cloud-node

3,025

Google Cloud Client Library for Node.js

Quick Overview

The google-translate-api is an unofficial Node.js library that provides a simple interface to access Google Translate services. It allows developers to translate text between languages programmatically without the need for an API key or authentication.

Pros

  • Easy to use with a simple API
  • No authentication or API key required
  • Supports a wide range of languages
  • Free to use (but with limitations)

Cons

  • Unofficial API, may break if Google changes their service
  • Limited request volume due to potential IP blocking
  • May not be suitable for production environments or high-volume applications
  • Lacks some advanced features of the official Google Translate API

Code Examples

Translating text from English to Spanish:

const translate = require('google-translate-api');

translate('Hello, world!', {to: 'es'}).then(res => {
    console.log(res.text);
    // => 'Hola, mundo!'
}).catch(err => {
    console.error(err);
});

Detecting the language of a given text:

const translate = require('google-translate-api');

translate('Ich bin ein Berliner', {to: 'en'}).then(res => {
    console.log(res.from.language.iso);
    // => 'de'
}).catch(err => {
    console.error(err);
});

Translating with automatic language detection:

const translate = require('google-translate-api');

translate('Привет, мир!', {to: 'en'}).then(res => {
    console.log(`${res.text} (from ${res.from.language.iso})`);
    // => 'Hello, world! (from ru)'
}).catch(err => {
    console.error(err);
});

Getting Started

  1. Install the package using npm:
npm install google-translate-api
  1. Import the library in your JavaScript file:
const translate = require('google-translate-api');
  1. Use the translate function to translate text:
translate('Hello', {to: 'fr'}).then(res => {
    console.log(res.text);
    // => 'Bonjour'
}).catch(err => {
    console.error(err);
});

Note: Be mindful of usage limits and consider implementing rate limiting in your application to avoid potential IP blocking by Google.

Competitor Comparisons

googleapis logo

google-cloud-node

3,025

Google Cloud Client Library for Node.js

Pros of google-cloud-node

  • Comprehensive suite of Google Cloud services, not limited to translation
  • Official Google library with robust support and documentation
  • Scalable for enterprise-level applications

Cons of google-cloud-node

  • Requires Google Cloud account and authentication
  • More complex setup and configuration
  • Potentially higher costs for large-scale usage

Code Comparison

google-translate-api:

const translate = require('google-translate-api');

translate('Hello world', {to: 'es'}).then(res => {
    console.log(res.text);
}).catch(err => {
    console.error(err);
});

google-cloud-node:

const {Translate} = require('@google-cloud/translate').v2;
const translate = new Translate({projectId});

async function translateText() {
  const [translation] = await translate.translate('Hello world', 'es');
  console.log(translation);
}
translateText();

Summary

google-translate-api is a lightweight, easy-to-use library for quick translation tasks, while google-cloud-node offers a comprehensive suite of Google Cloud services with robust support and scalability. The choice between the two depends on the project's scope, budget, and integration requirements with other Google Cloud services.

Convert Figma logo designs to code with AI

Visual Copilot

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

README

google-translate-api Build Status XO code style Coverage Status Known Vulnerabilities

A free and unlimited API for Google Translate :dollar::no_entry_sign:

Features

  • Auto language detection
  • Spelling correction
  • Language correction
  • Fast and reliable – it uses the same servers that translate.google.com uses

Install

npm install --save google-translate-api

Usage

From automatic language detection to English:

const translate = require('google-translate-api');

translate('Ik spreek Engels', {to: 'en'}).then(res => {
    console.log(res.text);
    //=> I speak English
    console.log(res.from.language.iso);
    //=> nl
}).catch(err => {
    console.error(err);
});

From English to Dutch with a typo:

translate('I spea Dutch!', {from: 'en', to: 'nl'}).then(res => {
    console.log(res.text);
    //=> Ik spreek Nederlands!
    console.log(res.from.text.autoCorrected);
    //=> true
    console.log(res.from.text.value);
    //=> I [speak] Dutch!
    console.log(res.from.text.didYouMean);
    //=> false
}).catch(err => {
    console.error(err);
});

Sometimes, the API will not use the auto corrected text in the translation:

translate('I spea Dutch!', {from: 'en', to: 'nl'}).then(res => {
    console.log(res);
    console.log(res.text);
    //=> Ik spea Nederlands!
    console.log(res.from.text.autoCorrected);
    //=> false
    console.log(res.from.text.value);
    //=> I [speak] Dutch!
    console.log(res.from.text.didYouMean);
    //=> true
}).catch(err => {
    console.error(err);
});

API

translate(text, options)

text

Type: string

The text to be translated

options

Type: object

from

Type: string Default: auto

The text language. Must be auto or one of the codes/names (not case sensitive) contained in languages.js

to

Type: string Default: en

The language in which the text should be translated. Must be one of the codes/names (not case sensitive) contained in languages.js.

raw

Type: boolean Default: false

If true, the returned object will have a raw property with the raw response (string) from Google Translate.

Returns an object:

  • text (string) – The translated text.
  • from (object)
    • language (object)
      • didYouMean (boolean) - true if the API suggest a correction in the source language
      • iso (string) - The code of the language that the API has recognized in the text
    • text (object)
      • autoCorrected (boolean) – true if the API has auto corrected the text
      • value (string) – The auto corrected text or the text with suggested corrections
      • didYouMean (booelan) – true if the API has suggested corrections to the text
  • raw (string) - If options.raw is true, the raw response from Google Translate servers. Otherwise, ''.

Note that res.from.text will only be returned if from.text.autoCorrected or from.text.didYouMean equals to true. In this case, it will have the corrections delimited with brackets ([ ]):

translate('I spea Dutch').then(res => {
    console.log(res.from.text.value);
    //=> I [speak] Dutch
}).catch(err => {
    console.error(err);
});

Otherwise, it will be an empty string ('').

Related

License

MIT © Matheus Fernandes

NPM DownloadsLast 30 Days