Modificare le proprietà dell'immagine target | PUT /target/<target_id>

Modifica le proprietà dell'immagine target corrispondente a target_id. I parametri vengono modificati in forma HTTP patch, mentre i parametri non modificati rimangono invariati.

Action

PUT /target/<target_id>

Autenticazione

Richiesta

Http Header

Content-Type=application/json

HTTP Header: Authorization (quando si usa l'autenticazione API Key Token)

Parametri della richiesta

Field	Type	Required	Description
image	String(base64)	Yes	Stringa codificata base64 del contenuto dell'immagine. Sono supportate immagini in formato JPG e PNG. La dimensione massima dell'immagine è 2MB.
active	String	No	"1" per abilitare il target, "0" per disabilitare il target. Il valore predefinito è "1".
name	String	Yes	Nome del target. Sono supportati solo lettere inglesi, punteggiatura inglese e numeri. Lunghezza minima 1 carattere, massima 64 caratteri.
size	String(Float)	Yes	Larghezza dell'immagine di riconoscimento (unità: cm). L'altezza dell'immagine di riconoscimento viene 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	Yes	Generalmente usato per archiviare informazioni di contenuto AR in formato stringa di testo. Il valore predefinito è "". Ad esempio: informazioni JSON dell'oggetto riconosciuto, codifica base64 di un'immagine o indirizzo URL di download di un file grande nel cloud storage. Massimo 2MB.
type	String (Float)	Yes	Deve essere configurato in modo fisso come stringa "ImageTarget". La distinzione tra maiuscole e minuscole deve essere esattamente uguale.
allowSimilar	String	No	Se consentire forzatamente l'aggiunta quando esistono immagini simili. Predefinito 0. Le immagini simili possono influenzare i risultati di riconoscimento, quindi si consiglia il valore predefinito.

Nota

image è limitato a un massimo di 2MB.
meta è limitato a un massimo 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 che l'autenticazione è corretta. Per ulteriori informazioni, vedere Codici di stato.
result	Messaggio di errore o informazioni sull'immagine target
timestamp	Ora lato server al ritorno della risposta. Usa il formato Unix timestamp, 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 (unità: cm). L'altezza dell'immagine di riconoscimento viene calcolata automaticamente dal sistema in base all'immagine caricata. La dimensione dell'immagine di riconoscimento corrisponde alla dimensione del contenuto virtuale sovrapposto
result.meta	Informazioni aggiuntive codificate base64, ad esempio una stringa generata dopo la codifica base64 di una stringa JSON
result.type	Fisso come ImageTarget
result.active	"1" abilitato, "0" disabilitato

Codici di errore

Vedere Elenco completo dei codici di stato e dei codici di errore

Table of Contents