# CloudVision

[Google Cloud Vision API](https://cloud.google.com/vision/) Client in Elixir.

## Installation

  1. Add `cloud_vision` to your list of dependencies in `mix.exs`:

    ```elixir
    def deps do
      [{:cloud_vision, "~> 0.1.0"}]
    end
    ```

  2. Ensure `cloud_vision` is started before your application:

    ```elixir
    def application do
      [applications: [:cloud_vision]]
    end
    ```

  3. Configure credentials for [goth](https://github.com/peburrows/goth):

    ```elixir
    config :goth, json: "PATH_TO_YOUR_CREDENTIALS" |> File.read!
    ````

  4. (Optional) Configure your Google Cloud Storage Bucket URI if you want to retrieve file from it:
    ```elixir
    config :ex_cloud_vision, gcsUri: "YOUR_BUCKET_URI" # e.g. xxx.appspot.com
    ```

## Usage

Just call ```CloudVision.analyze/1``` or ```CloudVision.analyze/2``` once everything configured properly.

```elixir
# analyze a local file
CloudVision.analyze("/Users/yourname/Images/cat.jpg", :local)
# or the shorthand version
CloudVision.analyze("/Users/yourname/Images/cat.jpg")

# or analyze an image stored in Google Cloud Storage
# cat.jpg is a relative path from the storage's root
CloudVision.analyze("cat.jpg", :storage)
```