Valutazione della difficolta di recognizability immagine | POST /grade/detection

Assegna un punteggio alla difficolta di recognition dell'immagine da 0 a 4 in ordine. Un valore piu alto indica una difficolta maggiore. -1 indica un recognition error causato da un'immagine che non soddisfa i requirement, ad esempio immagine danneggiata o foglio bianco.

La best practice e chiamare questa API prima di creare una nuova target image.

Grade	Descrizione
0 o 1	Il target e facile da rilevare
2	Medio
3 o 4	Il target e difficile da rilevare

Action

Sono disponibili tre API. In generale, per image search by image, serve solo la valutazione complessiva di recognizability.

POST /grade/detection
- Fornisce solo il risultato complessivo di recognizability
POST /grade/tracking
- Fornisce solo il risultato complessivo di trackability
POST /grade/detail
- Fornisce valutazioni algoritmo dettagliate multidimensionali

Authentication

Richiesta

Http Header

Content-Type=application/json

HTTP Header: Authorization (quando si usa authentication API Key Token)

Parametri request

Field	Type	Required	Description
image	String(base64)	Yes	Stringa codificata base64 del contenuto immagine. Supporta immagini JPG e PNG. Dimensione massima immagine 2MB.

Campi di ritorno

Campo	Descrizione
statusCode	Status code 0 indica che authentication e corretta. Per maggiori informazioni vedere Status code
result	Messaggio di errore, oppure grade
timestamp	Ora lato server quando viene restituita la response. Usa formato Unix timestamp, in millisecondi
result.grade	[-1, 0, 1, 2, 3, 4], dove 0 e 1 indicano recognition facile. 4 e il piu difficile da riconoscere. -1 indica che l'immagine non soddisfa i requirement.

Error codes

Vedere Status codes ed error codes

Esempio 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"
    }

Esempio ritorno

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

Table of Contents