Guia de pacote de desenho de conversão

Observação

Desativação do Criador do Azure Mapas

O serviço de mapa interno do Criador do Azure Mapas foi preterido e será desativado em 30/09/25. Para obter mais informações, confira Comunicado de fim da vida útil do Criador do Azure Mapas.

Este guia mostra como preparar o Pacote de Desenho para o serviço de Conversão do Azure Mapas usando comandos de CAD específicos para preparar corretamente seus arquivos DWG e o arquivo de manifesto para o serviço de Conversão.

Para começar, confira se o pacote de desenho está no formato .zip e contém os seguintes arquivos:

• Um ou mais arquivos de desenho no formato DWG.
• Um arquivo de manifesto que descreve os arquivos DWG e os metadados de instalação.

Caso não tenha um pacote próprio para referência neste guia, baixe o exemplo de pacote de desenho.

Você pode escolher qualquer software CAD para abrir e preparar os arquivos de desenho do recurso. No entanto, este guia é criado para usar o software AutoCAD® da Autodesk. Todos os comandos citados neste guia devem ser executados com o software AutoCAD® da Autodesk.

Dica

Para obter mais informações sobre os requisitos de pacote de desenho não abordados neste guia, consulte Requisito de pacote de desenho.

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 guia.

Termo	Definição
Camada	Uma camada DWG do AutoCAD do arquivo de desenho.
Entidade	Uma entidade DWG do AutoCAD do arquivo de desenho.
Nível	Uma área de uma construção com uma elevação definida. Por exemplo, o andar de uma construção.
Recurso	Um objeto que combina uma geometria com informações sobre metadados adicionais.
Classes de recurso	Um blueprint comum dos recursos. Por exemplo, umaUnidade é uma classe de recurso e um escritório é um recurso.

Etapa 1: Requisitos do arquivo DWG

Ao preparar os arquivos de desenho da sua instalação para o serviço de conversão, siga estes requisitos preliminares e estas recomendações:

• Os arquivos de desenho da instalação salvos no formato DWG, um formato de arquivo nativo para o software AutoCAD® do Autodesk.

• O serviço de conversão funciona no formato de arquivo do AutoCAD DWG. AC1032 é a versão de formato interno dos arquivos DWG, e é uma boa ideia selecionar AC1032 para uma versão do formato de arquivo DWG interno.

• Um arquivo DWG só pode conter um único andar. O andar de uma instalação precisa ser fornecido no próprio arquivo DWG separado. Portanto, se você tiver cinco andares em uma instalação, precisará criar cinco arquivos DWG separados.

Etapa 2: Preparar os arquivos DWG

Esta parte do guia mostra como usar comandos CAD para garantir que seus arquivos DWG atendam aos requisitos do serviço de Conversão.

Você pode escolher qualquer software CAD para abrir e preparar os arquivos de desenho do recurso. No entanto, este guia é criado para usar o software AutoCAD® da Autodesk. Todos os comandos citados neste guia devem ser executados com o software AutoCAD® da Autodesk.

Associar referências externas

Cada andar de uma instalação precisa ser fornecido como um arquivo DWG. Se não houver referências externas, nada mais precisará ser feito. No entanto, se houver referências externas, elas precisarão ser vinculadas a um único desenho. Para vincular uma referência externa, você pode usar o comando XREF. Cada desenho de referência externo será adicionado como uma referência de bloco após a associação. Se você precisar fazer alterações em qualquer uma dessas camadas, lembre-se de explodir as referência de bloco usando o comando XPLODE.

Unidade de medida

Os desenhos podem ser criados usando qualquer unidade de medida. No entanto, todos os desenhos precisam usar a mesma unidade de medida. Por isso, se um andar da instalação estiver usando milímetros, todos os outros (desenhos) precisarão também usar milímetros. Você pode verificar ou mudar a unidade de medida usando o comando UNITS.

A imagem a seguir mostra a janela Unidades de desenho no software AutoCAD® da Autodesk que você pode usar para verificar a unidade de medida.

Alinhamento

Cada andar de uma instalação é fornecido como um arquivo DWG individual. Como resultado, é possível que os pisos não fiquem perfeitamente alinhados quando empilhados. O serviço de conversão do Azure Mapas requer que todos os desenhos sejam alinhados com o espaço físico. Para verificar o alinhamento, use um ponto de referência presente em vários pisos, como um elevador ou uma coluna. Para exibir os pisos, você pode abrir um novo desenho e usar o comando XATTACH para carregar todos os desenhos de piso. Se precisar corrigir problemas de alinhamento, use os pontos de referência e o comando MOVE para realinhar os pisos necessários.

Camadas

Confirme se cada camada do desenho contém entidades de uma classe de recursos. Se uma camada contiver entidades para paredes, ela não poderá ter outros recursos, como unidades ou portas. No entanto, uma classe de recurso pode ser dividida em várias camadas. Por exemplo, você pode ter três camadas no desenho que contêm entidades de parede.

Além disso, cada camada tem uma lista de tipos de entidade compatíveis e todos os outros são ignorados. Por exemplo, se a camada Rótulo de Unidade permitir apenas texto de linha única, um texto de várias linhas ou polilinha na mesma camada será ignorada.

Para entender melhor as camadas e as classes de recurso, confira Requisitos de pacote de desenho.

Camada Exterior

Um recurso de nível único é criado a partir de cada camada ou camadas exteriores. Esse recurso de nível define o perímetro do nível. É importante garantir que as entidades na camada exterior atendam aos requisitos da camada. Por exemplo, uma polilinha fechada é permitida, ao passo que uma aberta não é. Se a camada exterior for composta por vários segmentos de linha, elas precisam ser fornecidas como uma polilinha fechada. Para unir vários segmentos de linha, escolha todos eles e use o comando JOIN.

A imagem a seguir é retirada da amostra de pacote e mostra a camada exterior do recurso em vermelho. A camada de unidade está desligada para ajudar a visualização.

Camada Unidade

As unidades são espaços navegáveis da construção, como escritórios, corredores, escadas e elevadores. Um tipo de entidade fechado, como polígono, polilinha fechada, círculo ou elipse fechada, é necessário para representar cada unidade. Portanto, paredes e portas sozinhas não criam uma unidade porque não há uma entidade que represente a unidade.

A imagem a seguir foi extraída do exemplo de pacote de desenho e mostra a camada de rótulo da unidade e a camada de unidade em vermelho. Todas as outras camadas são desligadas para ajudar a visualização. Além disso, uma unidade é selecionada para ajudar a mostrar que cada unidade é uma polilinha fechada.

Camada de rótulo de unidade

Se você quiser adicionar uma propriedade de nome a uma unidade, adicione uma camada separada para os rótulos das unidades. Os rótulos precisam ser fornecidos como entidades de texto de linha única que se enquadram dentro dos limites de uma unidade. Uma propriedade de unidade correspondente precisa ser adicionada ao arquivo de manifesto em que unitName corresponde ao conteúdo do texto. Para saber mais sobre todas as propriedades de unidade com suporte, veja unitProperties.

Camada Porta

As portas são opcionais. No entanto, portas poderão ser usadas se você quiser especificar os pontos de entrada de uma unidade. As portas poderão ser desenhadas de qualquer forma se for um tipo de entidade permitida pela camada de porta. A porta precisa sobrepor o limite de uma unidade e a borda sobreposta da unidade é tratada como uma abertura para a unidade.

A imagem a seguir foi extraída de exemplo de pacote de desenho e mostra uma unidade com uma porta (em vermelho) desenhada no limite da unidade.

Camada Parede

A camada de parede é destinada a representar as extensões físicas de uma instalação, como paredes e colunas. O serviço de conversão do Azure Mapas percebe as paredes como estruturas físicas que obstruem o roteamento. Com isso em mente, uma parede deve ser considerada uma estrutura física que pode ser vista, mas não ultrapassada. Aquilo que não puder ser visto não será capturado nessa camada. Se uma parede tiver paredes internas ou colunas no interior, somente o exterior deverá ser capturado.

Etapa 3: Preparar o manifesto

O manifesto do pacote de desenho é um arquivo JSON. O manifesto informa ao serviço de conversão do Azure Mapas como ler os arquivos DWG e metadados da instalação. Por exemplo, informações específicas contidas em cada camada do DWG ou a localização geográfica da instalação.

Para ter sucesso na conversão, todas as propriedades "obrigatórias" precisam ser definidas. Um exemplo de arquivo de manifesto pode ser encontrado no exemplo do pacote de desenho. Este guia não aborda as propriedades permitidas pelo manifesto. Para obter mais informações sobre as propriedades do manifesto, confira Requisitos do arquivo de manifesto.

Níveis de compilação

O nível de compilação especifica qual arquivo DWG usar para cada nível. Um nível precisa ter um nome e um número ordinal que descreva a ordem vertical de cada nível. Cada instalação precisa ter um ordinal 0, que é o térreo de uma instalação. Um ordinal 0 preciso ser fornecido mesmo que os desenhos ocupem alguns andares de uma instalação. Por exemplo, os andares 15-17 podem ser definidos como ordinais 0-2, respectivamente.

O exemplo a seguir foi extraído do exemplo de pacote de desenho. O recurso tem três níveis: porão, térreo e nível 2. O nome do arquivo contém o nome completo e o caminho do arquivo relacionado ao arquivo de manifesto dentro do pacote de desenho .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

O objeto georeference é usado para especificar a localização geográfica da instalação e em quanto girar a instalação. O ponto de origem do desenho deve corresponder à latitude e à longitude fornecida com o objeto georeference. O ângulo no sentido horário, em graus, entre o norte verdadeiro e o eixo vertical (Y) do desenho.

dwgLayers

O objeto dwgLayers é usado para especificar que os nomes da camada do DWG em que as classes do recurso podem ser encontradas. Para receber uma instalação de propriedade convertida, é importante fornecer os nomes de camada corretos. Por exemplo, uma camada de parede DWG precisa ser fornecida como camada de parede e não como camada de unidade. O desenho pode ter outras camadas, como móveis ou encanamento; mas o serviço de Conversão de Mapas do Azure as ignora se elas não estiverem especificadas no manifesto.

O exemplo a seguir do objeto dwgLayers no manifesto.

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

A imagem a seguir mostra as camadas do desenho do DWG correspondente exibido no software AutoCAD® da Autodesk.

unitProperties

O objeto unitProperties permite definir outras propriedades para uma unidade que você não pode fazer no arquivo DWG. Os exemplos podem ser informações de diretório de uma unidade ou o tipo de categoria de uma unidade. Uma propriedade de unidade é associada a uma unidade fazendo com que o objeto unitName corresponda ao rótulo na camada unitLabel.

A imagem a seguir foi extraída do exemplo do pacote de desenho. Ela exibe o rótulo de unidade associado à propriedade de unidade no manifesto.

O snippet a seguir mostra o objeto de propriedade da unidade associado à unidade.

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

Etapa 4: Preparar o pacote de desenho

Agora, você precisa ter todos os desenhos DWG preparados para atender aos requisitos de serviço de conversão do Azure Mapas. Um arquivo de manifesto também foi criado para ajudar a descrever a instalação. Todos os arquivos precisam estar compactados em um único arquivo, com a extensão .zip. É importante que o arquivo de manifesto tenha o nome de manifest.json e seja colocado no diretório raiz do pacote compactado. Todos os outros arquivos podem estar em qualquer diretório do pacote compactado se o nome do arquivo incluir o caminho relativo para o manifesto. Para ver um exemplo do pacote de desenho, confira o exemplo de pacote de desenho.

Próximas etapas

Criador de mapas internos

Este guia mostra como preparar seu Pacote de Desenho para o serviço de Conversão do Azure Mapas. Um Pacote de Desenhos contém um ou mais arquivos de desenho DWG para uma única instalação e um arquivo de manifesto descrevendo os arquivos DWG.

Se você não tiver seu próprio pacote para referenciar junto com este guia, poderá baixar o pacote de desenhos de amostra v2.

Você pode escolher qualquer software CAD para abrir e preparar os arquivos de desenho do recurso. No entanto, este guia é criado para usar o software AutoCAD® da Autodesk. Todos os comandos citados neste guia devem ser executados com o software AutoCAD® da Autodesk.

Dica

Para obter mais informações sobre os requisitos de pacote de desenho não abordados neste guia, consulte Requisito de pacote de desenho.

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 guia.

Termo	Definição
Camada	Uma camada DWG do AutoCAD do arquivo de desenho.
Entidade	Uma entidade DWG do AutoCAD do arquivo de desenho.
Nível	Uma área de uma construção com uma elevação definida. Por exemplo, o andar de uma construção.
Recurso	Um objeto que combina uma geometria com informações sobre metadados adicionais.
Classes de recurso	Um blueprint comum dos recursos. Por exemplo, umaUnidade é uma classe de recurso e um escritório é um recurso.

Etapa 1: Requisitos do arquivo DWG

Ao preparar os arquivos de desenho da sua instalação para o serviço de conversão, siga estes requisitos preliminares e estas recomendações:

• Os arquivos de desenho da instalação salvos no formato DWG, um formato de arquivo nativo para o software AutoCAD® do Autodesk.
• O serviço de conversão funciona no formato de arquivo do AutoCAD DWG. AC1032 é a versão de formato interno dos arquivos DWG, e é uma boa ideia selecionar AC1032 para uma versão do formato de arquivo DWG interno.
• Um arquivo DWG só pode conter um único andar. O andar de uma instalação precisa ser fornecido no próprio arquivo DWG separado. Portanto, se você tiver cinco andares em uma instalação, precisará criar cinco arquivos DWG separados.

Etapa 2: Preparar os arquivos DWG

Esta parte do guia mostra como usar comandos CAD para garantir que seus arquivos DWG atendam aos requisitos do serviço de Conversão.

Você pode escolher qualquer software CAD para abrir e preparar os arquivos de desenho do recurso. No entanto, este guia é criado para usar o software AutoCAD® da Autodesk. Todos os comandos citados neste guia devem ser executados com o software AutoCAD® da Autodesk.

Associar referências externas

Cada andar de uma instalação precisa ser fornecido como um arquivo DWG. Se não houver referências externas, nada mais precisará ser feito. No entanto, se houver referências externas, elas precisarão ser vinculadas a um único desenho. Para vincular uma referência externa, você pode usar o comando XREF. Depois de associar, cada desenho de referência externo será adicionado como uma referência de bloco. Se você precisar fazer alterações em qualquer uma dessas camadas, lembre-se de explodir as referência de bloco usando o comando XPLODE.

Unidade de medida

Os desenhos podem ser criados usando qualquer unidade de medida. No entanto, todos os desenhos precisam usar a mesma unidade de medida. Por isso, se um andar da instalação estiver usando milímetros, todos os outros (desenhos) precisarão também usar milímetros. Você pode verificar ou modificar a unidade de medida usando o comando UNITS e definindo o valor da “Escala de inserção”.

A imagem a seguir mostra a janela Unidades de Desenho no software AutoCAD® da Autodesk que você pode usar para verificar a unidade de medida.

Alinhamento

Cada andar de uma instalação é fornecido como um arquivo DWG individual. Como resultado, é possível que os pisos não estejam perfeitamente alinhados, conforme exigido pelo serviço de Conversão do Azure Mapas. Para verificar o alinhamento, use um ponto de referência, como um elevador ou uma coluna que se estende por vários andares. Use o comando XATTACH para carregar todos os desenhos do piso e, em seguida, o comando MOVE com os pontos de referência para realinhar qualquer piso que exija isso.

Camadas

Confirme se cada camada do desenho contém entidades de uma classe de recursos. Se uma camada contém entidades para paredes, ela não deve ter outras entidades, como unidades ou portas. No entanto, uma classe de recursos pode ser composta por várias camadas. Por exemplo, você pode ter três camadas no desenho que contêm entidades de parede.

Para entender melhor as camadas e as classes de recurso, confira Requisitos de pacote de desenho.

Etapa 3: Preparar o manifesto

O manifesto do pacote de desenho é um arquivo JSON. O manifesto informa ao serviço de conversão do Azure Mapas como ler os arquivos DWG e metadados da instalação. Por exemplo, informações específicas contidas em cada camada do DWG ou a localização geográfica da instalação.

Para ter sucesso na conversão, todas as propriedades "obrigatórias" precisam ser definidas. Um exemplo de arquivo de manifesto pode ser encontrado dentro do pacote de desenho de amostra v2. Este guia não aborda as propriedades permitidas pelo manifesto. Para obter mais informações sobre as propriedades do manifesto, confira Requisitos do arquivo de manifesto.

O manifesto pode ser criado manualmente em qualquer editor de texto ou pode ser criado usando a ferramenta de integração do Criador do Azure Mapas. Este guia fornece exemplos para cada um.

A ferramenta de integração do Criador do Azure Mapas

Você pode usar a ferramenta de integração do Criador do Azure Mapas para criar novos e editar os arquivos de manifesto existentes.

Para processar os arquivos DWG, insira a geografia do seu recurso Criador do Azure Mapas, a chave da assinatura da sua conta do Azure Mapas e o caminho e o nome do arquivo do pacote DWG ZIP e selecione Processo. Esse processo poderá levar vários minutos para ser concluído.

Níveis da instalação

O nível do recurso especifica qual arquivo DWG usar para qual nível. Um nível deve ter um nome de nível e um ordinal que descreva a ordem vertical de cada nível na instalação, juntamente com uma Extensão Vertical descrevendo a altura de cada nível em metros.

O exemplo a seguir foi retirado do pacote de desenhos de amostra v2. A instalação tem dois níveis: térreo e nível 2. O nome do arquivo contém o nome e o caminho completos do arquivo em relação ao arquivo de manifesto dentro do pacote de desenhos.

Referência geográfica

O georreferenciamento é usado para especificar o perfil externo, a localização e a rotação da instalação.

O nível de instalação define o perfil externo conforme ele aparece no mapa e é selecionado na lista de camadas DWG na lista suspensa Exterior.

A Longitude do Ponto de Ancoragem e a Latitude o Ponto de Ancoragem especificam o local da instalação, o valor padrão é zero (0).

O Ângulo do Ponto de Ancoragem é especificado em graus entre o norte verdadeiro e o eixo vertical (Y) do desenho. O valor padrão é zero (0).

Camadas DWG

O objeto dwgLayers é usado para especificar os nomes das camadas DWG em que as classes de recursos podem ser encontradas. Para receber uma instalação devidamente convertida, é importante fornecer os nomes corretos das camadas. Por exemplo, uma camada de parede DWG precisa ser fornecida como camada de parede e não como camada de unidade. O desenho pode ter outras camadas, como móveis ou encanamentos, mas o serviço de Conversão do Azure Mapas ignora qualquer coisa não especificada no manifesto. Definir as propriedades de texto permite associar as entidades de texto que estão dentro dos limites de um recurso. Uma vez definidos, eles podem ser usados para estilizar e exibir elementos no seu mapa interno

Importante

As seguintes classes de recursos devem ser definidas (sem distinção entre maiúsculas e minúsculas) para usar o wayfinding. Wall será tratado como uma obstrução para uma determinada solicitação de caminho. Stair e Elevator serão tratados como conectores de nível para navegar pelos andares:

• Parede
• Escada
• Elevador

Examinar + criar

Quando terminar, selecione o botão Criar + Baixar para baixar uma cópia do pacote de desenho e iniciar o processo de criação do mapa. Para obter mais informações sobre o processo de criação do mapa, consulte [Criar mapa interno com a ferramenta de integração].

Próximas etapas

Criador de mapas internos

[Criar mapa do interior com a ferramenta de integração]