Documentation
¶
Overview ¶
Package translate is a client for the Google Translation API. See https://cloud.google.com/translation for details.
Index ¶
- Constants
- type Client
- func (c *Client) Close() error
- func (c *Client) DetectLanguage(ctx context.Context, inputs []string) ([][]Detection, error)
- func (c *Client) SupportedLanguages(ctx context.Context, target language.Tag) ([]Language, error)
- func (c *Client) Translate(ctx context.Context, inputs []string, target language.Tag, opts *Options) ([]Translation, error)
- type Detection
- type Format
- type Language
- type Options
- type Translation
Constants ¶
const Scope = raw.CloudPlatformScope
Scope is the OAuth2 scope required by the Google Cloud Vision API.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Client ¶
type Client struct {
// contains filtered or unexported fields
}
Client is a client for the translate API.
func NewClient ¶
NewClient constructs a new Client that can perform Translation operations.
You can find or create API key for your project from the Credentials page of the Developers Console (console.developers.google.com).
func (*Client) Close ¶
Close closes any resources held by the client. Close should be called when the client is no longer needed. It need not be called at program exit.
func (*Client) DetectLanguage ¶
DetectLanguage attempts to determine the language of the inputs. Each input string may be in a different language.
Each slice of Detections in the return value corresponds with one input string. A slice of Detections holds multiple hypotheses for the language of a single input string.
func (*Client) SupportedLanguages ¶
SupportedLanguages returns a list of supported languages for translation. The target parameter is the language to use to return localized, human readable names of supported languages.
func (*Client) Translate ¶
func (c *Client) Translate(ctx context.Context, inputs []string, target language.Tag, opts *Options) ([]Translation, error)
Translate one or more strings of text from a source language to a target language. All inputs must be in the same language.
The target parameter supplies the language to translate to. The supported languages are listed at https://cloud.google.com/translation/v2/translate-reference#supported_languages. You can also call the SupportedLanguages method.
The returned Translations appear in the same order as the inputs.
type Detection ¶
type Detection struct {
// Language is the code of the language detected.
Language language.Tag
// Confidence is a number from 0 to 1, with higher numbers indicating more
// confidence in the detection.
Confidence float64
// IsReliable indicates whether the language detection result is reliable.
IsReliable bool
}
Detection represents information about a language detected in an input.
type Language ¶
type Language struct {
// Name is the human-readable name of the language.
Name string
// Tag is a standard code for the language.
Tag language.Tag
}
A Language describes a language supported for translation.
type Options ¶
type Options struct {
// Source is the language of the input strings. If empty, the service will
// attempt to identify the source language automatically and return it within
// the response.
Source language.Tag
// Format describes the format of the input texts. The choices are HTML or
// Text. The default is HTML.
Format Format
// The model to use for translation. The choices are "nmt" or "base". The
// default is "base".
Model string
}
Options contains options for Translate.
type Translation ¶
type Translation struct {
// Text is the input text translated into the target language.
Text string
// Source is the detected language of the input text, if source was
// not supplied to Client.Translate. If source was supplied, this field
// will be empty.
Source language.Tag
// Model is the model that was used for translation.
// It may not match the model provided as an option to Client.Translate.
Model string
}
A Translation contains the results of translating a piece of text.
Source Files
¶
- translate.go
Directories
¶
| Path | Synopsis |
|---|---|
|
internal
|
|
|
translate/v2
Package translate provides access to the Translate API.
|
Package translate provides access to the Translate API. |