Conversion Drawing パッケージ ガイド

  • [アーティクル]

このガイドでは、特定の CAD コマンドを使用して Azure Maps Conversion サービス用の Drawing パッケージを準備し、Conversion サービス用に DWG ファイルとマニフェスト ファイルを正しく準備する方法について説明します。

最初に、Drawing パッケージが .zip 形式で、次のファイルが含まれていることを確認します。

  • DWG 形式の 1 つ以上の描画ファイル。
  • DWG ファイルと施設のメタデータを記述するマニフェスト ファイル。

このガイドと共に参照する独自のパッケージがない場合、サンプル描画パッケージをダウンロードできます。

CAD ソフトウェアを選択して、施設の描画ファイルを開いて準備できます。 ただし、このガイドは、Autodesk の AutoCAD® ソフトウェアを使用して作成されています。 このガイドで参照されているコマンドは、Autodesk の AutoCAD® ソフトウェアを使用して実行することを意図しています。

ヒント

このガイドで説明されていない描画パッケージの要件の詳細については、「Drawing パッケージの要件」を参照してください。

用語集

このガイドを読む際に簡単に参照できるように、重要な用語と定義を次に示します。

用語 定義
レイヤー 描画ファイルからの AutoCAD DWG レイヤー。
Entity 描画ファイルからの AutoCAD DWG レイヤー。
Level 設定した高度にある建物の領域。 たとえば、ビルのフロアなどです。 
特徴量 ジオメトリをより多くのメタデータ情報と組み合わせたオブジェクト。
地物クラス 地物の一般的なブループリント。 たとえば、ユニットは地物クラスであり、オフィスは地物です。

手順 1: DWG ファイルの要件

Conversion サービス用の施設の描画ファイルを準備する場合、次の暫定的な要件と推奨事項に従う必要があります。

  • 施設の描画ファイルは DWG 形式で保存する必要があります。これは、Autodesk の AutoCAD® ソフトウェアのネイティブ ファイル形式です。

  • Conversion サービスは、AutoCAD DWG ファイル形式で機能します。 AC1032 は、DWG ファイルの内部形式のバージョンです。内部 DWG ファイル形式のバージョンには AC1032 を選択することをお勧めします。

  • DWG ファイルには、1 つのフロアのみを含むことができます。 施設のフロアは、個別の DWG ファイルに含める必要があります。 そのため、施設に 5 つのフロアがある場合、5 つの個別の DWG ファイルを作成する必要があります。

手順 2: DWG ファイルを準備する

このガイドのこの部分では、CAD コマンドを使用して、DWG ファイルが Conversion サービスの要件を満たしていることを確認する方法について説明します。

CAD ソフトウェアを選択して、施設の描画ファイルを開いて準備できます。 ただし、このガイドは、Autodesk の AutoCAD® ソフトウェアを使用して作成されています。 このガイドで参照されているコマンドは、Autodesk の AutoCAD® ソフトウェアを使用して実行することを意図しています。

外部参照のバインド

施設の各フロアは、1 つの DWG ファイルとして提供する必要があります。 外部参照がない場合、それ以上何も行う必要はありません。 ただし、外部参照がある場合、1 つの描画にバインドする必要があります。 外部参照をバインドするには、XREF コマンドを使用できます。 バインド後、各外部参照描画がブロック参照として追加されます。 これらのレイヤーのいずれかを変更する必要がある場合、XPLODE コマンドを使用してブロック参照を分解してください。

測定の単位

描画は、任意の測定単位を使用して作成できます。 ただし、すべての描画で同じ測定単位を使用する必要があります。 そのため、施設の 1 つのフロアがミリを使用している場合、他のすべてのフロア (描画) もミリ単位にする必要があります。 UNITS コマンドを使用して、測定単位を確認または変更できます。

次の画像は、Autodesk の AutoCAD® ソフトウェア内の [描画単位] ウィンドウを示しています。このウィンドウを使用して測定単位を確認できます。

Screenshot of the drawing units window in Autodesk's AutoCAD® software.

Alignment

施設の各フロアは、個々の DWG ファイルとして提供されます。 その結果、互いに積み上げ時にフロアが完全に整列されない可能性があります。 Azure Maps Conversion サービスでは、すべての描画を物理空間に合わせて配置する必要があります。 配置を確認するには、複数のフロアにまたがるエレベーターや列などの参照ポイントを使用します。 すべてのフロアを表示するには、新しい描画を開き、XATTACH コマンドを使用してすべてのフロアの描画を読み込みます。 配置の問題を修正する必要がある場合、参照ポイントと MOVE コマンドを使用して、必要なフロアを再配置できます。

レイヤー

描画の各レイヤーに、1 つの特徴クラスのエンティティが含まれている必要があります。 レイヤーに壁のエンティティが含まれている場合、ユニットやドアなどの他の特徴を含めることはできません。 ただし、特徴クラスは複数のレイヤーに分割できます。 たとえば、壁エンティティを含む描画に 3 つのレイヤーを含めることができます。

さらに、各レイヤーにはサポートされているエンティティ型の一覧が含まれ、その他の型は無視されます。 たとえば、ユニット ラベル レイヤーが単一行テキストのみをサポートしている場合、同じレイヤー上の複数行テキストまたはポリラインは無視されます。

レイヤーと特徴クラスの理解を深めるには、「Drawing パッケージの要件」を参照してください。

Exterior レイヤー

1 つのレベルの特徴は、1 つまたは複数のレイヤーから作成されます。 このレベルの特徴は、レベルの境界を定義します。 外部レイヤーのエンティティがレイヤーの要件を満たしていることを確認することが重要です。 たとえば、閉じたポリラインはサポートされていますが、開いたポリラインはサポートされていません。 外部レイヤーが複数の線分で構成されている場合、1 つの閉じたポリラインとして提供する必要があります。 複数の線分を結合するには、すべての線分を選択し、JOIN コマンドを使用します。

次の画像はサンプル パッケージから抽出したもので、施設の外部レイヤーを赤で示しています。 見やすくするためにユニット レイヤーをオフにしています。

Screenshot showing the exterior layer of a facility.

Unit レイヤー

ユニットは、オフィス、廊下、階段、エレベーターなど、建物内の移動可能なスペースです。 各ユニットを表すためには、多角形、閉じたポリライン、円、閉じた楕円などの閉じたエンティティ型が必要です。 そのため、壁とドアだけでは、ユニットを表すエンティティが存在しないため、ユニットが作成されません。

次の画像はサンプル描画パッケージから抽出したもので、ユニット ラベル レイヤーおよびユニット レイヤーを赤で示しています。 見やすくするために他のすべてのレイヤーをオフにしています。 また、各ユニットが閉じたポリラインであることを示すために 1 つのユニットが選択されています。

Screenshot showing the unit layer of a facility.

ユニット ラベル レイヤー

ユニットに name プロパティを追加する場合は、ユニット ラベルのための個別のレイヤーを追加します。 ラベルは、ユニットの境界内にある単一行のテキスト エンティティとして指定する必要があります。 対応する unit プロパティをマニフェスト ファイルに追加する必要があります。ここで、unitName はテキストのコンテンツと一致します。 サポートされているすべての unit プロパティについては、「unitProperties」を参照してください。

Door レイヤー

ドアは省略可能です。 ただし、ユニットのエントリ ポイントを指定する場合はドアを使用できます。 ドア レイヤーでサポートされているエンティティ型の場合、ドアは任意の方法で描画できます。 ドアはユニットの境界と重なっている必要があります。その後、ユニットの重なり合うエッジは、ユニットの開口部として処理されます。

次の画像はサンプル描画パッケージから抽出したもので、ユニット境界に描画されたドア (赤で描画) を含むユニットを示しています。

Screenshot showing the door layer of a facility.

Wall レイヤー

壁レイヤーは、壁や列などの施設の物理的な範囲を表すことを意図しています。 Azure Maps Conversion サービスは、経路に障害がある物理構造としての壁を認識します。 この点を念頭に置くと、壁は、見ることはできるが通り抜けることはできない物理的な構造と考える必要があります。 見えないものは、このレイヤーではキャプチャされません。 壁に内壁または内部の列がある場合、外部をキャプチャするだけで済みます。

手順 3: マニフェストを準備する

Drawing パッケージのマニフェストは JSON ファイルです。 マニフェストは、施設の DWG ファイルとメタデータを読み取る方法を Azure Maps Conversion サービスに指示します。 この情報の例としては、各 DWG レイヤーに含まれる具体的な情報や施設の地理的な場所などがあります。

変換を正常に実行するには、すべての「required」プロパティを定義する必要があります。 サンプル マニフェスト ファイルはサンプル描画パッケージ内にあります。 このガイドでは、マニフェストでサポートされるプロパティについては説明しません。 マニフェストのプロパティの詳細については、「マニフェスト ファイルの要件」を参照してください。

ビルド レベル

ビルド レベルでは、どのレベルでどの DWG ファイルを使用するかを指定します。 レベルには、各レベルの垂直方向の順序を示すレベル名と序数が必要です。 すべての施設には、施設の地上階となる序数 0 が必要です。 図面が施設のいくつかのフロアを占有する場合でも、序数 0 を指定する必要があります。 たとえば、15 階から 17 階をそれぞれ序数 0 から 2 として定義できます。

次の例はサンプル描画パッケージから抽出したものです。 この施設には地下、地上階、レベル 2 の 3 つのレベルがあります。 ファイル名には、.zip Drawing パッケージ内のマニフェスト ファイルを基準としたファイルの完全なファイル名とパスが含まれています。

    "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 Maps Conversion サービスによって無視されます。

マニフェストの dwgLayers オブジェクトの次の例。

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

次の画像は、Autodesk の AutoCAD®ソフトウェアで表示される、対応する DWG 描画のレイヤーを示しています。

Screenshot showing the DwgLayers in Autodesk's AutoCAD® software.

unitProperties

unitProperties オブジェクトを使用すると、DWG ファイルでは実行できないユニットのその他のプロパティを定義できます。 例としては、ユニットのディレクトリ情報やユニットのカテゴリの種類などがあります。 unit プロパティは、unitLabel レイヤーのラベルと一致している unitName オブジェクトを持つことによってユニットに関連付けられています。

次の画像はサンプル描画パッケージから抽出したものです。 これには、マニフェストの unit プロパティに関連付けられているユニット ラベルが表示されます。

Screenshot showing the unit label that is associated to the unity property in the manifest.

次のスニペットは、ユニットに関連付けられている unit プロパティ オブジェクトを示しています。

 "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 Maps Conversion サービスの要件を満たすために、すべての DWG 図面が準備されました。 また、施設を説明するためにマニフェスト ファイルも作成されています。 すべてのファイルを .zip 拡張子で 1 つのアーカイブ ファイルに圧縮する必要があります。 マニフェスト ファイルの名前は manifest.json であり、zip 形式のパッケージのルート ディレクトリに配置されていることが重要です。 ファイル名にマニフェストへの相対パスが含まれている場合、zip 形式のパッケージの任意のディレクトリに他のすべてのファイルを含めることができます。 描画パッケージの例については、サンプル描画パッケージを参照してください。

次のステップ

Azure Maps Creator とは

屋内マップ用の Creator

チュートリアル:Creator 屋内マップを作成する

このガイドでは、Azure Maps Conversion サービス用の Drawing パッケージを準備する方法について説明します。 Drawing パッケージには、1 つの施設用の 1 つ以上の DWG 描画ファイルと、DWG ファイルを記述するマニフェスト ファイルが含まれています。

このガイドと共に参照する独自のパッケージがない場合、サンプル描画パッケージ v2 をダウンロードできます。

CAD ソフトウェアを選択して、施設の描画ファイルを開いて準備できます。 ただし、このガイドは、Autodesk の AutoCAD® ソフトウェアを使用して作成されています。 このガイドで参照されているコマンドは、Autodesk の AutoCAD® ソフトウェアを使用して実行することを意図しています。

ヒント

このガイドで説明されていない描画パッケージの要件の詳細については、「Drawing パッケージの要件」を参照してください。

用語集

このガイドを読む際に簡単に参照できるように、重要な用語と定義を次に示します。

用語 定義
レイヤー 描画ファイルからの AutoCAD DWG レイヤー。
Entity 描画ファイルからの AutoCAD DWG レイヤー。
Level 設定した高度にある建物の領域。 たとえば、ビルのフロアなどです。 
特徴量 ジオメトリをより多くのメタデータ情報と組み合わせたオブジェクト。
地物クラス 地物の一般的なブループリント。 たとえば、ユニットは地物クラスであり、オフィスは地物です。

手順 1: DWG ファイルの要件

Conversion サービス用の施設の描画ファイルを準備する場合、次の暫定的な要件と推奨事項に従う必要があります。

  • 施設の描画ファイルは DWG 形式で保存する必要があります。これは、Autodesk の AutoCAD® ソフトウェアのネイティブ ファイル形式です。
  • Conversion サービスは、AutoCAD DWG ファイル形式で機能します。 AC1032 は、DWG ファイルの内部形式のバージョンです。内部 DWG ファイル形式のバージョンには AC1032 を選択することをお勧めします。
  • DWG ファイルには、1 つのフロアのみを含むことができます。 施設のフロアは、個別の DWG ファイルに含める必要があります。 そのため、施設に 5 つのフロアがある場合、5 つの個別の DWG ファイルを作成する必要があります。

手順 2: DWG ファイルを準備する

このガイドのこの部分では、CAD コマンドを使用して、DWG ファイルが Conversion サービスの要件を満たしていることを確認する方法について説明します。

CAD ソフトウェアを選択して、施設の描画ファイルを開いて準備できます。 ただし、このガイドは、Autodesk の AutoCAD® ソフトウェアを使用して作成されています。 このガイドで参照されているコマンドは、Autodesk の AutoCAD® ソフトウェアを使用して実行することを意図しています。

外部参照のバインド

施設の各フロアは、1 つの DWG ファイルとして提供する必要があります。 外部参照がない場合、それ以上何も行う必要はありません。 ただし、外部参照がある場合、1 つの描画にバインドする必要があります。 外部参照をバインドするには、XREF コマンドを使用できます。 バインド後、各外部参照描画がブロック参照として追加されます。 これらのレイヤーのいずれかを変更する必要がある場合、XPLODE コマンドを使用してブロック参照を分解してください。

測定の単位

描画は、任意の測定単位を使用して作成できます。 ただし、すべての描画で同じ測定単位を使用する必要があります。 そのため、施設の 1 つのフロアがミリを使用している場合、他のすべてのフロア (描画) もミリ単位にする必要があります。 UNITS コマンドを使用し、"挿入スケール" 値を設定することで、測定単位を確認または変更できます。

次の画像は、Autodesk の AutoCAD® ソフトウェア内の [描画単位] ウィンドウを示しています。このウィンドウを使用して測定単位を確認できます。

Screenshot of the drawing units window in Autodesk's AutoCAD® software.

Alignment

施設の各フロアは、個々の DWG ファイルとして提供されます。 その結果、Azure Maps Conversion サービスで求めるようにはフロアが完全に揃わない可能性があります。 配置を確認するには、複数のフロアにまたがるエレベーターや列などの参照ポイントを使用します。 XATTACH コマンドを使用してすべてのフロア図面を読み込み、参照ポイントを指定した MOVE コマンドを使用して、それを必要とするすべてのフロアを再調整します。

レイヤー

描画の各レイヤーに、1 つの特徴クラスのエンティティが含まれている必要があります。 レイヤーに壁のエンティティが含まれている場合、ユニットやドアなどの他のエンティティを含めることはできません。 ただし、地物クラスは複数のレイヤーで構成することができます。 たとえば、壁エンティティを含む描画に 3 つのレイヤーを含めることができます。

レイヤーと特徴クラスの理解を深めるには、「Drawing パッケージの要件」を参照してください。

手順 3: マニフェストを準備する

Drawing パッケージのマニフェストは JSON ファイルです。 マニフェストは、施設の DWG ファイルとメタデータを読み取る方法を Azure Maps Conversion サービスに指示します。 この情報の例としては、各 DWG レイヤーに含まれる具体的な情報や施設の地理的な場所などがあります。

変換を正常に実行するには、すべての「required」プロパティを定義する必要があります。 サンプル マニフェスト ファイルはサンプル Drawing パッケージ v2 内にあります。 このガイドでは、マニフェストでサポートされるプロパティについては説明しません。 マニフェストのプロパティの詳細については、「マニフェスト ファイルの要件」を参照してください。

マニフェストは、任意のテキスト エディターで手動で作成することも、Azure Maps Creator オンボード ツールを使用して作成することもできます。 このガイドでは、それぞれの例を示します。

Azure Maps Creator オンボード ツール

Azure Maps Creator オンボード ツールを使用して、新規のマニフェスト ファイルを作成したり、既存のマニフェスト ファイルを編集したりできます。

DWG ファイルを処理するには、Azure Maps Creator リソースの地理的な場所、Azure Maps アカウントのサブスクリプション キー、DWG ZIP パッケージのパスとファイル名を入力し、[Process] (処理) を選択します。 このプロセスの完了には数分かかることがあります。

Screenshot showing the 'create a new manifest' screen of the Azure Maps Creator onboarding tool.

施設レベル

施設レベルでは、どのレベルでどの DWG ファイルを使用するかを指定します。 レベルには、施設内の各レベルの垂直方向の順序を表すレベル名と序数に加えて、各レベルの高さをメートル単位で表す垂直範囲が必要です。

次の例はサンプル描画パッケージ v2 から抽出したものです。 この施設には、地上とレベル 2 の 2 つのレベルがあります。 ファイル名には、描画パッケージ内のマニフェスト ファイルを基準としたファイルの完全なファイル名とパスが含まれています。

Screenshot showing the facility levels tab of the Azure Maps Creator onboarding tool.

Georeference

ジオリファレンスは、施設の外部プロファイル、場所、回転を指定するために使用されます。

施設レベルは、マップ上に表示される外部プロファイルを定義し、[Exterior] (外部) ドロップダウン リストの DWG レイヤのリストから選択されます。

アンカー ポイントの経度とアンカー ポイントの緯度は施設の場所を指定します。既定値は 0 です。

アンカー ポイントの角度は、真北と図面の垂直 (Y) 軸の間の角度で指定され、既定値は 0 です。

Screenshot showing the default settings in the georeference tab of the Azure Maps Creator onboarding tool. The default settings are zero for all anchor points including longitude, latitude and angle.

DWG レイヤー

dwgLayers オブジェクトを使用して、地物クラスを検索できる DWG レイヤー名を指定します。 正しく変換された施設を受け取るには、正しいレイヤー名を指定することが重要です。 たとえば、DWG 壁レイヤーは、ユニット レイヤーとしてではなく、壁レイヤーとして指定する必要があります。 図面には、家具や配管などの他のレイヤーを含めることができます。ただし、マニフェストに指定されていないすべてのものは、Azure Maps Conversion サービスによって無視されます。 テキスト プロパティを定義すると、地物の境界内にあるテキスト エンティティを関連付けることができます。 定義したら、フロア ガイド上の要素のスタイル設定と表示に使用できます

Screenshot showing the 'create a new manifest' screen of the onboarding tool.

重要

wayfinding を使用するには、次の地物クラスを定義する必要があります (大文字と小文字は区別されません)。 Wall は、特定のパス要求の障害として扱われます。 Stair と Elevator は、フロア間を移動するためのレベル コネクタとして扱われます。

  • Wall
  • 階段
  • エレベーター

確認と作成

完了したら、[作成とダウンロード] ボタンを選択してこの描画パッケージのコピーをダウンロードし、このマップの作成プロセスを開始します。 このマップ作成プロセスについて詳しくは、「オンボード ツールを使用したフロア ガイドの作成」をご参照ください。

Screenshot showing the manifest JSON.

次のステップ

Azure Maps Creator とは

屋内マップ用の Creator

オンボード ツールを使用したフロア ガイドの作成