◷ Reading Time: 7 minutes
This extension allows users to connect to the vision API and call feature options.
Vision API offers powerful pre-trained machine-learning models through REST APIs. Assign labels to images and quickly classify them into millions of predefined categories. Detect objects, read printed and handwritten text, and build valuable metadata into your image catalog.
As a prerequisite, you should create an account on Google cloud and enable Vision API. you also need to create an API credential to allow access.
Currently, the extension supports the “service-account” credential type.
Create a Google Cloud account
The first step is to create a Google Cloud Console account.
- Open Google Cloud Console in a browser.
- When prompted to sign in, follow the instructions to register your corporate email address as a Google account. Alternatively, you can use a Gmail account or another Google account.
- Continue to the Google Cloud Console and accept the Google Cloud terms presented.
Create a Google Cloud project
2.1 Click the project selector Select a project
2.2 Click New Project. The New Project view displays.
2.3 Click New Project. The New Project view displays. Enter a friendly name for your project in the Project name field. Click Create. Google Cloud creates your new project.
You can change the generated Project ID by clicking Edit, but the project ID must be unique. The project ID can have lowercase letters, digits, or hyphens, and must start with a lowercase letter.
Take note of the Project ID. You will use it later in this setup process.
Enable the API
You must enable the Vision API for your project. For more information on enabling APIs, see the Service Usage documentation. Enable the Vision API.
3.1 Click on https://console.cloud.google.com/flows/enableapi?apiid=vision.googleapis.com
3.2 Click on “Enable”
Create a service account
4.1 In the Cloud Console, go to the Create service account page. Go to Create service account
4.2 In the Service account name field, enter a name. The Cloud Console fills in the Service account ID field based on this name. In the Service account description field, enter a description. For example, Service account for quickstart.
Click Create and continue.
4.3 Grant service account access to the project.
4.4 Click on “Done”
4.5 Create a private key for the service account.
Click on “Keys” then choose “Add Key”
4.6 Select “Json” as the key type.
4.7 Download and save the JSON key on your local computer.
Save this Private Key in a folder location you remember as you will use it for the API authentication.
Toolbox
When the Google Vision Extension is installed, the Toolbox will be updated for Flow models.
See Google Vision Commands for the full description.
Use the Extension
The following tutorial shows you how to use Google Vision API on the extension.
1. Create a Flow.
2. From the menu Tools –> Extension Manager, install FlexRule.Extensions.Authenticator.
3. Drag and drop the Google Authenticate node from the toolbox.
4. Enter the JSON file path generated during the previous step and specify other options.
5. Grab another GoogleVision command from the toolbox and add it to the existing workflow; in this example, we add “Image Annotate”.
6. Enter the below inputs:
- image Path: the image full path which is used to.
- Detection: Choose from the combo box the option that you are after.
- Credential: the credential name which has been set 4.
- Result: Google API response based on the image and the option chosen
7. Add Start and End to your flow and run the workflow.
You will see the code and the time in the parameters window.
Select the result parameter and click on Data Viewer to see the result.
See Google Vision Commands for the full description.