GoogleVisionApiBundle
, (*1)
GoogleVisionApiBundle is a Symfony2/3 Bundle for use the API Google Vision simply (https://cloud.google.com/vision/), (*2)
Installation
Via Composer, (*3)
``` bash
$ composer require headoo/google-vision-api-bundle, (*4)
or in composer.json file
``` bash
"headoo/google-vision-api-bundle": "dev-master"
Register the bundle in app/AppKernel.php
:, (*5)
``` php
public function registerBundles()
{
return array(
// ...
new Headoo\GoogleVisionApiBundle\HeadooGoogleVisionApiBundle(),
// ...
);
}, (*6)
Configuration
-------------
Configure the google api key in your `config.yml` :
``` yaml
headoo_google_vision_api:
api_key: '%apikey%'
Usage
It works like a service. On a Controller you can call like this:, (*7)
$google_vision = $this->container->get('headoo_google_vision_api.helper');
You can use all detections functionality with 1 endpoint:
php
$google_vision->vision($image, $type);
, (*8)
Your $image must be base64 encoded, or via an URL , or an absolute path., (*9)
Available $type are :
- TYPE_UNSPECIFIED
- FACE_DETECTION
- LANDMARK_DETECTION
- LOGO_DETECTION
- LABEL_DETECTION
- TEXT_DETECTION
- SAFE_SEARCH_DETECTION
- IMAGE_PROPERTIES
- WEB_DETECTION, (*10)
Return
You will receive an array with http_code, raw_response and a parsed_response., (*11)
- http_code : Google Http Code Response (often 200 for OK, and 400 for error)
- raw_response : Google Vision Api Response Raw, without manipulation
- parsed_response : Parsed response with objects, easier to use for a PHP user.
Security
If you discover a security vulnerability , please email instead of using the issue tracker. All security vulnerabilities will be promptly addressed., (*12)
Standalone Test
How to test
- clone repo :
$ sudo git clone https://github.com/Headoo/GoogleVisionApiBundle.git
- go into directory :
$ cd GoogleVisionApiBundle/
- install composer as explained here : https://getcomposer.org/download/
- launch composer update :
$ ./composer.phar update
- modify
headoo_google_vision_api.api_key
in Tests/App/config.yml
- launch test :
$ ./vendor/phpunit/phpunit/phpunit
License
This Bundle is open-sourced software licensed under the MIT license, (*13)