Merge remote-tracking branch 'dpe/master'

packages/google-cloud-vision/.gitignore

@@ -0,0 +1,2 @@
+out.png
+out.*

packages/google-cloud-vision/samples/README.md

@@ -0,0 +1,130 @@
+<img src="https://avatars2.githubusercontent.com/u/2810941?v=3&s=96" alt="Google Cloud Platform logo" title="Google Cloud Platform" align="right" height="96" width="96"/>
+
+# Google Cloud Vision API Node.js Samples
+
+The [Cloud Vision API][vision_docs] allows developers to easily integrate vision
+detection features within applications, including image labeling, face and
+landmark detection, optical character recognition (OCR), and tagging of explicit
+content.
+
+[vision_docs]: https://cloud.google.com/vision/docs/
+
+## Table of Contents
+
+* [Setup](#setup)
+* [Samples](#samples)
+  * [Detection snippets](#detection-snippets)
+  * [Face detection](#face-detection)
+  * [Text detection](#text-detection)
+
+## Setup
+
+1. Read [Prerequisites][prereq] and [How to run a sample][run] first.
+1. Install dependencies:
+
+        npm install
+
+[prereq]: ../README.md#prerequisities
+[run]: ../README.md#how-to-run-a-sample
+
+## Samples
+
+### Detection snippets
+
+View the [documentation][detect_docs] or the [source code][detect_code].
+
+__Usage:__ `node detect.js --help`
+
+```
+Commands:
+  faces <fileName>                         Detects faces in a local image file.
+  faces-gcs <bucketName> <fileName>        Detects faces in an image in Google Cloud Storage.
+  labels <fileName>                        Detects labels in a local image file.
+  labels-gcs <bucketName> <fileName>       Detects labels in an image in Google Cloud Storage.
+  landmarks <fileName>                     Detects landmarks in a local image file.
+  landmarks-gcs <bucketName> <fileName>    Detects landmarks in an image in Google Cloud Storage.
+  text <fileName>                          Detects text in a local image file.
+  text-gcs <bucketName> <fileName>         Detects text in an image in Google Cloud Storage.
+  logos <fileName>                         Detects logos in a local image file.
+  logos-gcs <bucketName> <fileName>        Detects logos in an image in Google Cloud Storage.
+  properties <fileName>                    Detects image properties in a local image file.
+  properties-gcs <bucketName> <fileName>   Detects image properties in an image in Google Cloud Storage.
+  safe-search <fileName>                   Detects safe search properties in a local image file.
+  safe-search-gcs <bucketName> <fileName>  Detects safe search properties in an image in Google Cloud Storage.
+  crops <fileName>                         Detects crop hints in a local image file.
+  crops-gcs <bucketName> <fileName>        Detects crop hints in an image in Google Cloud Storage.
+  web <fileName>                           Finds similar photos on the web for a local image file.
+  web-gcs <bucketName> <fileName>          Finds similar photos on the web for an image in Google Cloud Storage.
+  fulltext <fileName>                      Extracts full text from a local image file.
+  fulltext-gcs <bucketName> <fileName>     Extracts full text from an image in Google Cloud Storage.
+
+Options:
+  --help  Show help                                                                                            [boolean]
+
+Examples:
+  node detect.js faces ./resources/face_no_surprise.jpg
+  node detect.js faces-gcs my-bucket your-image.jpg
+  node detect.js labels ./resources/wakeupcat.jpg
+  node detect.js labels-gcs my-bucket your-image.jpg
+  node detect.js landmarks ./resources/landmark.jpg
+  node detect.js landmarks-gcs my-bucket your-image.jpg
+  node detect.js text ./resources/wakeupcat.jpg
+  node detect.js text-gcs my-bucket your-image.jpg
+  node detect.js logos ./resources/logos.png
+  node detect.js logos-gcs my-bucket your-image.jpg.png
+  node detect.js properties ./resources/landmark.jpg
+  node detect.js properties-gcs my-bucket your-image.jpg
+  node detect.js safe-search ./resources/wakeupcat.jpg
+  node detect.js safe-search-gcs my-bucket your-image.jpg
+  node detect.js crops ./resources/wakeupcat.jpg
+  node detect.js crops-gcs my-bucket your-image.jpg
+  node detect.js web ./resources/wakeupcat.jpg
+  node detect.js web-gcs my-bucket your-image.jpg
+  node detect.js fulltext ./resources/wakeupcat.jpg
+  node detect.js fulltext-gcs my-bucket your-image.jpg
+
+For more information, see https://cloud.google.com/vision/docs
+```
+
+[detect_docs]: https://cloud.google.com/vision/docs
+[detect_code]: detect.js
+
+### Face detection tutorial
+
+View the [documentation][face_docs] or the [source code][face_code].
+
+This sample uses [node-canvas](https://github.com/Automattic/node-canvas) to
+draw an output image. node-canvas depends on Cairo, which may require separate
+installation. See the node-canvas [installation section][canvas-install] for
+details.
+
+[canvas-install]: https://github.com/Automattic/node-canvas#installation
+
+__Run the sample:__
+
+Usage: `node faceDetection <path-to-image-file>`
+
+Example:
+
+    node faceDetection "./resources/face.png"
+
+[face_docs]: https://cloud.google.com/vision/docs/face-tutorial
+[face_code]: faceDetection.js
+
+### Text detection tutorial
+
+View the [source code][text_code].
+
+__Run the sample:__
+
+Usage: `node textDetection <command> [args]...`
+
+Analyze images:
+
+    node textDetection analyze "./resources/"
+
+Look up words:
+
+    node textDetection lookup the sunbeams in
+
+[text_code]: textDetection.js

packages/google-cloud-vision/samples/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "nodejs-docs-samples-vision",
+  "version": "0.0.1",
+  "private": true,
+  "license": "Apache-2.0",
+  "author": "Google Inc.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git"
+  },
+  "engines": {
+    "node": ">=4.3.2"
+  },
+  "scripts": {
+    "lint": "samples lint",
+    "pretest": "npm run lint",
+    "test": "samples test run --cmd ava -- -T 1m --verbose system-test/*.test.js"
+  },
+  "dependencies": {
+    "@google-cloud/storage": "1.1.0",
+    "@google-cloud/vision": "^0.12.0",
+    "async": "2.3.0",
+    "natural": "0.5.1",
+    "redis": "2.7.1",
+    "yargs": "7.1.0"
+  },
+  "devDependencies": {
+    "@google-cloud/nodejs-repo-tools": "1.4.14",
+    "ava": "0.19.1",
+    "proxyquire": "1.7.11",
+    "sinon": "2.1.0"
+  },
+  "optionalDependencies": {
+    "canvas": "1.6.5"
+  },
+  "cloud-repo-tools": {
+    "requiresKeyFile": true,
+    "requiresProjectId": true
+  }
+}

packages/google-cloud-vision/samples/quickstart.js

@@ -0,0 +1,46 @@
+/**
+ * Copyright 2017, 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.
+ */
+
+'use strict';
+
+// [START vision_quickstart]
+// Imports the Google Cloud client library
+const Vision = require('@google-cloud/vision');
+
+// Creates a client
+const vision = new Vision();
+
+// The name of the image file to annotate
+const fileName = './resources/wakeupcat.jpg';
+
+// Prepare the request object
+const request = {
+  source: {
+    filename: fileName
+  }
+};
+
+// Performs label detection on the image file
+vision.labelDetection(request)
+  .then((results) => {
+    const labels = results[0].labelAnnotations;
+
+    console.log('Labels:');
+    labels.forEach((label) => console.log(label.description));
+  })
+  .catch((err) => {
+    console.error('ERROR:', err);
+  });
+// [END vision_quickstart]