绘图包要求

使用 Azure Maps 转换服务，可以将上传的绘图包转换为地图数据。 本文介绍了适用于转换 API 的绘图包要求。 若要查看示例包，可以下载示例绘图包。

先决条件

绘图包中包括以 DWG 格式保存的绘图，这是 Autodesk AutoCAD® 软件的本机文件格式。

可以选择任何 CAD 软件来生成绘图包中的绘图。

转换服务可将绘图包转换为地图数据。 转换服务与 AutoCAD DWG 文件格式 AC1032 一起使用。

术语词汇表

为便于参考，以下是一些在您阅读本文时很重要的术语和定义。

绘图包结构

绘图包是包含以下文件的 .zip 存档：

• AutoCAD DWG 文件格式的 DWG 文件。
• 描述绘图包中 DWG 文件的 manifest.json 文件。

必须将绘图包压缩为扩展名为 .zip 的单个存档文件中。 DWG 文件可以在压缩包中以任何方式组织，而清单文件则必须位于压缩包的根目录。 下面各部分详细介绍了 DWG 文件和清单文件的要求，以及这两种文件的内容。 要查看示例包，可以下载示例绘图包。

DWG 文件转换过程

转换服务对每个 DWG 文件执行以下操作：

• 提取特征类：
  • Levels
  • 单位
  • 区域
  • Openings
  • Walls
  • 垂直滚动
• 生成“设施”功能。
• 生成由其他特征引用的最小默认类别特征集：
  • 客房
  • structure
  • wall
  • opening.door
  • 区域
  • 设备

DWG 文件要求

设施的每个楼层都需要一个 DWG 文件。 单个楼层的所有数据都必须包含在一个 DWG 文件中。 所有外部引用 (Xref) 都必须绑定到父绘图。 例如，具有三个楼层的设施在绘图包中包含三个 DWG 文件。

每个 DWG 文件都必须遵守以下要求：

• DWG 文件必须定义 Exterior 和 Unit 图层。 它可以视需要选择定义下列图层：Wall、Door、UnitLabel、Zone和 ZoneLabel。
• DWG 文件不能包含来自多个楼层的特征。
• DWG 文件不能包含来自多个设施的特征。
• DWG 必须与绘图包中的其他 DWG 文件引用相同的度量系统和度量单位。

DWG 图层要求

每个 DWG 图层都必须遵循以下规则：

• 图层必须仅包含单个类的特征。 例如，units 和 walls 不能位于同一图层中。
• 单类特征可以由多个图层来表示。
• 允许自相交的多边形，但会自动修复。 修复后，转换服务将会发出警告。 建议手动检查修复后的结果，因为它们可能与预期的结果不符。
• 每个图层都有一个支持的实体类型列表。 图层中的任何其他实体类型都会被忽略。 例如，wall 图层不支持文本实体。

下表概述了支持的实体类型和每个图层转换后的映射特征。 如果图层包含不受支持的实体类型，则转换服务会忽略这些实体。

下面各部分介绍了每个图层的要求。

Exterior 图层

每个楼层的 DWG 文件都必须包含用于定义相应楼层的外围的图层。 此图层称为外图层。 例如，如果某个设施包含两个楼层，那么它需要有两个 DWG 文件，每个文件都有一个 Exterior 图层。

不论外图层中有多少实体绘图，生成的设施数据集对每个 DWG 文件都只包含一个楼层特征。 此外：

• 外图层必须绘制为多边形、折线（闭合）、圆形或椭圆形（闭合）。
• 外图层可能会重叠，但会消隐为一个几何图形。
• 生成的楼层特征必须至少为4平方米。
• 生成的楼层特征不得大于 400,000 平方米。

如果此图层包含多个重叠的折线，这些折线会消隐为一个楼层特征。 相反，如果此图层包含多个非重叠的折线，则生成的楼层特征就会有多多边形表示。

可以在示例绘图包中查看作为轮廓层的外部层示例。

Unit 图层

每个楼层的 DWG 文件都应定义包含单元的图层。 单元是建筑物中可导航的空间，如办公室、走廊、楼梯和电梯。 如果 VerticalPenetrationCategory 定义了属性，则跨越多个楼层的导向性单元（如电梯和楼梯）将转换为垂直滚动特征。 相互重叠的垂直滚动特征被指定为一 setid。

Unit 图层应遵循以下要求：

• 单元图层必须绘制为多边形、折线（闭合）、圆形或椭圆形（闭合）。
• Unit 必须位于设施外围的边界内。
• Unit 不得部分重叠。
• Unit 不得包含任何自相交几何图形。

单元的命名方法为，在单元标记图层中创建一个文本对象，然后将此对象置于单元边界内。 有关详细信息，请参阅 UnitLabel 图层。

可以在示例绘图包中查看单元图层的示例。

Wall 图层

每个楼层的 DWG 文件都可能包含定义墙、柱和其他建筑结构的物理范围的图层。

• 墙图层必须绘制为多边形、折线（闭合）、圆形或椭圆形（闭合）。
• 一个或多个墙图层只能包含被解释为建筑结构的几何图形。

可以在示例绘图包中查看墙壁图层的示例。

Door 图层

可以包括包含门的 DWG 图层。 每个门都必须与单元图层中单元的边缘重叠。

Azure Maps 数据集中的门开口表示为，与多个单元边界重叠的单线段。 下图显示 Azure Maps 如何将门层几何图形转换为数据集中的开放特征。

Zone 图层

每个楼层的 DWG 文件都可能包含定义区域物理范围的区域图层。 区域是可以命名和呈现的不可导航空间。 区域可以跨多个级别，并使用 zoneSetId 属性组合在一起。

• 区域图层必须绘制为多边形、折线（闭合）或椭圆形（闭合）。
• 区域可以重叠。
• 区域可能会位于设施外围的边界内，也可能会位于边界外。

区域的命名方法为，在区域标签图层中创建一个文本对象，然后将此文本对象置于区域边界内。 有关详细信息，请参阅 ZoneLabel 图层。

可以在示例绘图包中查看区域图层的示例。

UnitLabel 图层

每个楼层的 DWG 文件都可能包含单元标签图层。 单元标签图层向从单元图层中提取的单元添加名字属性。 具有名字属性的单元可以在清单文件中指定其他详细信息。

• UnitLabel 必须是单行文本实体。
• UnitLabel 必须完全位于单元的边界内。
• 单元不得包含单元标签图层中的多个文本实体。

可以在示例绘图包中查看 UnitLabel 图层的示例。

ZoneLabel 图层

每个楼层的 DWG 文件都可能包含区域标签图层。 此图层向从 Zone 图层中提取的区域添加 name 属性。 具有 name 属性的区域可以在清单文件中指定其他详细信息。

• ZoneLabel 必须是单行文本实体。
• ZoneLabel 必须位于区域的边界内。
• 区域不得包含区域标签图层中的多个文本实体。

可以在示例绘图包中查看 ZoneLayer 图层的示例。

清单文件要求

zip 文件夹必须在目录的根级别包含命名为“manifest.json”的清单文件。 它描述了 DWG 文件，以便转换服务能够分析其内容。 只有由清单标识的文件才会被引入。 压缩文件夹中有、但在清单中没有正确列出的文件会被忽略。

尽管有使用清单对象的要求，但并非所有对象都是必需的。 下表列出了转换服务版本 1.1 的必需和可选对象。

下面各部分详细介绍了每个对象的要求。

directoryInfo

buildingLevels

buildingLevels 对象包含建筑物楼层的 JSON 数组。

georeference

dwgLayers

unitProperties

unitProperties 对象包含 unit 属性的 JSON 数组。

zoneProperties

zoneProperties 对象包含 zone 属性的 JSON 数组。

示例绘图包清单

下面是示例绘图包的清单文件。 转到 GitHub 上的 Azure Maps Creator 的示例绘图包以下载整个包。

清单文件

{
    "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 Maps 转换服务，可以将上传的绘图包转换为地图数据。 本文介绍了适用于转换 API 的绘图包要求。 要查看示例包，可以下载示例绘图包 v2。

有关如何准备绘图包的指南，请参阅绘图包指南。

更改和修订

• 添加了对用户定义的特征类的支持。
• 简化了 DWG 图层的要求。

先决条件

绘图包中包括以 DWG 格式保存的绘图，这是 Autodesk AutoCAD® 软件的本机文件格式。

可以选择任何 CAD 软件来生成绘图包中的绘图。

转换服务可将绘图包转换为地图数据。 转换服务使用 AutoCAD DWG 文件格式 AC1032。

术语词汇表

为便于参考，以下是一些在您阅读本文时很重要的术语和定义。

绘图包结构

绘图包是包含以下文件的 ZIP 存档：

• AutoCAD DWG 文件格式的 DWG 文件。
• 描述绘图包中 DWG 文件的 manifest.json 文件。

必须将绘图包压缩为扩展名为 .zip 的单个存档文件中。 DWG 文件可以在压缩包中随意组织，但清单文件则必须位于根目录。 后续部分介绍 DWG 和清单文件的转换过程和要求，以及这些文件的内容。 要查看示例包，可以下载示例绘图包 v2。

DWG 文件转换过程

Azure Maps 转换服务将设施的 DWG 文件转换为表示设施和设施特征的地图数据。

Azure Maps 转换服务创建：

• 设施特征：与设施的所有楼层关联的最高级设施特征。
• 楼层特征：为设施的每个楼层创建一个楼层特征。 一个楼层上的所有特征都与某个楼层关联。
• 用户定义的特征：DWG 图层映射到用户定义的特征类，并成为该特征类的实例。

DWG 文件要求

每个 DWG 文件都必须遵守以下要求：

• DWG 文件不能包含来自多个设施的特征。
• DWG 文件不能包含来自多个楼层的特征。 例如，具有三个楼层的设施在绘图包中包含三个 DWG 文件。
• 单个楼层的所有数据都必须包含在一个 DWG 文件中。 所有外部引用 (Xref) 都必须绑定到父绘图。
• 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 平方米。
• 生成的楼层特征不得大于 400,000 平方米。

如果此图层包含多个重叠的折线，这些折线会合并为一个楼层特征。 相反，如果此图层包含多个非重叠的折线，则生成的楼层特征就会有多多边形表示。

可以在示例绘图包 v2 中查看作为“GROS$”层的楼层外围图层示例。

清单文件要求

绘图包必须在根级别包含命名为“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 Maps Creator 的示例绘图包 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"
}