接入指南
產品簡介
空間結構化建模 Open API 面向第三方系統，提供從三維採集數據到可編輯模型的雲端自動化處理能力。
業務鏈路：上傳 LCC2 場景包、LAS 點雲或 PLY 點雲 → 雲端自動建模 → 產出 DXF / GLB / BLEND 三維模型，並附帶 Revit 模型（RVT）。
適用場景
- 竣工圖交付：從現場掃描直接得到平面圖與剖面圖底圖，替代人工翻模。
- 存量改造設計：拿到帶尺寸的牆體與門窗，直接在 CAD 中做方案。
- 房源與資產管理：批量產出戶型圖與面積表。
- 可行性與工程量：讀取結構化數據做拆改判斷、材料估算。
使用限制
| 項 | 限制 |
|---|---|
| 接口並發 | 每個接口 10 次 / 秒 |
| 建模任務並發 | 不限制，任務提交後直接進入排隊 |
| 單次批量查詢 | 任務詳情接口最多 50 個 modelId |
| 輪詢間隔 | 建議不低於 5 秒 |
| 上傳臨時憑證有效期 | 12 小時 |
| 分片數量上限 | 10000 片 |
| 上傳心跳超時 | 180 秒，超時任務置為上傳失敗 |
| 單 modelId 頻控 | 任務開始執行、再次獲取上傳密鑰接口存在 3 秒頻控 |
購買服務
本服務已在 AWS Marketplace 上架，可前往 AWS Marketplace 商品頁 訂閱購買。
獲取應用憑證
接入前需提前申請應用，獲取以下憑證。
| 憑證 | 說明 |
|---|---|
| APP-ID | 應用唯一標識 |
| APP-Secret | 應用密鑰，用於生成簽名 |
注：APP-Secret 請妥善保管，不得洩露。密鑰僅用於服務端生成簽名，不得下發到客戶端或寫入前端代碼。
數據存儲區域在申請應用時綁定，調用接口時無需傳入。
簽名機制
簽名參與元素
| 參與元素 | 來源 | 規則說明 |
|---|---|---|
| httpMethod | 請求方法 | 大寫，本文檔所有接口均為 POST |
| path | 請求路徑 | 必須是包含 /open-apis 前綴的完整路徑 |
| timestamp | X-Timestamp | 秒級時間戳，與 Header 傳入值完全一致 |
| nonce | X-Nonce | 隨機字符串，與 Header 傳入值完全一致 |
待簽名字符串
\n 為換行符。請求體不參與簽名。
httpMethod + "\n" + path + "\n" + timestamp + "\n" + nonce
示例：
POST
/open-apis/spatial-model/v1/model/create
1791763200
a3f91c2d8e7b4a6590fd12cb77ae40d1
簽名算法
| 項 | 值 |
|---|---|
| 算法 | HMAC-SHA256 |
| 密鑰 | APP-Secret |
| 輸出 | Base64 編碼字符串 |
示例代碼
public static void main(String[] args) throws Exception {
String httpMethod = "POST";
String path = "/open-apis/spatial-model/v1/model/create";
long timestamp = System.currentTimeMillis() / 1000;
String nonce = UUID.randomUUID().toString().replaceAll("-", "");
// 1. 構造待簽名字符串
String signContent = httpMethod + "\n" + path + "\n" + timestamp + "\n" + nonce;
// 2. HMAC-SHA256
String appSecret = "xxxxxxxxxxxxxxxxxxx";
Mac mac = Mac.getInstance("HmacSHA256");
SecretKeySpec secretKey =
new SecretKeySpec(appSecret.getBytes(StandardCharsets.UTF_8), "HmacSHA256");
mac.init(secretKey);
byte[] rawHmac = mac.doFinal(signContent.getBytes(StandardCharsets.UTF_8));
// 3. Base64 編碼
System.out.println(Base64.getEncoder().encodeToString(rawHmac));
}
完成接入準備後，閱讀 建模流程 了解完整調用鏈路。