修改目标图像 | PUT /target/<TargetID>

功能

修改目标图像。没有更新的参数保持不变,支持patch形式修改部分参数。

动作

PUT /target/<TargetID>

认证

请求参数:

字段名

类型

必须

描述

image

base64编码字符串

图像内容的base64编码字符串,支持JPG和PNG格式图像。文件最大2MB。

active

字符串(整数型的内容)

"1" 来启用目标,"0" 来停用目标。默认为 "1",不是维持不变请注意。

name

字符串

目标名称,仅支持英文字母、英文标点、数字,长度最小1个字符,最大64个字符

size

字符串(浮点型的内容)

识别图宽度(单位cm)。识别图的高度将由系统根据您上传的图片自动计算。识别图的大小和虚拟内容的大小对应。默认20

meta

字符串

一般用于存储AR内容信息,文本字符串格式,默认是""。 例如:识别物的JSON信息,图片的base64编码,或者是大文件在云存储的URL下载地址。

allowSimilar

字符串

如果存在相似图是否强制允许添加,默认0.相似图可能影响识别结果,建议采用默认。

响应字段

POST /targets/

样例

请求

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

返回

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",
        "active":"1",
        "trackableRate": 0,
        "detectableRate": 0,
        “detectableDistinctiveness”:0,
        "detectableFeatureCount", 0,
        "trackableDistinctiveness", 0,
        "trackableFeatureCount", 0,
        "trackableFeatureDistribution", 0,
        "trackablePatchContrast", 0,
        "trackablePatchAmbiguity", 0
      }
    },
    "timestamp": 1514736000000
}

样例实现:

EasyAR为开发者提供了几个语言的 Target Management Samples,方便程序调用实现自动化: