translate: Translate text with the Google or the Microsoft translation...

In ChristopherLucas/translateR: Bindings for the Google and Microsoft Translation APIs

Description

This function provides easy access to the Google and Microsoft Translation APIs via R. It can translate any language supported by the APIs (to see a list of the available languages, see the getGoogleLanguages() and getMicrosoftLanguages() functions). Text can be provided as either a column in a dataframe or as a single vector of text, where the elements are the documents to be translated. Translated text is returned in the format it was provided. If text is provided as a single vector, translate() returns a single vector of translated text. If a dataframe is provided, the user must specify which column contains the text that is to be translated. Translated text is then bound to the dataframe in a new column named "translatedContent" and the entire dataframe is returned. The user must provide either a dataset and the content.field (column name) that contains the text to be translated, or a contect.vec (a character vector) where the elements are the text to be translated.

Usage

translate(dataset = NULL, content.field = NULL, content.vec = NULL, 
	google.api.key = NULL, microsoft.api.key = NULL, source.lang = NULL, 
	target.lang = NULL, microsoft.token = FALSE)

Arguments

dataset	A dataframe with a column containing the text to be translated.
content.field	If a dataframe is passed to "dataset", the name of the column containing the text must be passed to "content.field".
content.vec	A character vector of text. This is an alternative to "dataset"/"content.field".
google.api.key	To use the Google API, an API key must be provided. For more information on getting your key, see here.
microsoft.api.key	To use the Microsoft API, an API key must be provided from Microsoft Azure Cognitive Services. For more information on getting your key, see here.
microsoft.token	While using the Microsoft API, you have choice of using access token or not. If value is set as TRUE, then translateR will retrieve a token internally and process the request. Token method is recommended for longer translation. Default value is set as FALSE.
source.lang	The language code that corresponds with the language in which the source text is written. The translators use different language codes, so select accordingly. To see a list of language codes, enter getGoogleLanguages() or getMicrosoftLanguages() for Google or Microsoft, respectively.
target.lang	The language code that corresponds with the language into which the source text is to be translated. The translators use different language codes, so select accordingly. To see a list of language codes, enter getGoogleLanguages() or getMicrosoftLanguages() for Google or Microsoft, respectively.

Examples

## Not run: 
# Load example data. Three columns, the text content ('email') and two
# metadata fields (date and subject) 
data(enron)

# Google, translate column in dataset
google.dataset.out <- translate(dataset = enron, content.field = 'email', 
			google.api.key = my.google.key, source.lang = 'en', 
			target.lang = 'de')

# Google, translate vector
google.vector.out <- translate(content.vec = enron$email, 
			google.api.key = my.google.key,
                        source.lang = 'en', target.lang = 'de')

# Microsoft, translate column in dataset
google.dataset.out <- translate(dataset = enron, content.field = 'email', 
			microsoft.api.key = my.microsoft.key, source.lang = 'en', 
			target.lang = 'de')

# Microsoft, translate vector
google.vector.out <- translate(content.vec = enron$email, 
			microsoft.api.key = my.microsoft.key, source.lang = 'en',
			target.lang = 'de')

## End(Not run)

ChristopherLucas/translateR documentation built on March 3, 2021, 2:50 a.m.