Adds Vision object localisation samples (GoogleCloudPlatform#712)

Author: sirtorry

vision/composer.json

@@ -2,7 +2,7 @@
     "name": "google/vision",
     "type": "project",
     "require": {
-        "google/cloud-vision": "^0.13",
+        "google/cloud-vision": "^0.17",
         "google/cloud-storage": "^1.3",
         "symfony/console": "^3.1"
     },
@@ -31,6 +31,8 @@
             "src/detect_document_text_gcs.php",
             "src/detect_web.php",
             "src/detect_web_gcs.php",
+            "src/detect_object.php",
+            "src/detect_object_gcs.php",
             "src/detect_web_with_geo_metadata.php",
             "src/detect_web_with_geo_metadata_gcs.php",
             "src/detect_pdf_gcs.php"

vision/composer.lock

@@ -0,0 +1,49 @@
+
+/**
+ * Copyright 2018 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// [START vision_localize_object]
+namespace Google\Cloud\Samples\Vision;
+
+use Google\Cloud\Vision\V1\ImageAnnotatorClient;
+
+// $path = 'path/to/your/image.jpg'
+
+function detect_object($path)
+{
+    $imageAnnotator = new ImageAnnotatorClient();
+
+    # annotate the image
+    $image = file_get_contents($path);
+    $response = $imageAnnotator->objectLocalization($image);
+    $objects = $response->getLocalizedObjectAnnotations();
+
+    foreach ($objects as $object) {
+        $name = $object->getName();
+        $score = $object->getScore();
+        $vertices = $object->getBoundingPoly()->getNormalizedVertices();
+
+        printf('%s (confidence %d)):' . PHP_EOL, $name, $score);
+        print('normalized bounding polygon vertices: ');
+        foreach ($vertices as $vertex) {
+            printf(' (%d, %d)', $vertex->getX(), $vertex->getY());
+        }
+        print(PHP_EOL);
+    }
+
+    $imageAnnotator->close();
+}
+// [END vision_localize_object]

vision/src/detect_object.php

@@ -0,0 +1,48 @@
+
+/**
+ * Copyright 2018 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// [START vision_localize_object_gcs]
+namespace Google\Cloud\Samples\Vision;
+
+use Google\Cloud\Vision\V1\ImageAnnotatorClient;
+
+// $path = 'gs://path/to/your/image.jpg'
+
+function detect_object_gcs($path)
+{
+    $imageAnnotator = new ImageAnnotatorClient();
+
+    # annotate the image
+    $response = $imageAnnotator->objectLocalization($path);
+    $objects = $response->getLocalizedObjectAnnotations();
+
+    foreach ($objects as $object) {
+        $name = $object->getName();
+        $score = $object->getScore();
+        $vertices = $object->getBoundingPoly()->getNormalizedVertices();
+
+        printf('%s (confidence %d)):' . PHP_EOL, $name, $score);
+        print('normalized bounding polygon vertices: ');
+        foreach ($vertices as $vertex) {
+            printf(' (%d, %d)', $vertex->getX(), $vertex->getY());
+        }
+        print(PHP_EOL);
+    }
+
+    $imageAnnotator->close();
+}
+// [END vision_localize_object_gcs]

vision/src/detect_object_gcs.php

@@ -22,7 +22,7 @@
 use Google\Cloud\Vision\V1\AnnotateFileResponse;
 use Google\Cloud\Vision\V1\AsyncAnnotateFileRequest;
 use Google\Cloud\Vision\V1\Feature;
-use Google\Cloud\Vision\V1\Feature_Type;
+use Google\Cloud\Vision\V1\Feature\Type;
 use Google\Cloud\Vision\V1\GcsDestination;
 use Google\Cloud\Vision\V1\GcsSource;
 use Google\Cloud\Vision\V1\ImageAnnotatorClient;
@@ -35,7 +35,7 @@ function detect_pdf_gcs($path, $output)
 {
     # select ocr feature
     $feature = (new Feature())
-        ->setType(Feature_Type::DOCUMENT_TEXT_DETECTION);
+        ->setType(Type::DOCUMENT_TEXT_DETECTION);
 
     # set $path (file to OCR) as source
     $gcsSource = (new GcsSource())

vision/src/detect_pdf_gcs.php

@@ -170,6 +170,22 @@ public function testLogoCommandGcs()
         $this->assertContains('Google', $output);
     }
 
+    public function testLocalizeObjectCommand()
+    {
+        $path = __DIR__ . '/data/puppies.jpg';
+        $output = $this->runCommand('localize-object', $path);
+        $this->assertContains('Dog', $output);
+    }
+
+    public function testLocalizeObjectCommandGcs()
+    {
+        $this->requireCloudStorage();
+
+        $path = 'gs://' . $this->bucketName . '/vision/puppies.jpg';
+        $output = $this->runCommand('localize-object', $path);
+        $this->assertContains('Dog', $output);
+    }
+
     public function testLogoCommandWithImageLackingLogo()
     {
         $path = __DIR__ . '/data/tower.jpg';

vision/test/data/puppies.jpg

@@ -305,6 +305,29 @@
     })
 );
 
+// localize object command
+$application->add((new Command('localize-object'))
+    ->setDefinition($inputDefinition)
+    ->setDescription('Localize object in an image using '
+                . 'Google Cloud Vision API')
+    ->setHelp(<<
+The %command.name% command finds objects in an image using
+the Google Cloud Vision API.
+
+    php %command.full_name% path/to/image.png
+
+EOF
+    )
+    ->setCode(function ($input, $output) {
+        $path = $input->getArgument('path');
+        if (preg_match('/^gs:\/\/([a-z0-9\._\-]+)\/(\S+)$/', $path)) {
+            detect_object_gcs($path);
+        } else {
+            detect_object($path);
+        }
+    })
+);
+
 if (getenv('PHPUNIT_TESTS') === '1') {
     return $application;
 }