google translate api

google-translate-api

Uma API gratuita e ilimitada para o Google Tradutor?

Características

• Detecção automática de idioma
• Correção ortográfica
• Correção de idioma
• Rápido e confiável – usa os mesmos servidores que o translate.google.com usa

Instalar

 npm install --save google-translate-api

Uso

Da detecção automática de idioma ao inglês:

 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 ) ;
} ) ;

Do inglês para o holandês com um erro de digitação:

 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 ) ;
} ) ;

Às vezes, a API não usará o texto corrigido automaticamente na tradução:

 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

traduzir(texto, opções)

texto

Tipo: string

O texto a ser traduzido

opções

Tipo: object

de

Tipo: string Padrão: auto

O idioma text . Deve ser auto ou um dos códigos/nomes (sem distinção entre maiúsculas e minúsculas) contidos em idiomas.js

para

Tipo: string Padrão: en

O idioma em que o texto deve ser traduzido. Deve ser um dos códigos/nomes (sem distinção entre maiúsculas e minúsculas) contidos em idiomas.js.

cru

Tipo: boolean Padrão: false

Se true , o objeto retornado terá uma propriedade raw com a resposta bruta ( string ) do Google Translate.

Retorna um object :

• text (string) – O texto traduzido.
• from (objeto)
  • language (objeto)
    • didYouMean (boolean) - true se a API sugerir uma correção no idioma de origem
    • iso (string) - O código da linguagem que a API reconheceu no text
  • text (objeto)
    • autoCorrected (booleano) – true se a API corrigiu automaticamente o text
    • value (string) – O text corrigido automaticamente ou o text com correções sugeridas
    • didYouMean (booelan) – true se a API sugeriu correções no text
• raw (string) - Se options.raw for verdadeiro, a resposta bruta dos servidores do Google Translate. De outra forma, '' .

Observe que res.from.text só será retornado se from.text.autoCorrected ou from.text.didYouMean for igual a true . Neste caso, terá as correções delimitadas por colchetes ( [ ] ):

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

Caso contrário, será uma string vazia ( '' ).

Relacionado

• vertaler – CLI para este módulo

Licença

MIT © Matheus Fernandes