发布通知及创建地图元素

POST

/map/api/v1.0/projects/{project_uuid}/elements

通过本接口，第三方云平台可向司空 2 下发关键事件信息，包括事件时间、位置、描述等内容。

元素格式可参考：https://geojson.org/

请求参数

Path 参数

project_uuid

string

必需

示例值:

Header 参数

X-Organization-Key

string

组织密钥

必需

默认值:

Body 参数application/json

element_source

integer

保留字段，无需传入

必需

name

string

元素名称

必需

desc

string

元素描述

必需

resource

object

资源对象

必需

type

integer

必需

元素类型，0 ：点，1 ：线，2 ：面

content

object

内容

必需

示例

{
  "name": "元素名称",
  "desc": "描述",
  "resource": {
    "type": 0,
    "content": {
      "type": "Feature",
      "properties": {
        "color": "#2D8CF0",
        "clampToGround": true
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          108.42625652534299,
          30.59263023356542,
          0
        ]
      }
    }
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/map/api/v1.0/projects/{{project_uuid}}/elements' \
--header 'X-Organization-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "name": "元素名称",
  "desc": "描述",
  "resource": {
    "type": 0,
    "content": {
      "type": "Feature",
      "properties": {
        "color": "#2D8CF0",
        "clampToGround": true
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          108.42625652534299,
          30.59263023356542,
          0
        ]
      }
    }
  }
}'

返回响应

🟢200成功

application/json

Body

code

integer

非0代表异常

必需

message

string

消息提示

必需

data

object

必需

string

必需

示例

{
  "code": 0,
  "message": "success",
  "data": {
    "id": "cdb6f644-8925-463d-8977-564e866d7e86"
  }
}

🟠401未授权

获取指定项目的设备列表

获取项目临时上传凭证