繪圖套件需求

您可以使用 Azure 地圖服務轉換服務，將上傳的繪圖套件轉換為地圖資料。 本文將說明轉換 API 的繪圖套件需求。 若要查看範例套件，您可以下載繪圖套件範例。

必要條件

繪圖套件包含以 DWG 格式儲存的繪圖，這是 Autodesk 中 AutoCAD® 軟體的原生檔案格式。

在繪圖套件中，您可以選擇任何 CAD 軟體來產生繪圖。

轉換服務會將繪圖套件轉換成地圖資料。 轉換服務適用於 AUTOCAD DWG 檔案格式 AC1032。

詞彙

為了方便參考，以下是一些閱讀本文時很重要的詞彙和定義。

繪圖套件結構

繪製套件是包含下列檔案的 .zip 封存檔：

• AutoCAD DWG 檔案格式的 DWG 檔案。
• manifest.json 檔案，描述繪圖套件中的 DWG 檔案。

繪圖套件必須壓縮為單一封存檔，副檔名為 .zip。 DWG 檔案可以在套件內以任何方式組織，但是資訊清單檔案必須存留在已壓縮套件的根目錄。 下面各節將詳細說明 DWG 檔案、資訊清單檔案及這些檔案內容的需求。 若要檢視範例套件，您可以下載範例繪圖套件。

DWG 檔案轉換程序

轉換服務會在每個 DWG 檔案上執行下列作業：

• 擷取特徵類別：
  • 層級
  • 單位
  • 區域
  • 開口
  • 牆
  • 垂直穿透
• 產生設施特徵。
• 產生一組最少的預設類別特徵，供其他特徵參考：
  • 房間
  • 結構
  • wall
  • opening.door
  • 區域
  • 設施

DWG 檔案需求

設施的每個樓層都需要一個 DWG 檔案。 單一樓層的所有資料都必須包含在單一 DWG 檔案中。 任何外部參考 (xrefs) 都必須繫結至父系繪圖。 例如，具有三個樓層的設施在繪圖套件中有三個 DWG 檔案。

每個 DWG 都必須遵循下列需求：

• DWG 檔案必須定義外部和單位圖層。 可以選擇性地定義下列圖層：Wall、Door、UnitLabel、Zone 和 ZoneLabel。
• DWG 檔案不能包含多個樓層的特徵。
• DWG 檔案不能包含多個設施的特徵。
• DWG 必須參考與繪圖套件中其他 DWG 檔案相同的度量系統和度量單位。

DWG 圖層需求

每個 DWG 圖層都必須遵守下列規則：

• 圖層必須獨佔包含單一類別的特徵。 例如，單位和牆不能位於相同的圖層中。
• 單一特徵類別可由多個圖層表示。
• 允許自我交集多邊形，但是會自動修復。 修復時，轉換服務會引發警告。 建議您手動檢查已修復的結果，因為其可能不符合預期的結果。
• 每個圖層都有一份支援的實體類型清單。 圖層中的任何其他實體類型都會被忽略。 例如，牆圖層不支援文字實體。

下表概述每個圖層支援的實體類型和已轉換地圖特徵。 如果圖層包含不支援的實體類型，則轉換服務將會忽略這些實體。

下列各節說明每個圖層的需求。

外部圖層

每個樓層的 DWG 檔案都必須包含一個圖層，以定義該樓層的周邊。 此圖層稱為外部圖層。 例如，如果設施包含兩個樓層，則其需要有兩個 DWG 檔案，而每個檔案都會有一個外部圖層。

不論外部圖層中有多少個實體繪圖，產生的設施資料集都只會為每個 DWG 檔案包含一個樓層特徵。 此外：

• 外部圖層必須繪製成多邊形、聚合線條 (封閉)、圓形或橢圓形 (封閉)。
• 外部圖層可以重疊，但是會解析成一個幾何圖形。
• 產生的樓層特徵至少必須是 4 平方公尺。
• 產生的樓層特徵不得大於 40 萬平方公尺。

如果圖層包含多個重疊的聚合線條，則聚合線條會解析成單一樓層特徵。 或者，如果圖層包含多個非重疊的聚合線條，則產生的樓層特徵會有多個多邊形的表示方式。

外部圖層的範例可視為範例繪圖套件中的外框圖層。

單位圖層

每個樓層的 DWG 檔案都會定義一個包含單位的圖層。 單位是建築物中的可通行空間，例如辦公室、走廊、階梯和電梯。 如果已定義 VerticalPenetrationCategory 屬性，則跨越多個樓層的可導覽單位 (例如電梯或樓梯) 會轉換為「垂直穿透」特徵。 彼此重疊的垂直穿透特徵會獲指派一個 setid。

單位圖層應遵循下列需求：

• 單位圖層必須繪製成多邊形、聚合線條 (封閉)、圓形或橢圓形 (封閉)。
• 單位必須落在設施外部周邊的範圍內。
• 單位不能部分重疊。
• 單位不得包含任何自我相交的幾何圖形。

藉由在 UnitLabel 圖層中建立文字物件來命名單位，然後將物件放在該單位的界限內。 如需詳細資訊，請參閱 UnitLabel 圖層。

您可以在範例繪圖套件中看到單位圖層的範例。

牆圖層

每個樓層的 DWG 檔案都可包含一個圖層來定義牆、柱子和其他建築物結構的實體範圍。

• 牆圖層必須繪製成多邊形、聚合線條 (封閉)、圓形或橢圓形 (封閉)。
• 牆圖層應只包含會解譯為建築物結構的幾何圖形。

您可以在範例繪圖套件中看到牆圖層的範例。

門圖層

您可以納入包含門的 DWG 圖層。 每扇門都必須與單位圖層的單位邊緣重疊。

在 Azure 地圖服務資料集中，門的開口會表示為與多個單位界限重疊的單行線段。 下圖顯示 Azure 地圖服務如何將門圖層幾何轉換成資料集中的開口特徵。

區域圖層

每個樓層的 DWG 檔案都可包含一個區域圖層來定義區域的實體範圍。 區域是可命名和轉譯的非可導覽空間。 區域可以跨越多個樓層，並使用 zoneSetId 屬性分組在一起。

• 區域圖層必須繪製成多邊形、聚合線條 (封閉) 或橢圓形 (封閉)。
• 區域可以重疊。
• 區域可以落在設施外部周邊的內部或外部。

藉由在 ZoneLabel 圖層中建立文字物件來命名區域，並將文字物件放在區域的界限內。 如需詳細資訊，請參閱 ZoneLabel 圖層。

您可以在範例繪圖套件中看到區域圖層的範例。

UnitLabel 圖層

每個樓層的 DWG 檔案都可以包含 UnitLabel 圖層。 UnitLabel 圖層會將名稱屬性新增到從單位圖層擷取的單位。 具有名稱屬性的單位可以在資訊清單檔中指定更多詳細資料。

• 單位標籤必須是單行文字實體。
• 單位標籤必須完全落在其單位的界限內。
• 單位不能在 UnitLabel 圖層中包含多個文字實體。

您可以在範例繪圖套件中看到 UnitLabel 圖層的範例。

ZoneLabel 圖層

每個樓層的 DWG 檔案都可以包含 ZoneLabel 圖層。 此層會將名稱屬性新增至從區域圖層擷取的區域。 具有名稱屬性的區域可以在資訊清單檔中指定更多詳細資料。

• 區域標籤必須是單行文字實體。
• 區域標籤必須落在其區域的界限內。
• 區域不能在 ZoneLabel 圖層中包含多個文字實體。

您可以在範例繪圖套件中看到 ZoneLabel 圖層的範例。

資訊清單檔的需求

zip 資料夾必須在目錄的根樓層中包含資訊清單檔，而且該檔案必須命名為 manifest.json。 其中會描述可讓轉換服務剖析其內容的 DWG 檔案。 只有資訊清單所識別的檔案可擷取。 在 zip 資料夾中但未在資訊清單中正確列出的檔案將會遭到忽略。

雖然在使用資訊清單物件時有一些需求，但並非所有的物件都是必要的。 下表顯示轉換服務 1.1 版的必要和選用物件。

下面各節將詳細說明每個物件的需求。

directoryInfo

buildingLevels

buildingLevels 物件包含建築物樓層的 JSON 陣列。

georeference

dwgLayers

unitProperties

unitProperties 物件包含單位屬性的 JSON 陣列。

zoneProperties

zoneProperties 物件包含區域屬性的 JSON 陣列。

繪圖套件資訊清單範例

以下是繪圖套件範例的資訊清單檔。 移至 GitHub 上適用於 Azure 地圖服務建立工具的範例繪圖套件，以下載整個套件。

資訊清單檔

{
    "version": "1.1", 
    "directoryInfo": { 
        "name": "Contoso Building", 
        "streetAddress": "Contoso Way", 
        "unit": "1", 
        "locality": "Contoso eastside", 
        "postalCode": "98052", 
        "adminDivisions": [ 
            "Contoso city", 
            "Contoso state", 
            "Contoso country" 
        ], 
        "hoursOfOperation": "Mo-Fr 08:00-17:00 open", 
        "phone": "1 (425) 555-1234", 
        "website": "www.contoso.com", 
        "nonPublic": false, 
        "anchorLatitude": 47.636152, 
        "anchorLongitude": -122.132600, 
        "anchorHeightAboveSeaLevel": 1000, 
        "defaultLevelVerticalExtent": 3  
    }, 
    "buildingLevels": { 
        "levels": [ 
            { 
                "levelName": "Basement", 
                "ordinal": -1, 
                "filename": "./Basement.dwg" 
            }, { 
                "levelName": "Ground", 
                "ordinal": 0, 
                "verticalExtent": 5, 
                "filename": "./Ground.dwg" 
            }, { 
                "levelName": "Level 2", 
                "ordinal": 1, 
                "heightAboveFacilityAnchor": 3.5, 
                "filename": "./Level_2.dwg" 
            } 
        ] 
    }, 
    "georeference": { 
        "lat": 47.636152, 
        "lon": -122.132600, 
        "angle": 0 
    }, 
    "dwgLayers": { 
        "exterior": [ 
            "OUTLINE", "WINDOWS" 
        ], 
        "unit": [ 
            "UNITS" 
        ], 
        "wall": [ 
            "WALLS" 
        ], 
        "door": [ 
            "DOORS" 
        ], 
        "unitLabel": [ 
            "UNITLABELS" 
        ], 
        "zone": [ 
            "ZONES" 
        ], 
        "zoneLabel": [ 
            "ZONELABELS" 
        ] 
    }, 
    "unitProperties": [ 
        { 
            "unitName": "B01", 
            "categoryName": "room.office", 
            "occupants": [ 
                { 
                    "name": "Joe's Office", 
                    "phone": "1 (425) 555-1234" 
                } 
            ], 
            "nameAlt": "Basement01", 
            "nameSubtitle": "01", 
            "addressRoomNumber": "B01", 
            "nonPublic": true, 
            "isRoutable": true, 
            "isOpenArea": true 
        }, 
        { 
            "unitName": "B02" 
        }, 
        { 
            "unitName": "B05", 
            "categoryName": "room.office" 
        }, 
        { 
            "unitName": "STRB01", 
            "verticalPenetrationCategory": "verticalPenetration.stairs", 
            "verticalPenetrationDirection": "both" 
        }, 
        { 
            "unitName": "ELVB01", 
            "verticalPenetrationCategory": "verticalPenetration.elevator", 
            "verticalPenetrationDirection": "high_to_low" 
        } 
    ], 
    "zoneProperties": 
    [ 
        { 
            "zoneName": "WifiB01", 
            "categoryName": "Zone", 
            "zoneNameAlt": "MyZone", 
            "zoneNameSubtitle": "Wifi", 
            "zoneSetId": "1234" 
        }, 
        { 
            "zoneName": "Wifi101",
            "categoryName": "Zone",
            "zoneNameAlt": "MyZone",
            "zoneNameSubtitle": "Wifi",
            "zoneSetId": "1234"
        }
    ]
}

您可以使用 Azure 地圖服務轉換服務，將上傳的繪圖套件轉換為地圖資料。 本文將說明轉換 API 的繪圖套件需求。 若要檢視範例套件，您可以下載範例繪圖套件 v2。

如需如何準備繪圖套件的指南，請參閱繪圖套件指南。

變更和修訂

• 已新增對使用者定義功能類別的支援。
• 簡化 DWG 圖層的需求。

必要條件

繪圖套件包含以 DWG 格式儲存的繪圖，這是 Autodesk 中 AutoCAD® 軟體的原生檔案格式。

在繪圖套件中，您可以選擇任何 CAD 軟體來產生繪圖。

轉換服務會將繪圖套件轉換成地圖資料。 轉換服務適用於 AutoCAD DWG 檔案格式 AC1032。

詞彙

為了方便參考，以下是一些閱讀本文時很重要的詞彙和定義。

繪圖套件結構

繪製套件是包含下列檔案的 ZIP 封存檔：

• AutoCAD DWG 檔案格式的 DWG 檔案。
• manifest.json 檔案，描述繪圖套件中的 DWG 檔案。

繪圖套件必須壓縮為單一封存檔，副檔名為 .zip。 DWG 檔案可以在繪圖套件內以任何方式組織，但是資訊清單檔案必須存留在根目錄中。 下一節說明 DWG 和資訊清單檔案的轉換程序和需求，以及這些檔案的內容。 若要檢視範例套件，您可以下載範例繪圖套件 v2。

DWG 檔案轉換程序

Azure 地圖服務轉換服務會將設施的 DWG 檔案轉換為地圖資料，以代表設施和設施的功能。

Azure 地圖服務轉換服務會建立：

• 設施功能：設施的所有層級都關聯至設施的最上層功能。
• 樓層特徵：為設施的每個樓層建立一個樓層特徵。 樓層上的所有特徵都關聯至一個樓層。
• 使用者定義的功能：DWG 圖層會對應至使用者定義的特徵類別，並成為特徵類別的實例。

DWG 檔案需求

每個 DWG 檔案都必須遵循下列需求：

• DWG 檔案不能包含多個設施的特徵。
• DWG 檔案不能包含多個樓層的特徵。 例如，具有三個樓層的設施在繪圖套件中有三個 DWG 檔案。
• 單一樓層的所有資料都必須包含在單一 DWG 檔案中。 任何外部參考 (xrefs) 都必須繫結至父系繪圖。
• DWG 檔案必須定義代表該樓層界限的圖層。
• DWG 必須參考與繪圖套件中其他 DWG 檔案相同的度量系統和度量單位。
• 當 DWG 檔案堆疊在相同設施的另一個樓層上時，必須對齊 DWG 檔案。

DWG 圖層需求

特徵類別

一或多個 DWG 圖層可以對應至使用者定義的特徵類別。 該特徵的一個執行個體是從對應圖層上的實體建立的。 例如，DWG 圖層椅子、桌子和沙發會對應至稱為傢俱的特徵類別。 傢俱特徵是為定義圖層中的每個實體所建立。 此外：

• 所有圖層都應該分開，以代表設施的不同特徵類型。
• 所有實體都必須落在樓層周邊的界限內。
• 支援的 AutoCAD 實體類型：TEXT、MTEXT、POINT、ARC、CIRCLE、LINE、POLYLINE、ELLIPSE。

特徵類別屬性

落在封閉圖形界限內的文字實體可以作為屬性與該特徵相關聯。 例如，房間特徵類別可能有描述房間名稱的文字，而另一個房間類型範例繪圖套件 v2。 此外：

• 只有 TEXT 和 MTEXT 實體可以作為屬性與該特徵相關聯。 其他所有實體類型都會被忽略。
• TEXT 和 MTEXT 對齊點必須落在封閉圖形的界限內。
• 如果多個 TEXT 屬性位於封閉圖形的界限內，而且兩者都對應至一個屬性，則會隨機選取一個屬性。

設施樓層

每個樓層的 DWG 檔案都必須包含一個圖層，以定義該樓層的周邊。 例如，如果設施包含兩個樓層，則其需要有兩個 DWG 檔案，而每個檔案都有一個定義該樓層周邊的圖層。

不論樓層周邊的圖層中有多少個實體繪圖，產生的設施資料集都只會為每個 DWG 檔案包含一個樓層特徵。 此外：

• 樓層周邊必須繪製成多邊形、聚合線條 (封閉)、圓形或橢圓形 (封閉)。
• 樓層周邊可以重疊，但是會解析成一個幾何圖形。
• 產生的樓層特徵至少必須是 4 平方公尺。
• 產生的樓層特徵不得大於 40 萬平方公尺。

如果圖層包含多個重疊的聚合線條，則聚合線條會合併成單一樓層特徵。 或者，如果圖層包含多個非重疊的聚合線條，則產生的樓層特徵會有多個多邊形的表示方式。

樓層周邊圖層的範例可視為GROS$範例繪圖套件 v2 中的 圖層。

資訊清單檔的需求

繪圖套件必須在根樓層中包含資訊清單檔，而且該檔案必須命名為 manifest.json。 其中會描述可讓轉換服務剖析其內容的 DWG 檔案。 只有資訊清單所識別的檔案可使用。 在繪圖套件中但未在資訊清單中正確列出的檔案將會遭到忽略。

在資訊清單檔的 buildingLevels 物件中，檔案路徑必須相對於繪圖套件的根目錄。 DWG 檔案名稱必須完全符合設施樓層的名稱。 例如，「地下室」樓層的 DWG 檔案會是 Basement.dwg。 樓層 2 的 DWG 檔案會命名為 level_2.dwg。 檔名不能包含空格，您可以使用底線來取代任何空格。

雖然在使用資訊清單物件時有一些需求，但並非所有的物件都是必要的。 下表顯示 2023-03-01-preview 轉換服務的必要和選擇性物件。

資訊清單 JSON 檔案

下面各節將詳細說明每個物件的需求。

buildingLevels

level

featureClass

featureClassProperty

georeference

繪圖套件資訊清單範例

此範例中的 JSON 顯示繪圖套件範例的資訊清單檔。 移至 GitHub 上適用於 Azure 地圖服務建立工具的範例繪圖套件 v2，以下載整個套件。

資訊清單檔

{
  "version": "2.0",
  "buildingLevels": {
    "dwgLayers": [
      "GROS$"
    ],
    "levels": [
      {
        "filename": "Ground.dwg",
        "levelName": "level 1",
        "ordinal": 0
      },
      {
        "filename": "Level_2.dwg",
        "levelName": "level 2",
        "ordinal": 1
      }
    ]
  },
  "georeference": {
    "lat": 47.63529901,
    "lon": -122.13355885,
    "angle": 0
  },
  "featureClasses": [
    {
      "featureClassName": "room",
      "dwgLayers": [
        "RM$"
      ],
      "featureClassProperties": [
        {
          "featureClassPropertyName": "name",
          "dwgLayers": [
            "A-IDEN-NUMR-EXST"
          ]
        },
        {
          "featureClassPropertyName": "roomType",
          "dwgLayers": [
            "A-IDEN-NAME-EXST"
          ]
        }
      ]
    },
    {
      "featureClassName": "wall",
      "dwgLayers": [
        "A-WALL-EXST",
        "A-WALL-CORE-EXST",
        "A-GLAZ-SILL-EXST",
        "A-GLAZ-SHEL-SILL-EXST",
        "A-GLAZ-SHEL-EXST",
        "A-GLAZ-EXST"
      ]
    },
    {
      "featureClassName": "workspace",
      "dwgLayers": [
        "A-BOMA"
      ]
    },
    {
      "featureClassName": "workspaceFurniture",
      "dwgLayers": [
        "A-FURN-SYTM-EXST"
      ]
    },
    {
      "featureClassName": "buildingFurniture",
      "dwgLayers": [
        "A-FURN-FREE-EXST"
      ]
    }
  ],
  "facilityName": "Contoso Building"
}