轉換繪圖套件指南

本指南說明如何使用特定 CAD 命令準備 Azure 地圖服務轉換服務繪圖套件，以正確準備轉換服務的 DWG 檔案和資訊清單檔。

開始前，請確定您的繪圖套件格式為 .zip，且包含下列檔案：

• DWG 格式的一或多個繪圖檔。
• 描述 DWG 檔和設施中繼資料的資訊清單檔。

如果您沒有自己的套件能與本指南一起參考，可以下載範例繪圖套件。

您可以選擇任何 CAD 軟體來開啟並準備設施繪圖檔。 不過本指南是使用 Autodesk 的AutoCAD ®軟體所建立。 本指南中參考的所有命令都是使用 Autodesk 的 AutoCAD® 軟體執行的。

詞彙

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

步驟 1：DWG 檔案需求

準備設施繪圖檔以使用轉換服務時，請務必遵循下列初步需求和建議：

• 設施繪圖檔必須以 DWG 格式儲存，這是 Autodesk AutoCAD® 軟體的原生檔案格式。

• 轉換服務適用於 AUTOCAD DWG 檔案格式。 AC1032 是 DWG 檔的內部格式版本，最好選取 AC1032 作為內部 DWG 檔案格式版本。

• DWG 檔只能包含單一樓層。 設施的每個樓層都必須以各自的 DWG 檔提供。 因此，如果您的設施中有五個樓層，就必須建立五個不同的 DWG 檔。

步驟 2：準備 DWG 檔

本指南的這個部分示範如何使用 CAD 命令，確保 DWG 檔案符合轉換服務的需求。

您可以選擇任何 CAD 軟體來開啟並準備設施繪圖檔。 不過本指南是使用 Autodesk 的AutoCAD ®軟體所建立。 本指南中參考的所有命令都是使用 Autodesk 的 AutoCAD® 軟體執行的。

繫結外部參考

設施的每個樓層都必須以一個 DWG 檔提供。 如果沒有外部參考，就不需要再執行任何動作。 不過如果有任何外部參考，則必須繫結至單一繪圖。 若要繫結外部參考，可以使用 XREF 命令。 繫結之後，每個外部參考繪圖都會新增為區塊參考。 如需變更這些圖層中的任何一個，請記得使用 XPLODE 命令分解區塊參考。

測量單位

繪圖可以使用任何測量單位來建立。 不過所有繪圖都須使用相同的測量單位。 因此，如果設施的一個樓層使用公釐，則所有其他樓層 (繪圖) 也須以公釐為單位。 可以使用 UNITS 命令來驗證或修改測量單位。

下圖顯示 Autodesk AutoCAD® 軟體內的「繪圖單位」視窗，可用來確認測量單位。

對齊方式

設施的每個樓層都需以個自的 DWG 檔提供。 因此彼此堆疊時，樓層可能不會完全對齊。 Azure 地圖轉換服務要求所有繪圖都與實體空間對齊。 若要確認對齊情況，請使用可跨越樓層的參考點，例如跨多個樓層的電梯或柱子。 您可以開啟新的繪圖來檢視所有樓層，再使用 XATTACH 命令載入所有樓層繪圖。 如需修正任何對齊問題，您可以使用參考點和 MOVE 命令來重新對齊所需的樓層。

圖層

確定繪圖的每一個圖層都包含一個特徵類別的實體。 如果圖層包含牆的實體，就不能含有其他特徵，例如單位或門。 不過特徵類別可以分割成多個圖層。 例如，繪圖中可以有三個圖層包含牆實體。

此外，每個圖層都有一個清單列出支援的實體類型，以及會忽略的其他任何類型。 例如，如果單位標籤圖層只支援單行文字，就會忽略相同圖層上的多行文字或聚合線條。

如需深入了解圖層和特徵類別，請參閱繪圖套件需求。

外部圖層

單圖層特色需從每個外部圖層建立。 此圖層特色定義了圖層的周邊區域。 請務必確保外部圖層中的實體符合圖層的需求。 例如，支援封閉的聚合線條；但不支援開放的聚合線條。 如果您的外部圖層是由多個線段組成，則必須以一個封閉聚合線條形式提供。 若要將多個線段聯結在一起，請選取所有線段並使用 JOIN 命令。

下圖取自範例套件，並以紅色顯示設施的外部圖層。 單位圖層會關閉，以協助呈現視覺效果。

單位圖層

單位是建築物中的可通行空間，例如辦公室、走廊、階梯和電梯。 必須以封閉的實體類型 (例如多邊形)、封閉的聚合線條、圓形或封閉的橢圓形代表每個單位。 因此，只有牆和門無法建立一個單位，因為沒有代表該單位的實體。

下圖取自範例繪圖套件，並以紅色顯示單位標籤圖層和單位圖層。 所有其他圖層都會關閉，以協助呈現視覺效果。 此外，系統會選取一個單位，協助顯示每個單位都是封閉的聚合線條。

單位標籤圖層

如果您想要將名稱屬性新增至單位，請為單位標籤新增個別圖層。 標籤必須以單行文字實體的形式提供，而這些實體需落在單位的界限內。 對應的單位屬性必須新增至資訊清單檔，其中 unitName 與文字內容相符。 若要了解所有支援的單位屬性，請參閱：unitProperties。

門圖層

門是選用項目。 不過如果您想要指定單位的進入點，則可以使用門。 只要是門圖層支援的實體類型，都能以任意方式繪製門。 門必須與單位的界限重疊，而單位的重疊邊緣會視為單位的開口。

下圖取自範例繪圖套件，顯示一個單位的門 (紅色) 繪製在單位界限上。

牆圖層

牆圖層的用意是代表設施的實體範圍，例如牆和柱子。 Azure 地圖轉換服務會將牆視為阻礙路徑的實體結構。 請記住，牆應該視為可以看見但無法穿過的實體結構。 任何看不見的東西都無法在此圖層中擷取。 如果牆中有內牆或柱子，則應該只擷取外牆。

步驟 3：準備資訊清單

繪圖套件資訊清單是 JSON 檔。 資訊清單會告訴 Azure 地圖轉換服務如何解讀設施 DWG 檔和中繼資料。 這些資訊的範例可能是每個 DWG 圖層包含的特定資訊，或是設施的地理位置。

若要成功進行轉換，就必須定義所有「必要」屬性。 範例資訊清單檔可在範例繪圖套件內找到。 本指南未涵蓋資訊清單支援的屬性。 如需資訊清單屬性的詳細資訊，請參閱資訊清單檔需求。

建築物圖層

建築物圖層會指定哪個圖層要使用哪個 DWG 檔。 圖層必須具有圖層名稱和序數，以描述每個圖層的垂直順序。 每個設施都須有序數 0，這是設施的第一層。 即使繪圖涵蓋設施的多個樓層，也必須提供序數 0。 例如，樓層 15-17 可以分別定義為序數 0-2。

下列範例程式碼取自範例繪圖套件。 設施有三層：地下層、地面層和第 2 層。 檔案名稱包含完整檔案名稱及 .zip 繪圖套件內資訊清單檔的相對檔案路徑。

    "buildingLevels": { 
      "levels": [ 
       { 
           "levelName": "Basement", 
           "ordinal": -1, 
           "filename": "./Basement.dwg" 
            }, { 

            "levelName": "Ground", 
            "ordinal": 0, 
            "filename": "./Ground.dwg" 
            }, { 

            "levelName": "Level 2", 
            "ordinal": 1, 
             "filename": "./Level_2.dwg" 
            } 
        ] 
    }, 

georeference

georeference 物件用來指定設施的地理位置，以及要旋轉設施的角度。 繪圖的原點應該與 georeference 物件提供的緯度和經度相符。 正北和繪圖垂直軸 (Y) 之間的順時針角度 (以度為單位)。

dwgLayers

dwgLayers 物件用來指定包含特徵類別的 DWG 圖層名稱。 若要接收已轉換屬性的設施，請務必提供正確的圖層名稱。 例如，DWG 牆圖層必須以牆圖層的形式提供，而不是單位圖層。 繪圖可以有其他圖層，例如家具或管線；但是如果沒有在資訊清單中指定，Azure 地圖服務轉換服務就會予以忽略。

下列資訊清單中 dwgLayers 物件的範例。

"dwgLayers": { 
        "exterior": [ 
            "OUTLINE" 
        ], 
        "unit": [ 
            "UNITS" 
        ], 
        "wall": [ 
            "WALLS" 
        ], 
        "door": [ 
            "DOORS" 
        ], 
        "unitLabel": [ 
            "UNITLABELS" 
        ], 
        "zone": [ 
            "ZONES" 
        ], 
        "zoneLabel": [ 
            "ZONELABELS" 
        ] 
    } 

下圖顯示在 Autodesk AutoCAD®軟體中檢視對應 DWG 繪圖的圖層。

unitProperties

unitProperties 物件可用來為單位定義無法在 DWG 檔中定義的其他屬性。 例如單位的目錄資訊或單位的類別類型。 只要 unitName 物件與 unitLabel 圖層中的標籤相符，單位屬性就會與單位建立關聯。

下圖取自範例繪圖套件。 顯示與資訊清單中單位屬性相關聯的單位標籤。

下列程式碼片段顯示與單位相關聯的單位屬性物件。

 "unitProperties": [ 
        { 
            "unitName": "B01", 
            "categoryName": "room.office", 
            "navigableBy": ["pedestrian", "wheelchair", "machine"], 
            "routeThroughBehavior": "disallowed", 
            "occupants": [ 
                { 
                    "name": "Joe's Office", 
                    "phone": "1 (425) 555-1234" 
                } 
            ], 
            "nameAlt": "Basement01", 
            "nameSubtitle": "01", 
            "addressRoomNumber": "B01", 
            "nonPublic": true, 
            "isRoutable": true, 
            "isOpenArea": true 
        }, 

步驟 4：準備繪圖套件

您現在應該已備妥符合 Azure 地圖轉換服務需求的所有 DWG 繪圖。 此外也已建立資訊清單檔以協助描述設施。 所有檔案都必須壓縮成副檔名為 .zip 的單一封存檔。 請務必將資訊清單檔命名為 manifest.json，並放在壓縮套件的根目錄中。 如果檔案名稱包含資訊清單的相對路徑，那麼所有其他檔案都可以位於壓縮套件的任何目錄中。 如需繪圖套件的範例，請參閱範例繪圖套件。

下一步

本指南示範如何準備 Azure 地圖服務轉換服務的繪圖套件。 繪圖套件包含單一設施的一或多個 DWG 繪圖檔案和說明 DWG 檔案的資訊清單檔。

如果您沒有自己的套件能與本指南一起參考，可以下載範例繪圖套件 v2。

您可以選擇任何 CAD 軟體來開啟並準備設施繪圖檔。 不過本指南是使用 Autodesk 的AutoCAD ®軟體所建立。 本指南中參考的所有命令都是使用 Autodesk 的 AutoCAD® 軟體執行的。

詞彙

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

步驟 1：DWG 檔案需求

準備設施繪圖檔以使用轉換服務時，請務必遵循下列初步需求和建議：

• 設施繪圖檔必須以 DWG 格式儲存，這是 Autodesk AutoCAD® 軟體的原生檔案格式。
• 轉換服務適用於 AUTOCAD DWG 檔案格式。 AC1032 是 DWG 檔的內部格式版本，最好選取 AC1032 作為內部 DWG 檔案格式版本。
• DWG 檔只能包含單一樓層。 設施的每個樓層都必須以各自的 DWG 檔提供。 因此，如果您的設施中有五個樓層，就必須建立五個不同的 DWG 檔。

步驟 2：準備 DWG 檔

本指南的這個部分示範如何使用 CAD 命令，確保 DWG 檔案符合轉換服務的需求。

您可以選擇任何 CAD 軟體來開啟並準備設施繪圖檔。 不過本指南是使用 Autodesk 的AutoCAD ®軟體所建立。 本指南中參考的所有命令都是使用 Autodesk 的 AutoCAD® 軟體執行的。

繫結外部參考

設施的每個樓層都必須以一個 DWG 檔提供。 如果沒有外部參考，就不需要再執行任何動作。 不過如果有任何外部參考，則必須繫結至單一繪圖。 若要繫結外部參考，可以使用 XREF 命令。 繫結之後，每個外部參考繪圖都會新增為區塊參考。 如需變更這些圖層中的任何一個，請記得使用 XPLODE 命令分解區塊參考。

測量單位

繪圖可以使用任何測量單位來建立。 不過所有繪圖都須使用相同的測量單位。 因此，如果設施的一個樓層使用公釐，則所有其他樓層 (繪圖) 也須以公釐為單位。 您可使用 UNITS 命令並設定「插入比例尺」值以確認或修改測量單位。

下圖顯示 Autodesk AutoCAD® 軟體內的 [繪圖單位] 視窗，可用來確認測量單位。

對齊方式

設施的每個樓層都需以個自的 DWG 檔提供。 因此，樓層可能無法按 Azure 地圖服務轉換服務需求完全對齊。 若要確認對齊，請使用參考點，例如跨多個樓層的電梯或柱子。 使用 XATTACH 命令以載入所有樓層繪圖，接著使用 MOVE 命令和參考點以重新對齊所需的樓層。

圖層

確定繪圖的每一個圖層都包含一個特徵類別的實體。 如果圖層包含牆的實體，則應不能含有單位或門的實體。 不過，特徵類別可以由多個圖層組成。 例如，繪圖中可以有三個圖層包含牆實體。

如需深入了解圖層和特徵類別，請參閱繪圖套件需求。

步驟 3：準備資訊清單

繪圖套件資訊清單是 JSON 檔。 資訊清單會告訴 Azure 地圖轉換服務如何解讀設施 DWG 檔和中繼資料。 這些資訊的範例可能是每個 DWG 圖層包含的特定資訊，或是設施的地理位置。

若要成功進行轉換，就必須定義所有「必要」屬性。 範例資訊清單檔可在範例繪圖套件 v2 內找到。 本指南未涵蓋資訊清單支援的屬性。 如需資訊清單屬性的詳細資訊，請參閱資訊清單檔需求。

資訊清單可在文字編輯器中手動建立，也可使用 Azure 地圖服務 Creator 上線工具進行建立。 本指南提供各方法的範例。

Azure 地圖服務 Creator 上線工具

您可以使用 Azure 地圖服務 Creator 上線工具，建立新的和編輯現有的資訊清單檔。

若要處理 DWG 檔案，請輸入 Azure 地圖服務 Creator 資源的地理位置、Azure 地圖服務帳戶的訂用帳戶金鑰及 DWG ZIP 套件的路徑和檔案名稱，然後選取 [處理]。 此程序可能需要數分鐘的時間才能完成。

設施樓層

設施樓層指定哪個樓層要使用哪個 DWG 檔。 樓層必須有樓層名稱和序數以說明設施中每個樓層的垂直順序，以及垂直範圍以說明計量中每個樓層的高度。

下列範例程式碼取自範例繪圖套件 v2。 設施有兩個樓層：地面和第 2 樓層。 檔案名稱包含完整檔案名稱，以及繪圖套件內資訊清單檔的相對檔案路徑。

地理坐標參考

地理坐標參考可用於指定設施的外觀、位置和轉向。

設施樓層定義顯示在地圖上的外觀，並自 [外部] 下拉式清單的 DWG 圖層清單中選取。

錨點經度和錨點緯度指定設施的位置，預設值為零 (0)。

錨點角度是以真北和繪圖垂直 (Y) 軸之間的度數指定，預設值為零 (0)。

DWG 圖層

dwgLayers 物件用來指定包含特徵類別的 DWG 圖層名稱。 若要接收已轉換屬性的設施，請務必提供正確的圖層名稱。 例如，DWG 牆圖層必須以牆圖層的形式提供，而不是單位圖層。 繪圖可以有其他圖層，例如家具或管線；但是 Azure 地圖服務轉換服務將忽略資訊清單中未指定的任何圖層。 定義文字屬性可讓您關聯屬於特徵界限內的文字實體。 定義後，這些文字屬性可用於設定元素的樣式並在室內地圖上顯示

檢閱 + 建立

完成時，選取 [建立 + 下載] 按鈕以下載繪圖套件的複本，並開始地圖建立程序。 如需地圖建立程序的詳細資訊，請參閱 [使用上線工具建立室內地圖]。

下一步