Modifica attributi immagine target | PUT /target/<target_id>
Modifica gli attributi dell'immagine target corrispondente a target_id. Utilizza patch Http per modificare i parametri, mantenendo invariati i parametri non modificati.
Action
PUT /target/<target_id>
Autenticazione
Http header
Content-Type=application/json
HTTP Header: Authorization (quando si utilizza l'autenticazione tramite token API Key)
Parametri richiesta
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| image | String(base64) | Sì | Stringa codificata base64 del contenuto dell'immagine, supporta formati JPG e PNG. Dimensioni massime dell'immagine: 2MB. |
| active | String | No | "1" per attivare il target, "0" per disattivarlo. Predefinito "1". |
| name | String | Sì | Nome del target, supporta solo lettere inglesi, punteggiatura inglese, numeri. Lunghezza minima: 1 carattere, massima: 64 caratteri. |
| size | String (Float) | Sì | Larghezza dell'immagine di riconoscimento (in cm). L'altezza verrà calcolata automaticamente dal sistema in base all'immagine caricata. La dimensione dell'immagine di riconoscimento corrisponde alla dimensione del contenuto virtuale. Predefinito 20. |
| meta | String | Sì | Utilizzato generalmente per memorizzare informazioni sul contenuto AR, formato stringa di testo, predefinito "". Esempio: informazioni JSON dell'oggetto riconoscibile, codifica base64 dell'immagine o URL di download di file di grandi dimensioni su cloud storage. Dimensione massima: 2MB. |
| type | String | Sì | Deve essere configurato esattamente come la stringa "ImageTarget", rispettando esattamente maiuscole/minuscole. |
| allowSimilar | String | No | Se esiste un'immagine simile, consente forzatamente l'aggiunta. Predefinito 0. Immagini simili possono influenzare i risultati del riconoscimento, si consiglia di utilizzare il valore predefinito. |
Nota
- image ha una dimensione massima di 2MB.
- meta ha una dimensione massima di 2MB.
Esempio di richiesta
PUT /target/e61db301-e80f-4025-b822-9a00eb48d8d2 HTTP/1.1
Host:
Date: Mon, 1 Jan 2018 00:00:00 GMT
Content-Type: application/json
{
"active":"1",
"name":"easyar",
"size":"5",
"meta":"496fbbabc2b38ecs3460a...",
"timestamp": 1514736000000,
"appKey": "test_app_key",
"signature": "89985e2420899196db5bdf16b3c2ed0922c0c221"
}
Esempio di risposta
HTTP/1.1 200 OK
Content-Type: application/json
{
"statusCode": 0,
"result": {
"target": {
"targetId":"e61db301-e80f-4025-b822-9a00eb48d8d2",
"trackingImage":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM..."，
"name": "easyar",
"size": "5",
"meta": "496fbbabc2b38ecs3460a...",
"type": "ImageTarget",
"date": "2016-06-15T09:56:30.000Z",
"active":"1",
"trackableRate": 0,
"detectableRate": 0,
"detectableDistinctiveness"：0,
"detectableFeatureCount": 0,
"trackableDistinctiveness": 0,
"trackableFeatureCount": 0,
"trackableFeatureDistribution": 0,
"trackablePatchContrast": 0,
"trackablePatchAmbiguity": 0
}
},
"timestamp": 1514736000000
}
Campi di risposta
| Campo | Descrizione |
|---|---|
| statusCode | Codice di stato 0 indica autenticazione corretta, per ulteriori informazioni vedi Codici di stato |
| result | Messaggio di errore o informazioni sull'immagine target |
| timestamp | Orario del server al momento della risposta. Utilizza il formato timestamp Unix, in millisecondi |
| result.targetId | ID univoco dell'immagine target |
| result.trackingImage | Stringa codificata base64 dell'immagine di tracking |
| result.name | Nome del target |
| result.size | Larghezza dell'immagine di riconoscimento (in cm). L'altezza verrà calcolata automaticamente dal sistema in base all'immagine caricata. La dimensione corrisponde a quella del contenuto virtuale sovrapposto |
| result.meta | Informazioni aggiuntive codificate base64, ad esempio una stringa generata dalla codifica base64 di una stringa JSON |
| result.type | Fissato su ImageTarget |
| result.active | "1" attivo, "0" disattivato |