# Google Cloud Translate Sample

This sample demonstrates the use of [Google Cloud Translate
API][Translate-Docs] for translating and detecting language text.

[Translate-Docs]: https://cloud.google.com/translate/docs/

## Java Version

This sample requires you to have
[Java8](https://docs.oracle.com/javase/8/docs/technotes/guides/install/install_overview.html).

## Download Maven

This sample uses the [Apache Maven][maven] build system. Before getting started,
be
sure to [download][maven-download] and [install][maven-install] it. When you use
Maven as described here, it will automatically download the needed client
libraries.

[maven]: https://maven.apache.org
[maven-download]: https://maven.apache.org/download.cgi
[maven-install]: https://maven.apache.org/install.html

## Authentication
This sample uses API Key for authentication.

 * Visit the [Google Cloud Console](https://console.cloud.google.com) and navigate to:
 ```
  API Manager > Credentials > Create credentials > API Key
 ```

 * Set the environment variable `GOOGLE_API_KEY`
 ```
  export GOOGLE_API_KEY=<YOUR_PROJECT_API_KEY>
 ```

## Run the sample

To build the sample, we use Maven.

```bash
mvn clean compile assembly:single
```

We can then run the assembled JAR file with the `java` command. The variable
$COMMAND takes three values `langsupport`, `detect` and `translate`.

```
JAR_FILE=target/translate-1.0-jar-with-dependencies.jar
java -jar $JAR_FILE <detect|translate|langsupport> <text>
    <optional_source> <optional_target>
```

Example Usage:

```
INPUT="A quick brown fox jumped over a lazy dog."
SOURCE_LANG="en"
TARGET_LANG="fr"
```

Translate API Features:

 * List the languages supported by the API
   ```
   java -jar $JAR_FILE langsupport
   ```

 * List the languages supported for given target language
   ```
   java -jar $JAR_FILE langsupport $TARGET_LANG
   ```

 * Detect input text language
   ```
   java -jar $JAR_FILE detect "$INPUT"
  ```

 * Translate input text (with options)
   ```
   java -jar $JAR_FILE translate "$INPUT"
   java -jar $JAR_FILE translate "$INPUT" $SOURCE_LANG $TARGET_LANG
   ```