画像 recognizability 難易度評価 | POST /grade/detection

画像の recognition 難易度を 0 から 4 の順にスコア付けします。値が大きいほど難易度が高いことを示します。-1 は、画像の破損や白紙など、画像が requirement を満たさないことによる recognition error を示します。

Best practice は、新しい target image を作成する前にこの API を呼び出すことです。

Grade	説明
0 または 1	Target は検出しやすい
2	普通
3 または 4	Target は検出しにくい

Action

3 つの API に分かれています。一般に image search by image のみの場合は、recognizability に関する総合評価だけが必要です。

POST /grade/detection
- recognizability に関する総合結果のみを提供します
POST /grade/tracking
- trackability に関する総合結果のみを提供します
POST /grade/detail
- 多次元の詳細なアルゴリズム評価を提供します

Authentication

必要

Http Header

Content-Type=application/json

HTTP Header: Authorization (API Key Token authentication を使用する場合)

request パラメータ

Field	Type	Required	Description
image	String(base64)	Yes	画像内容の base64 encoded string。JPG および PNG 形式の画像をサポートします。画像最大 2MB。

返却フィールド

フィールド	説明
statusCode	Status code 0 は authentication が正しいことを示します。詳細は Status code を参照してください
result	Error message、または grade
timestamp	response 返却時のサーバー側時刻。Unix timestamp 形式を使用し、単位はミリ秒
result.grade	[-1, 0, 1, 2, 3, 4]。0 と 1 は recognition しやすいことを示します。4 が最も recognition しにくいです。-1 は画像が requirement を満たさないことを示します。

Error codes

Status codes and error codes を参照してください

request 例

    POST /grade/detection/ HTTP/1.1
    Host:
    Date: Mon, 1 Jan 2018 00:00:00 GMT
    Content-Type: application/json
    {
        "image":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM...",
        "timestamp": 1514736000000,
        "appKey": "test_app_key",
        "signature": "89985e2420899196db5bdf16b3c2ed0922c0c221"
    }

return 例

    HTTP/1.1 200 OK
    Content-Type: application/json
    {
        "statusCode": 0,
        "result": {
            "grade": 1
        },
        "timestamp": 1514736000000
    }

Table of Contents