クイックスタート: クライアントライブラリの使用

このページでは、お好みのプログラミング言語で Cloud Vision API の使用を開始する方法について説明します。

始める前に

vision-json.googleapis.com Cloud Vision API SERVICE_ACCOUNT env_var

Google アカウントにログインします。
Google アカウントをまだお持ちでない場合は、新しいアカウントを登録します。
GCP Console のプロジェクトセレクタのページで、GCP プロジェクトを選択または作成します。

注: この手順で作成するリソースをそのまま保持する予定でない場合、既存のプロジェクトを選択するのではなく、プロジェクトを作成してください。チュートリアルの完了後にそのプロジェクトを削除すれば、プロジェクトに関連するすべてのリソースを削除できます。

プロジェクトセレクタのページに移動
Google Cloud Platform プロジェクトに対して課金が有効になっていることを確認します。プロジェクトに対して課金が有効になっていることを確認する方法を学習する。

v1-rev71-1.25.0 https://googleapis.dev/java/google-cloud-clients/latest/com/google/cloud/spanner/ 1.2.0 https://cloud.spring.io/spring-cloud-static/spring-cloud-gcp/.RELEASE/

クライアントライブラリのインストール

C#

C# 開発環境の設定の詳細については、C# 開発環境設定ガイドをご覧ください。

Install-Package Google.Cloud.Vision.V1 -Pre

Go

go get -u cloud.google.com/go/vision/apiv1

Java

Java 開発環境の設定の詳細については、Java 開発環境設定ガイドをご覧ください。 Maven を使用している場合は、次のものを pom.xml ファイルに追加します。

<dependencyManagement>
      <dependencies>
        <dependency>
          <groupId>com.google.cloud</groupId>
          <artifactId>libraries-bom</artifactId>
          <version>4.1.0</version>
          <type>pom</type>
          <scope>import</scope>
        </dependency>
      </dependencies>
    </dependencyManagement>

    <dependencies>
      <dependency>
        <groupId>com.google.cloud</groupId>
        <artifactId>google-cloud-vision</artifactId>
      </dependency>
    </dependencies>

Gradle を使用している場合は、次のものを依存関係に追加します。

compile 'com.google.cloud:google-cloud-vision:1.99.1'

SBT を使用している場合は、次のものを依存関係に追加します。

libraryDependencies += "com.google.cloud" % "google-cloud-vision" % "1.99.1"

IntelliJ または Eclipse を使用している場合は、次の IDE プラグインを使用してプロジェクトにクライアントライブラリを追加できます。

プラグインでは、サービスアカウントのキー管理などの追加機能も提供されます。詳細は各プラグインのドキュメントをご覧ください。

Node.js

Node.js 開発環境の設定の詳細については、Node.js 開発環境設定ガイドをご覧ください。

npm install --save @google-cloud/vision

PHP

composer require google/cloud-vision

Python

Python 開発環境の設定の詳細については、Python 開発環境設定ガイドをご覧ください。

pip install --upgrade google-cloud-vision

Ruby

Ruby 開発環境の設定の詳細については、Ruby 開発環境設定ガイドをご覧ください。

gem install google-cloud-vision

ラベル検出

これで、Vision API を使用して画像の情報をリクエストできるようになりました（ラベル検出など）。次のコードを実行して、画像ラベル検出リクエストを実行してみてください。

C#

このサンプルを試す前に、Vision API クイックスタート: クライアントライブラリの使用の C# の設定手順を実施してください。詳細については、Vision API C# API のリファレンスドキュメントをご覧ください。

GitHub で表示フィードバック


    using Google.Cloud.Vision.V1;
    using System;

    namespace GoogleCloudSamples
    {
        public class QuickStart
        {
            public static void Main(string[] args)
            {
                // Instantiates a client
                var client = ImageAnnotatorClient.Create();
                // Load the image file into memory
                var image = Image.FromFile("wakeupcat.jpg");
                // Performs label detection on the image file
                var response = client.DetectLabels(image);
                foreach (var annotation in response)
                {
                    if (annotation.Description != null)
                        Console.WriteLine(annotation.Description);
                }
            }
        }
    }

Go

このサンプルを試す前に、Vision API クイックスタート: クライアントライブラリの使用の Go の設定手順を実施してください。詳細については、Vision API Go API のリファレンスドキュメントをご覧ください。

GitHub で表示フィードバック


    // Sample vision-quickstart uses the Google Cloud Vision API to label an image.
    package main

    import (
    	"context"
    	"fmt"
    	"log"
    	"os"

    	vision "cloud.google.com/go/vision/apiv1"
    )

    func main() {
    	ctx := context.Background()

    	// Creates a client.
    	client, err := vision.NewImageAnnotatorClient(ctx)
    	if err != nil {
    		log.Fatalf("Failed to create client: %v", err)
    	}
    	defer client.Close()

    	// Sets the name of the image file to annotate.
    	filename := "../testdata/cat.jpg"

    	file, err := os.Open(filename)
    	if err != nil {
    		log.Fatalf("Failed to read file: %v", err)
    	}
    	defer file.Close()
    	image, err := vision.NewImageFromReader(file)
    	if err != nil {
    		log.Fatalf("Failed to create image: %v", err)
    	}

    	labels, err := client.DetectLabels(ctx, image, nil, 10)
    	if err != nil {
    		log.Fatalf("Failed to detect labels: %v", err)
    	}

    	fmt.Println("Labels:")
    	for _, label := range labels {
    		fmt.Println(label.Description)
    	}
    }

Java

このサンプルを試す前に、Vision API クイックスタート: クライアントライブラリの使用の Java の設定手順を実施してください。詳細については、Vision API Java API のリファレンスドキュメントをご覧ください。

GitHub で表示フィードバック

// Imports the Google Cloud client library

    import com.google.cloud.vision.v1.AnnotateImageRequest;
    import com.google.cloud.vision.v1.AnnotateImageResponse;
    import com.google.cloud.vision.v1.BatchAnnotateImagesResponse;
    import com.google.cloud.vision.v1.EntityAnnotation;
    import com.google.cloud.vision.v1.Feature;
    import com.google.cloud.vision.v1.Feature.Type;
    import com.google.cloud.vision.v1.Image;
    import com.google.cloud.vision.v1.ImageAnnotatorClient;
    import com.google.protobuf.ByteString;
    import java.nio.file.Files;
    import java.nio.file.Path;
    import java.nio.file.Paths;
    import java.util.ArrayList;
    import java.util.List;

    public class QuickstartSample {
      public static void main(String... args) throws Exception {
        // Instantiates a client
        try (ImageAnnotatorClient vision = ImageAnnotatorClient.create()) {

          // The path to the image file to annotate
          String fileName = "./resources/wakeupcat.jpg";

          // Reads the image file into memory
          Path path = Paths.get(fileName);
          byte[] data = Files.readAllBytes(path);
          ByteString imgBytes = ByteString.copyFrom(data);

          // Builds the image annotation request
          List<AnnotateImageRequest> requests = new ArrayList<>();
          Image img = Image.newBuilder().setContent(imgBytes).build();
          Feature feat = Feature.newBuilder().setType(Type.LABEL_DETECTION).build();
          AnnotateImageRequest request = AnnotateImageRequest.newBuilder()
              .addFeatures(feat)
              .setImage(img)
              .build();
          requests.add(request);

          // Performs label detection on the image file
          BatchAnnotateImagesResponse response = vision.batchAnnotateImages(requests);
          List<AnnotateImageResponse> responses = response.getResponsesList();

          for (AnnotateImageResponse res : responses) {
            if (res.hasError()) {
              System.out.printf("Error: %s\n", res.getError().getMessage());
              return;
            }

            for (EntityAnnotation annotation : res.getLabelAnnotationsList()) {
              annotation.getAllFields().forEach((k, v) ->
                  System.out.printf("%s : %s\n", k, v.toString()));
            }
          }
        }
      }
    }

Node.js

このサンプルを試す前に、Vision API クイックスタート: クライアントライブラリの使用の Node.js の設定手順を実施してください。詳細については、Vision API Node.js API のリファレンスドキュメントをご覧ください。

GitHub で表示フィードバック

async function quickstart() {
      // Imports the Google Cloud client library
      const vision = require('@google-cloud/vision');

      // Creates a client
      const client = new vision.ImageAnnotatorClient();

      // Performs label detection on the image file
      const [result] = await client.labelDetection('./resources/wakeupcat.jpg');
      const labels = result.labelAnnotations;
      console.log('Labels:');
      labels.forEach(label => console.log(label.description));
    }

PHP

このサンプルを試す前に、Vision API クイックスタート: クライアントライブラリの使用の PHP の設定手順を実施してください。詳細については、Vision API PHP API のリファレンスドキュメントをご覧ください。

GitHub で表示フィードバック

# includes the autoloader for libraries installed with composer
    require __DIR__ . '/vendor/autoload.php';

    # imports the Google Cloud client library
    use Google\Cloud\Vision\V1\ImageAnnotatorClient;

    # instantiates a client
    $imageAnnotator = new ImageAnnotatorClient();

    # the name of the image file to annotate
    $fileName = 'test/data/wakeupcat.jpg';

    # prepare the image to be annotated
    $image = file_get_contents($fileName);

    # performs label detection on the image file
    $response = $imageAnnotator->labelDetection($image);
    $labels = $response->getLabelAnnotations();

    if ($labels) {
        echo("Labels:" . PHP_EOL);
        foreach ($labels as $label) {
            echo($label->getDescription() . PHP_EOL);
        }
    } else {
        echo('No label found' . PHP_EOL);
    }

Python

このサンプルを試す前に、Vision API クイックスタート: クライアントライブラリの使用の Python の設定手順を実施してください。詳細については、Vision API Python API のリファレンスドキュメントをご覧ください。

GitHub で表示フィードバック

import io
    import os

    # Imports the Google Cloud client library
    from google.cloud import vision
    from google.cloud.vision import types

    # Instantiates a client
    client = vision.ImageAnnotatorClient()

    # The name of the image file to annotate
    file_name = os.path.abspath('resources/wakeupcat.jpg')

    # Loads the image into memory
    with io.open(file_name, 'rb') as image_file:
        content = image_file.read()

    image = types.Image(content=content)

    # Performs label detection on the image file
    response = client.label_detection(image=image)
    labels = response.label_annotations

    print('Labels:')
    for label in labels:
        print(label.description)

Ruby

このサンプルを試す前に、Vision API クイックスタート: クライアントライブラリの使用の Ruby の設定手順を実施してください。詳細については、Vision API Ruby API のリファレンスドキュメントをご覧ください。

GitHub で表示フィードバック

# Imports the Google Cloud client library
    require "google/cloud/vision"

    # Instantiates a client
    image_annotator = Google::Cloud::Vision::ImageAnnotator.new

    # The name of the image file to annotate
    file_name = "./resources/cat.jpg"

    # Performs label detection on the image file
    response = image_annotator.label_detection image: file_name
    response.responses.each do |res|
      puts "Labels:"
      res.label_annotations.each do |label|
        puts label.description
      end
    end

これで、Vision API に最初のリクエストが送信されました。

いかがでしたか。

クリーンアップ

このクイックスタートで使用するリソースで Google Cloud Platform アカウントに課金されないようにする手順は次のとおりです。

プロジェクトを必要としない場合は、Cloud Console を使用して削除します。

次のステップ

Cloud Vision API クライアントライブラリの詳細を確認します。

クイックスタート: クライアント ライブラリの使用

始める前に

クライアント ライブラリのインストール

C#

Go

Java

Node.js

PHP

Python

Ruby

ラベル検出

C#

Go

Java

Node.js

PHP

Python

Ruby

いかがでしたか。

クリーンアップ

次のステップ

クイックスタート: クライアントライブラリの使用

クライアントライブラリのインストール