Requisitos do pacote de desenho

O serviço Conversão do Azure Mapas permite converter pacotes de desenho carregados em dados de mapa. Este artigo descreve os requisitos de pacote de desenho para a API de Conversão. Para exibir um pacote de exemplo, você pode baixar o Pacote de desenho de amostra.

Pré-requisitos

O pacote de desenho inclui desenhos salvos no formato DWG, um formato de arquivo nativo para o software AutoCAD® da Autodesk.

Você pode usar qualquer software CAD para produzir desenhos no pacote de desenho.

O serviço Conversão converte o pacote de desenho em dados de mapa. O serviço de conversão funciona no formato de arquivo do AutoCAD DWG AC1032.

Glossário de termos

Para facilitar a referência, aqui estão alguns termos e definições que são importantes à medida que você lê este artigo.

Estrutura do pacote do desenho

Um pacote de desenho é um arquivo .zip que contém os seguintes arquivos:

• Arquivos DWG com formato de arquivo DWG do AutoCAD.
• Um arquivomanifest.json que descreve os arquivos DWG no pacote de desenho.

O pacote de desenho deve ser compactado em um único arquivo, com a extensão .zip. Os arquivos DWG podem ser organizados de qualquer forma dentro da pasta, mas o arquivo de manifesto deve ficar no diretório raiz da pasta zipada. As seções a seguir detalham os requisitos para arquivos DWG, o arquivo de manifesto e o conteúdo desses arquivos. Para exibir um pacote de amostra, você pode baixar o pacote de desenho de amostra.

Processo de conversão do arquivo DWG

O serviço Conversão faz o seguinte em cada arquivo DWG:

• Extrai classes de recurso:
  • Levels
  • Unidades
  • Zonas
  • Aberturas
  • Paredes
  • Penetrações verticais
• Produz um recurso de Instalações.
• Produz um conjunto mínimo de recursos padrão de Categoria referenciados por outros recursos:
  • quarto
  • estrutura
  • parede
  • opening.door
  • zona
  • facilidade

Requisitos do arquivo DWG

Apenas um arquivo DWG é necessário para cada nível da instalação. Todos os dados de um único nível devem estar contidos em um único arquivo DWG. Todas as referências externas (xrefs) devem estar ligadas ao desenho pai. Por exemplo, uma instalação com três níveis tem três arquivos DWG no pacote de desenhos.

Cada arquivo DWG deve atender aos requisitos a seguir:

• O arquivo DWG deve definir as camadas Exterior e Unidade. Alternativamente, é possível definir as seguintes camadas: Parede, Porta, UnitLabel, Zona e ZoneLabel.
• O arquivo DWG não pode conter recursos de vários níveis.
• O arquivo DWG não pode conter recursos de várias instalações.
• O DWG deve fazer referência ao mesmo sistema de medidas e unidade de medida que outros arquivos DWG do pacote de desenho.

Requisitos de camada do DWG

Cada camada do DWG deve aderir às seguintes regras:

• Uma camada deve conter exclusivamente recursos de uma única classe. Por exemplo, unidades e paredes não podem estar na mesma camada.
• Uma única classe de recursos pode ser representada por várias camadas.
• Polígonos com interseção automática são permitidos, mas são reparados automaticamente. Após o reparo, o serviço Conversão gera um aviso. É recomendável inspecionar resultados reparados manualmente, pois eles podem não corresponder aos resultados esperados.
• Cada camada tem uma lista de tipos de entidade com suporte. Todos os outros tipos de entidade em uma camada serão ignorados. Por exemplo, as entidades de texto não têm suporte na camada de parede.

A seguinte tabela descreve os tipos de entidades com suporte e os recursos do mapa convertido para cada camada. Se uma camada contiver tipos de entidade sem suporte, o serviço Conversão vai ignorá-las.

As seguintes seções descrevem os requisitos para cada camada.

Camada Exterior

O arquivo DWG de cada nível deve conter uma camada para definir o perímetro desse nível. Essa camada é conhecida como a camada Exterior. Por exemplo, se uma instalação contiver dois níveis, ela precisará ter dois arquivos DWG, com uma camada Exterior para cada arquivo.

Não importa quantos desenhos da entidade estejam na camada externa, o conjunto de dados resultante da instalação contém apenas um recurso de nível para cada arquivo DWG. Além disso:

• Os exteriores devem ser desenhados como POLYGON, POLYLINE (fechada), CIRCLE ou ELLIPSE (fechada).
• Os exteriores podem se sobrepor, mas são dissolvidos em uma geometria.
• O recurso de nível resultante deve ter pelo menos 4 metros quadrados.
• O recurso de nível resultante não deve ser maior que 400.000 metros quadrados.

Se a camada contiver várias POLYLINES sobrepostas, elas serão dissolvidas em um único recurso de Nível. Em vez disso, se a camada contiver várias polilinhas não sobrepostas, o recurso de nível resultante terá uma representação multipoligonal.

Um exemplo de Camada exterior pode ser visto como a camada de estrutura de tópicos nopacote de desenho de amostra.

Camada Unidade

O arquivo DWG de cada nível deve definir uma camada que contenha unidades. As unidades são espaços navegáveis da construção, como escritórios, corredores, escadas e elevadores. Se a VerticalPenetrationCategory propriedade for definida, as unidades navegáveis que abrangem vários níveis, como elevadores e escadas, são convertidas em recursos de penetração vertical. Os recursos de penetração vertical que se sobrepõem um ao outro são atribuídos setid.

A camada Unidades deve atender aos seguintes requisitos:

• As unidades devem ser desenhadas como POLÍGONO, POLILINHA (fechada), CÍRCULO ou ELIPSE (fechada).
• As unidades devem estar dentro dos limites do perímetro externo da instalação.
• As unidades não devem se sobrepor parcialmente.
• As unidades não devem conter nenhuma geometria com autointerseção.

Nomeie uma unidade criando um objeto de texto na camada UnitLabel, depois coloque o objeto dentro dos limites da unidade. Para obter mais informações, consulte Camada UnitLabel.

Você pode ver um exemplo da Camada de unidades no pacote de desenho de amostra.

Camada Parede

O arquivo DWG de cada nível pode conter uma camada que defina as extensões físicas de paredes, colunas e outras estruturas da construção.

• As paredes devem ser desenhadas como POLÍGONO, POLILINHA (fechada), CÍRCULO ou ELIPSE (fechada).
• As camadas de parede só devem conter uma geometria que seja interpretada como uma estrutura da construção.

Você pode ver um exemplo dessa Camada de paredes no pacote de desenho de amostra.

Camada Porta

Você pode incluir uma camada do DWG que contenha portas. Cada porta deve sobrepor a borda de uma unidade da camada Unidade.

As aberturas de portas em um conjunto de dados do Azure Mapas são representadas como um segmento de linha única que sobrepõe vários limites de unidade. As seguintes imagens mostram como o Azure Mapas converte a geometria da camada de porta em recursos de abertura em um conjunto de dados.

Camada Zona

O arquivo DWG de cada nível pode conter uma camada Zona que defina as extensões físicas das zonas. Uma zona é um espaço não navegável que pode ser nomeado e renderizado. As zonas podem incluir vários níveis e são agrupadas usando a propriedade zoneSetId.

• As zonas devem ser desenhadas como POLÍGONO, POLILINHA (fechada), CÍRCULO ou ELIPSE (fechada).
• As zonas podem se sobrepor.
• As zonas devem estar dentro ou fora do perímetro externo da instalação.

Para nomear uma zona, crie um objeto de texto na camada ZoneLabel e colocando o objeto de texto dentro dos limites da zona. Para obter mais informações, consulte Camada ZoneLabel.

Você pode ver um exemplo dessa Camada de zona no pacote de desenho de amostra.

Camada UnitLabel

O arquivo DWG de cada nível pode conter uma camada de rótulo de unidade. A camada de rótulo de unidade adiciona uma propriedade nome às unidades extraídas da camada Unidade. As unidades com uma propriedade nome podem ter detalhes adicionais especificados no arquivo de manifesto.

• Os rótulos de unidade devem ser entidades de texto de linha única.
• Os rótulos de unidade devem estar totalmente dentro dos limites de sua unidade.
• As unidades não devem conter várias entidades de texto na camada de rótulos de unidade.

Você pode ver um exemplo da Camada de UnitLabel no pacote de desenho de amostra.

Camada ZoneLabel

O arquivo DWG de cada nível pode conter uma camada ZoneLabel. Essa camada adiciona uma propriedade name às zonas extraídas da camada Zona. As zonas com uma propriedade nome podem ter detalhes adicionais especificados no arquivo de manifesto.

• Os rótulos de zonas devem ser entidades de texto de linha única.
• Os rótulos de zonas devem estar dentro dos limites de sua zona.
• As zonas não devem conter várias entidades de texto na camada de rótulos de zona.

Você pode ver um exemplo da camada de ZoneLabel no pacote de desenho de amostra.

Requisitos do arquivo de manifesto

A pasta zip deve conter um arquivo de manifesto no nível raiz do diretório, e o arquivo deve ser nomeado como manifest.json. Ele descreve os arquivos DWG para permitir que o serviço Conversão analise o conteúdo. Apenas os arquivos identificados por um manifesto serão ingeridos. Serão ignorados os arquivos que estiverem na pasta zip, mas não estiverem listados corretamente em um manifesto.

Embora haja requisitos para usar os objetos de manifesto, nem todos os objetos são necessários. A tabela a seguir mostra os objetos obrigatórios e opcionais da versão 1.1 do serviço Conversão.

As seções a seguir detalham os requisitos de cada objeto.

directoryInfo

buildingLevels

O objeto buildingLevels contém uma matriz JSON de níveis de construções.

georeference

dwgLayers

unitProperties

O objeto unitProperties contém uma matriz JSON das propriedades da unidade.

zoneProperties

O objeto zoneProperties contém uma matriz JSON das propriedades da zona.

Manifesto do pacote de desenho de amostra

A seguir está o arquivo de manifesto para o pacote de desenho da amostra. Acesse o Pacote de desenho de exemplo do Criador do Azure Mapas no GitHub para baixar o pacote inteiro.

Arquivo de manifesto

{
    "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"
        }
    ]
}

O serviço Conversão do Azure Mapas permite converter pacotes de desenho carregados em dados de mapa. Este artigo descreve os requisitos de pacote de desenho para a API de Conversão. Para ver um pacote de amostras, você pode baixar o pacote de desenhos de amostras v2.

Para ver um guia sobre como preparar seu pacote de desenho, consulte Guia do Pacote de Desenho.

Alterações e revisões

• Suporte adicionado para classes de recursos definidas pelo usuário.
• Requisitos simplificados das camadas do DWG.

Pré-requisitos

O pacote de desenho inclui desenhos salvos no formato DWG, um formato de arquivo nativo para o software AutoCAD® da Autodesk.

Você pode usar qualquer software CAD para produzir desenhos no pacote de desenho.

O serviço Conversão converte o pacote de desenho em dados de mapa. O serviço de conversão funciona com o formato de arquivo AutoCAD DWG AC1032.

Glossário de termos

Para facilitar a referência, aqui estão alguns termos e definições que são importantes à medida que você lê este artigo.

Estrutura do pacote do desenho

Um pacote de desenhos é um arquivo ZIP que contém os seguintes arquivos:

• Arquivos DWG com formato de arquivo DWG do AutoCAD.
• Um arquivomanifest.json que descreve os arquivos DWG no pacote de desenho.

O pacote de desenhos deve ser compactado em um único arquivo, com a extensão.zip. Os arquivos DWG podem ser organizados de qualquer forma dentro do pacote de desenhos, mas o arquivo de manifesto deve estar no diretório raiz. As próximas seções explicam o processo de conversão e os requisitos dos arquivos DWG e de manifesto, bem como o conteúdo desses arquivos. Para ver um pacote de amostras, você pode baixar o pacote de desenhos de amostras v2.

Processo de conversão do arquivo DWG

O serviço de Conversão do Azure Mapas converte o(s) arquivo(s) DWG de uma instalação para mapear os dados que representam uma instalação e os recursos de uma instalação.

O serviço de Conversão do Azure Mapas cria:

• Recurso de Instalação: o recurso de nível superior de uma instalação ao qual todos os níveis de uma instalação estão associados.
• Recursos de nível: um recurso de nível é criado para cada andar de uma instalação. Todos os recursos em um nível estão associados a um nível.
• Recursos definidos pelo usuário: as camadas DWG são mapeadas para uma classe de recursos definida pelo usuário e se tornam instâncias da classe de recursos.

Requisitos do arquivo DWG

Cada arquivo DWG deve atender aos seguintes requisitos:

• O arquivo DWG não pode conter recursos de várias instalações.
• O arquivo DWG não pode conter recursos de vários níveis. Por exemplo, uma instalação com três níveis tem três arquivos DWG no pacote de desenhos.
• Todos os dados de um único nível devem estar contidos em um único arquivo DWG. Todas as referências externas (xrefs) devem estar ligadas ao desenho pai.
• O arquivo DWG deve definir a(s) camada(s) que representa(m) o limite desse nível.
• O DWG deve fazer referência ao mesmo sistema de medidas e unidade de medida que outros arquivos DWG do pacote de desenho.
• O arquivo DWG deve estar alinhado quando empilhado em cima de outro nível da mesma instalação.

Requisitos de camada do DWG

Classes de recurso

Uma ou mais camadas DWG podem ser mapeadas para uma classe de recursos definida pelo usuário. Uma instância do recurso é criada a partir de uma entidade na camada mapeada. Por exemplo, as camadas DWG de cadeira, mesa e sofá são mapeadas para uma classe de recursos chamada mobília. Um recurso de mobília é criado para cada entidade a partir das camadas definidas. Além disso:

• Todas as camadas devem ser separadas para representar os diferentes tipos de recursos da instalação.
• Todas as entidades devem cair dentro dos limites do perímetro de nível.
• Tipos de entidades do AutoCAD compatíveis: TEXT, MTEXT, POINT, ARC, CIRCLE, LINE, POLYLINE, ELLIPSE.

Propriedades da classe de recursos

Entidades de texto que estão dentro dos limites de uma forma fechada podem ser associadas a esse recurso como uma propriedade. Por exemplo, uma classe de recursos de sala pode ter um texto que descreva o nome da sala e outra o tipo de sala de pacote de desenhos de amostra v2. Além disso:

• Somente entidades TEXT e MTEXT estão associadas a este recurso como uma propriedade. Todos os outros tipos de entidade são ignorados.
• Os pontos de justificativa TEXT e MTEXT devem estar dentro dos limites da forma fechada.
• Se mais de uma propriedade TEXT estiver dentro dos limites da forma fechada e ambas forem mapeadas para uma propriedade, uma é selecionada aleatoriamente.

Nível da instalação

O arquivo DWG de cada nível deve conter uma camada para definir o perímetro desse nível. Por exemplo, se uma instalação contiver dois níveis, ela precisará ter dois arquivos DWG, cada um com uma camada que defina o perímetro desse nível.

Não importa quantos desenhos de entidades estejam na camada de perímetro de nível, o conjunto de dados da instalação resultante contém apenas um recurso de nível para cada arquivo DWG. Além disso:

• Os perímetros de Nível devem ser desenhados como POLÍGONO, POLILINHA (fechada), CÍRCULO ou ELIPSE (fechada).
• Os perímetros de nível podem se sobrepor, mas são dissolvidos em uma geometria.
• O recurso de nível resultante deve ter pelo menos 4 metros quadrados.
• O recurso de nível resultante não deve ser maior que 400.000 metros quadrados.

Se a camada contiver várias POLYLINES sobrepostas, elas serão combinadas em um único recurso de Nível. Em vez disso, se a camada contiver várias POLYLINES não sobrepostas, o recurso de Nível resultante terá uma representação de multipolígono.

Você pode ver um exemplo da camada de perímetro de Nível como a camada GROS$ no pacote de desenhos de amostra v2.

Requisitos do arquivo de manifesto

O pacote de desenhos deve conter um arquivo de manifesto no nível raiz e o arquivo deve ter o nome manifest.json. Ele descreve os arquivos DWG que permitem que o Serviço de conversão v2 analise seu conteúdo. Somente os arquivos identificados pelo manifesto são usados. Os arquivos que estão no pacote de desenhos, mas não estão listados corretamente no manifesto, são ignorados.

Os caminhos de arquivo no objeto buildingLevels do arquivo de manifesto devem ser relativos à raiz do pacote de desenhos. O nome do arquivo DWG deve corresponder exatamente ao nome do nível da instalação. Por exemplo, um arquivo DWG para o nível "Basement" é Basement.dwg. Um arquivo DWG para o nível 2 é nomeado como level_2.dwg. Os nomes dos arquivos não podem conter espaços, você pode usar um sublinhado para substituir qualquer espaço.

Embora haja requisitos para usar os objetos de manifesto, nem todos os objetos são necessários. A tabela a seguir mostra os objetos obrigatórios e opcionais para o Serviço de conversão v2 de 2023-03-01-preview.

Arquivo do Manifesto JSON

As seções a seguir detalham os requisitos de cada objeto.

buildingLevels

nível

featureClass

featureClassProperty

georeference

Manifesto do pacote de desenho de amostra

O JSON neste exemplo mostra o arquivo de manifesto do pacote de desenhos de amostra. Acesse o pacote de desenhos de amostra v2 do Criador do Azure Mapas no GitHub para baixar o pacote inteiro.

Arquivo de manifesto

{
  "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"
}