Class: Google::Cloud::Translate::Api

Inherits:

Object

• Object
• Google::Cloud::Translate::Api

Defined in:

lib/google/cloud/translate/api.rb

Overview

Api

Represents top-level access to the Google Translate API. Translate API supports more than ninety different languages, from Afrikaans to Zulu. Used in combination, this enables translation between thousands of language pairs. Also, you can send in HTML and receive HTML with translated text back. You don't need to extract your source text or reassemble the translated content.

Examples:

require "google/cloud/translate"

translate = Google::Cloud::Translate.new

translation = translate.translate "Hello world!", to: "la"

translation.to_s #=> "Salve mundi!"

translation.from #=> "en"
translation.origin #=> "Hello world!"
translation.to #=> "la"
translation.text #=> "Salve mundi!"

See Also:

• Translate API Getting Started

Instance Method Summary

• #detect(*text) ⇒ Detection⁺

  Detect the most likely language or languages of a text or multiple texts.

• #languages(language = nil) ⇒ Array<Language>

  List the languages supported by the API.

• #project ⇒ Object

  The Translate project connected to.

• #translate(*text, to: nil, from: nil, format: nil, model: nil, cid: nil) ⇒ Translation⁺

  Returns text translations from one language to another.

Instance Method Details

#detect(*text) ⇒ Detection⁺

Detect the most likely language or languages of a text or multiple texts.

Examples:

require "google/cloud/translate"

translate = Google::Cloud::Translate.new

detection = translate.detect "Hello world!"
detection.language #=> "en"
detection.confidence #=> 0.7100697

Detecting multiple texts.

require "google/cloud/translate"

translate = Google::Cloud::Translate.new

detections = translate.detect "Hello world!",
                              "Bonjour le monde!"
detections.count #=> 2
detections.first.language #=> "en"
detections.first.confidence #=> 0.7100697
detections.last.language #=> "fr"
detections.last.confidence #=> 0.40440267

Parameters:

• text (String) —

  The text or texts upon which language detection should be performed.

Returns:

• (Detection, Array<Detection>) —

  A single Detection object if just one text was given, or an array of Detection objects if multiple texts were given.

See Also:

• Detect Language

# File 'lib/google/cloud/translate/api.rb', line 234

def detect *text
  return nil if text.empty?
  text = Array(text).flatten
  gapi = service.detect(text)
  Detection.from_gapi gapi, text
end

#languages(language = nil) ⇒ Array<Language>

List the languages supported by the API. These are the languages to and from which text can be translated.

Examples:

require "google/cloud/translate"

translate = Google::Cloud::Translate.new

languages = translate.languages
languages.count #=> 104

english = languages.detect { |l| l.code == "en" }
english.name #=> nil

Get all languages with their names in French.

require "google/cloud/translate"

translate = Google::Cloud::Translate.new

languages = translate.languages "fr"
languages.count #=> 104

english = languages.detect { |l| l.code == "en" }
english.name #=> "Anglais"

Parameters:

• language (String) (defaults to: nil) —

  The language and collation in which the names of the languages are returned. If this is nil then no names are returned.

Returns:

• (Array<Language>) —

  An array of Language objects supported by the API.

See Also:

• Discover Supported Languages

# File 'lib/google/cloud/translate/api.rb', line 277

def languages language = nil
  language = language.to_s if language
  gapi = service.languages language
  Array(gapi["languages"]).map { |g| Language.from_gapi g }
end

#project ⇒ Object

The Translate project connected to.

Examples:

require "google/cloud/translate"

translate = Google::Cloud::Translate.new(
  project: "my-todo-project",
  keyfile: "/path/to/keyfile.json"
)

translate.project #=> "my-todo-project"

# File 'lib/google/cloud/translate/api.rb', line 78

def project
  service.project
end

#translate(*text, to: nil, from: nil, format: nil, model: nil, cid: nil) ⇒ Translation⁺

Returns text translations from one language to another.

Examples:

require "google/cloud/translate"

translate = Google::Cloud::Translate.new

translation = translate.translate "Hello world!", to: "la"

translation.to_s #=> "Salve mundi!"

translation.detected? #=> true
translation.from #=> "en"
translation.origin #=> "Hello world!"
translation.to #=> "la"
translation.text #=> "Salve mundi!"
translation.model #=> "base"

Using the neural machine translation model:

require "google/cloud/translate"

translate = Google::Cloud::Translate.new

translation = translate.translate "Hello world!",
                                  to: "la", model: "nmt"

translation.to_s #=> "Salve mundi!"
translation.model #=> "nmt"

Setting the from language.

require "google/cloud/translate"

translate = Google::Cloud::Translate.new

translation = translate.translate "Hello world!",
                                  from: :en, to: :la
translation.detected? #=> false
translation.text #=> "Salve mundi!"

Retrieving multiple translations.

require "google/cloud/translate"

translate = Google::Cloud::Translate.new

translations = translate.translate "Hello my friend.",
                                   "See you soon.",
                                   from: "en", to: "la"
translations.count #=> 2
translations[0].text #=> "Salve amice."
translations[1].text #=> "Vide te mox."

Preserving HTML tags.

require "google/cloud/translate"

translate = Google::Cloud::Translate.new

translation = translate.translate "<strong>Hello</strong> world!",
                                  to: :la
translation.text #=> "<strong>Salve</strong> mundi!"

Parameters:

• text (String) —

  The text or texts to translate.

• to (String) (defaults to: nil) —

  The target language into which the text should be translated. This is required. The value must be an ISO 639-1 language code.

• from (String) (defaults to: nil) —

  The source language of the text or texts. This is an ISO 639-1 language code. This is optional.

• format (String) (defaults to: nil) —

  The format of the text. Possible values include :text and :html. This is optional. The Translate API default is :html.

• model (String) (defaults to: nil) —

  The model used by the service to perform the translation. The neural machine translation model (nmt) is billed as a premium edition feature. If this is set to base, then the service will return translation using the current standard model. The default value is base.

  Acceptable values are:

  • nmt - Use the neural machine translation model
  • base - Use the current standard model
• cid (String) (defaults to: nil) —

  The customization id for translate. This is optional.

Returns:

• (Translation, Array<Translation>) —

  A single Translation object if just one text was given, or an array of Translation objects if multiple texts were given.

See Also:

• Translate Text

# File 'lib/google/cloud/translate/api.rb', line 185

def translate *text, to: nil, from: nil, format: nil, model: nil,
              cid: nil
  return nil if text.empty?
  fail ArgumentError, "to is required" if to.nil?
  to = to.to_s
  from = from.to_s if from
  format = format.to_s if format
  text = Array(text).flatten
  gapi = service.translate text, to: to, from: from,
                                 format: format, model: model, cid: cid
  Translation.from_gapi_list gapi, text, to, from
end