google translate api

API de traducción de Google

¿Una API gratuita e ilimitada para Google Translate?

Características

• Detección automática de idioma
• Corrección ortográfica
• Corrección de idioma
• Rápido y confiable: utiliza los mismos servidores que traduce.google.com

Instalar

 npm install --save google-translate-api

Uso

De la detección automática de idioma al 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 ) ;
} ) ;

De inglés a holandés con un error tipográfico:

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

A veces, la API no utilizará el texto corregido automáticamente en la traducción:

 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

traducir (texto, opciones)

texto

Tipo: string

El texto a traducir

opciones

Tipo: object

de

Tipo: string Valor predeterminado: auto

El lenguaje text . Debe ser auto o uno de los códigos/nombres (no distingue entre mayúsculas y minúsculas) contenidos en language.js

a

Tipo: string Predeterminado: en

El idioma en el que se debe traducir el texto. Debe ser uno de los códigos/nombres (no distingue entre mayúsculas y minúsculas) contenidos en language.js.

crudo

Tipo: boolean Valor predeterminado: false

Si true , el objeto devuelto tendrá una propiedad raw con la respuesta sin formato ( string ) de Google Translate.

Devuelve un object :

• text (cadena) : el texto traducido.
• from (objeto)
  • language (objeto)
    • didYouMean (booleano) : true si la API sugiere una corrección en el idioma de origen
    • iso (cadena) : el código del idioma que la API ha reconocido en el text
  • text (objeto)
    • autoCorrected (booleano) : true si la API ha corregido automáticamente el text
    • value (cadena) : el text corregido automáticamente o el text con correcciones sugeridas
    • didYouMean (booelan) : true si la API ha sugerido correcciones al text
• raw (cadena) : si options.raw es verdadero, la respuesta sin procesar de los servidores de Google Translate. De lo contrario, '' .

Tenga en cuenta que res.from.text solo se devolverá si from.text.autoCorrected o from.text.didYouMean es igual a true . En este caso tendrá las correcciones delimitadas entre corchetes ( [ ] ):

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

De lo contrario, será una string vacía ( '' ).

Relacionado

• vertaler – CLI para este módulo

Licencia

MIT © Matheus Fernández