Erros de conversão de desenho e avisos

Artigo
01/04/2024

O serviço de Conversão de Mapas do Azure permite converter pacotes de desenho carregados em dados de mapa. Os pacotes de desenho devem aderir aos requisitos do pacote de desenho. Se um ou mais requisitos não forem atendidos, o serviço de conversão retornará erros ou avisos. Este artigo lista os códigos de erro de conversão e aviso, com recomendações sobre como resolvê-los. Ele também fornece alguns exemplos de desenhos que podem fazer com que o serviço de conversão retorne esses códigos.

O serviço de conversão será bem-sucedido se houver avisos de conversão. No entanto, é recomendável que você revise e resolva todos os avisos. Um aviso significa que parte da conversão foi ignorada ou corrigida automaticamente. A não resolução dos avisos pode resultar em erros nos últimos processos.

Advertências gerais

geometriaAviso

Descrição para geometriaAviso

Um geometryWarning ocorre quando o desenho contém uma entidade inválida. Uma entidade inválida é uma entidade que não está em conformidade com restrições geométricas. Exemplos de uma entidade inválida são um polígono de auto-intersecção ou um PolyLine aberto em uma camada que suporta apenas geometria fechada.

O serviço de conversão não consegue criar um recurso de mapa a partir de uma entidade inválida e, em vez disso, ignora-o.

Exemplos de geometriaAviso

As duas imagens seguintes mostram exemplos de polígonos que se auto-cruzam.
A imagem a seguir mostra um PolyLine aberto. Suponha que a camada suporta apenas geometria fechada.

Como corrigir geometriaAviso

Inspecione a geometriaAviso para cada entidade para verificar se ela segue restrições geométricas.

inesperadoGeometryInLayer

Descrição para unexpectedGeometryInLayer

Um aviso unexpectedGeometryInLayer ocorre quando o desenho contém geometria incompatível com o tipo de geometria esperado para uma determinada camada. Quando o serviço de conversão retorna um aviso inesperadoGeometryInLayer , ele ignora essa geometria.

Exemplo de inesperadoGeometryInLayer

A imagem a seguir mostra um PolyLine aberto. Suponha que a camada suporta apenas geometria fechada.

Example of an open PolyLine

Como corrigir unexpectedGeometryInLayer

Inspecione cada aviso inesperadoGeometryInLayer e mova a geometria incompatível para uma camada compatível. Se não for compatível com qualquer uma das outras camadas, deve ser removido.

unsupportedFeatureRepresentation

Descrição para unsupportedFeatureRepresentation

O aviso unsupportedFeatureRepresentation ocorre quando o desenho contém um tipo de entidade sem suporte.

Exemplo de unsupportedFeatureRepresentation

A imagem a seguir mostra um tipo de entidade sem suporte como um objeto de texto de várias linhas em uma camada de rótulo.

Example of a multi-line text object on label layer

Como corrigir unsupportedFeatureRepresentation

Certifique-se de que os seus ficheiros DWG contêm apenas os tipos de entidades suportados. Os tipos suportados estão listados na seção Requisitos de arquivos de desenho no artigo Requisitos do pacote de desenho.

automaticRepairPerformed

Descrição para automaticRepairPerformed

O aviso automaticRepairPerformed ocorre quando o serviço de conversão repara automaticamente a geometria inválida.

Exemplos de automaticRepairPerformed

A imagem a seguir mostra como o serviço de conversão reparou um polígono de auto-interseção em geometria válida.
A imagem a seguir mostra o serviço de conversão encaixando o primeiro e o último vértice de uma PolyLine aberta para criar uma PolyLine fechada, onde o primeiro e o último vértice estavam a menos de 1 mm de distância.
A imagem a seguir mostra como, em uma camada que suporta apenas PolyLines fechadas, o serviço de conversão reparou várias PolyLines abertas. Para evitar descartar as PolyLines abertas, o serviço as combinou em uma única PolyLine fechada.

Como corrigir automaticRepairPerformed

Para corrigir um aviso automaticRepairPerformed , execute as seguintes ações:

Inspecione a geometria de cada aviso e o texto de aviso específico.
Determine se o reparo automatizado está correto.
Se o reparo estiver correto, continue. Caso contrário, vá para o arquivo de design e resolva o aviso manualmente.

Gorjeta

Para suprimir um aviso no futuro, faça alterações no desenho original para que o desenho original corresponda ao desenho reparado.

Advertências de manifesto

redundanteAtribuição

Descrição para redundantAttribution

O aviso redundantAttribution ocorre quando o manifesto contém propriedades de objeto redundantes ou conflitantes.

Exemplos de atribuição redundante

O exemplo JSON a seguir contém dois ou mais unitProperties objetos com o mesmo name.

"unitProperties": [
    {
        "unitName": "L1-100",
        "categoryName": "room.office"
    },
    {
        "unitName": "L1-101",
        "categoryName": "room.office"
    },
    {
        "unitName": "L1-101",
        "categoryName": "room.office"
    }
]

No trecho JSON a seguir, dois ou mais zoneProperties objetos têm o mesmo name.

 "zoneProperties": [
    {
        "zoneName": "Assembly Area 1",
        "categoryName": "zone.assembly"
    },
    {
        "zoneName": "Assembly Area 2",
        "categoryName": "zone.assembly"
    },
    {
        "zoneName": "Assembly Area 2",
        "categoryName": "zone.assembly"
    }

Como corrigir redundantAttribution

Para corrigir um aviso *redundantAttribution , remova as propriedades do objeto redundantes ou conflitantes.

manifestWarning

Descrição para manifestWarning

Um manifestWarning ocorre quando o manifesto contém objetos unitProperties ou zoneProperties que não são usados durante a conversão.

Exemplos de manifestWarning

O manifesto contém um objeto com um unitPropertiesunitName que não tem rótulo correspondente em uma unitLabel camada.
O manifesto contém um objeto com um zonePropertieszoneName que não tem rótulo correspondente em uma zoneLabel camada.

Como corrigir manifestWarning

Para corrigir um manifestWarning, remova o objeto ou zoneProperties não utilizado unitProperties do manifesto ou adicione um rótulo de unidade/zona ao desenho para que o objeto de propriedades seja usado durante a conversão.

Avisos de parede

wallOutsideLevel

Descrição para wallOutsideLevel

O aviso wallOutsideLevel ocorre quando o desenho contém uma geometria de parede fora dos limites de um contorno de nível.

Exemplo para wallOutsideLevel

A imagem seguinte mostra uma parede interior, em vermelho, fora do limite do nível amarelo.
A imagem seguinte mostra uma parede exterior, em vermelho, fora do limite do nível amarelo.

Como corrigir wallOutsideLevel

Para corrigir um aviso wallOutsideLevel , expanda a geometria do nível para incluir todas as paredes. Ou modifique os limites da parede para caber dentro do limite de nível.

Avisos da unidade

unitOutsideLevel

Descrição para unitOutsideLevel

Um aviso unitOutsideLevel ocorre quando o desenho contém geometria de unidade fora dos limites do contorno de nível.

Exemplo para unitOutsideLevel

Na imagem seguinte, a geometria da unidade, em vermelho, excede os limites do limite do nível amarelo.

Example of unit exceeding the level boundary

Como corrigir unitOutsideLevel

Para corrigir um aviso unitOutsideLevel , expanda o limite de nível para incluir todas as unidades. Ou modifique a geometria da unidade para caber dentro do limite de nível.

parcialmenteUnidade sobreposta

Descrição para partiallyOverlappingUnit

Um aviso parcialmenteOverlappingUnit ocorre quando o desenho contém uma geometria de unidade parcialmente sobreposta em outra geometria de unidade. O serviço de conversão descarta unidades sobrepostas.

Exemplos de cenários parcialmenteOverlappingUnit

Na imagem seguinte, a unidade sobreposta é realçada em vermelho. UNIT110 e HALLWAY são descartados.

Example of overlapping units

Como corrigir parcialmenteOverlappingUnit

Para corrigir um aviso parcialmenteOverlappingUnit , redesenhe cada unidade parcialmente sobreposta para que ela não se sobreponha a nenhuma outra unidade.

Avisos de porta

portaExteriorNível

Descrição para doorOutsideLevel

Um aviso doorOutsideLevel ocorre quando o desenho contém uma geometria da porta fora dos limites da geometria do nível.

Exemplo para doorOutsideLevel

Na imagem seguinte, a geometria da porta, destacada a vermelho, sobrepõe-se ao limite do nível amarelo.

Example of a door overlapping a level boundary

Como consertar doorOutsideLevel

Para corrigir um aviso doorOutsideLevel , redesenhe a geometria da porta para que esteja dentro dos limites do nível.

Avisos de zona

zoneWarning

Descrição para zoneWarning

O zoneWarning ocorre quando uma zona não contém um rótulo. O serviço de conversão descarta uma zona que não é label.l

Exemplo de zoneWarning

A imagem a seguir mostra uma zona que não contém um rótulo.

Example of a zone doesn't contain a label

Como corrigir zoneWarning

Para corrigir um zoneWarning, verifique se cada zona tem um único rótulo.

Advertências do rótulo

labelAdvertência

Descrição para labelWarning

O labelWarning ocorre quando o desenho contém rótulos ambíguos ou contraditórios.

Um labelWarning ocorre devido a um ou mais dos seguintes motivos:

Uma etiqueta de unidade não está em nenhuma unidade.
Um rótulo de zona não está em nenhuma zona.
Um rótulo de zona está dentro de duas ou mais zonas.

Exemplo de labelWarning

A imagem a seguir mostra um rótulo dentro de duas zonas.

Example of a label inside two zones

Como corrigir labelWarning

Para corrigir um labelWarning, certifique-se de que:

Todas as etiquetas de unidade estão dentro de unidades.
Todos os rótulos de zona estão dentro de zonas.
Todos os rótulos de zona estão em uma única zona.

Erros do pacote de desenho

invalidArchiveFormat

Descrição para invalidArchiveFormat

Um erro invalidArchiveFormat ocorre quando o pacote de desenho está em um formato de arquivo inválido, como GZIP ou 7-Zip. Apenas o formato de arquivo ZIP é suportado.

Um erro invalidArchiveFormat também ocorre se o arquivo ZIP estiver vazio.

Como corrigir invalidArchiveFormat

Para corrigir um erro invalidArchiveFormat , verifique se:

O nome do arquivo termina em .zip.
O seu arquivo ZIP contém dados.
Você pode abrir seu arquivo ZIP.

invalidUserData

Descrição para invalidUserData

Um erro UserData inválido ocorre quando o serviço de conversão não consegue ler um objeto de dados do usuário do armazenamento.

Cenário de exemplo para invalidUserData

Você tentou carregar um pacote de desenho com um parâmetro incorreto udid .

Como corrigir invalidUserData

Para corrigir um erro invalidUserData , verifique se:

Você forneceu uma correção udid para o pacote carregado.
O Azure Maps Creator foi habilitado para a conta do Azure Maps que você usou para carregar o pacote de desenho.
A solicitação de API para o serviço de Conversão contém a chave de assinatura para a conta do Azure Maps que você usou para carregar o pacote de desenho.

dwgError

Descrição para dwgError

Um dwgError quando o pacote de desenho contém um problema com um ou mais arquivos DWG no arquivo ZIP carregado.

O dwgError ocorre quando o pacote de desenho contém um arquivo DWG que não pode ser aberto porque é inválido ou corrompido.

Um ficheiro DWG não é um desenho válido do formato de ficheiro DWG do AutoCAD.
Um arquivo DWG está corrompido.
Um arquivo DWG está listado no arquivo manifest.json , mas está ausente do arquivo ZIP.

Como corrigir dwgError

Para corrigir um dwgError, inspecione seu arquivo manifest.json confirme que:

Todos os ficheiros DWG no seu arquivo ZIP são desenhos válidos em formato DWG do AutoCAD, abra cada um no AutoCAD. Remova ou corrija todos os desenhos inválidos.
A lista de ficheiros DWG no manifest.json corresponde aos ficheiros DWG no arquivo ZIP.

Erros de manifesto

inválidoJsonFormat

Descrição para invalidJsonFormat

Um erro JsonFormat inválido ocorre quando o arquivo manifest.json não pode ser lido.

O arquivo _manifest.json_file não pode ser lido devido a erros de formatação JSON ou sintaxe. Para saber mais sobre como o formato JSON e a sintaxe, consulte O formato de intercâmbio de dados JSON (JavaScript Object Notation).

Como corrigir invalidJsonFormat

Para corrigir um erro JsonFormat inválido, use um linter JSON para detetar e resolver quaisquer erros JSON.

missingRequiredField

Descrição para missingRequiredField

Um erro missingRequiredField ocorre quando o arquivo manifest.json está faltando dados necessários.

Como corrigir missingRequiredField

Para corrigir um erro missingRequiredField , verifique se o manifesto contém todas as propriedades necessárias. Para obter uma lista completa do objeto de manifesto necessário, consulte a seção manifesto em Requisitos do pacote de desenho.

missingManifest

Descrição para missingManifest

O erro missingManifest ocorre quando o arquivo manifest.json está ausente do arquivo ZIP.

O erro missingManifest ocorre devido a um ou mais dos seguintes motivos:

O arquivo manifest.json está escrito incorretamente.
O manifest.json está faltando.
O manifest.json não está dentro do diretório raiz do arquivo ZIP.

Como corrigir missingManifest

Para corrigir um erro missingManifest, confirme se o arquivo tem um arquivo chamado manifest.json no nível raiz do arquivo ZIP.

conflito

Descrição do conflito

O erro de conflito ocorre quando o arquivo manifest.json contém informações conflitantes.

Exemplo de cenário de conflito

O serviço de conversão retorna um erro de conflito quando mais de um nível é definido com o mesmo nível ordinal. O trecho JSON a seguir mostra dois níveis definidos com o mesmo ordinal.

"buildingLevels":
{
    "levels": [
        {
            "levelName": "Ground",
            "ordinal": 0,
            "filename": "./Level_0.dwg"
        },
        {
            "levelName": "Parking",
            "ordinal": 0,
            "filename": "./Level_P.dwg"
        }
    ]
}

Como corrigir conflitos

Para corrigir um erro de conflito , inspecione seu manifest.json e remova todas as informações conflitantes.

inválidoGeoreferência

Descrição para inválidoGeoreferência

O erro invalidGeoreference ocorre quando um arquivo manifest.json contém uma georreferência inválida.

O erro de georreferência inválida ocorre devido a um ou mais dos seguintes motivos:

O usuário está georreferenciando um valor de latitude ou longitude que está fora do alcance.
O usuário está georreferenciando um valor de rotação que está fora do intervalo.

Cenário de exemplo para inválidoGeoreference

No trecho JSON a seguir, a latitude está acima do limite superior.

"georeference"
{
    "lat": 88.0,
    "lon": -122.132600,
    "angle": 0
},

Como corrigir invalidGeoreference

Para corrigir um erro de georreferência inválido, verifique se os valores georreferenciados estão dentro do intervalo.

Importante

Em GeoJSON, a ordem das coordenadas é longitude e latitude. Se você não usar a ordem correta, poderá indicar acidentalmente um valor de latitude ou longitude fora do intervalo.

Erros de parede

wallErrors

Descrição para wallError

O wallError ocorre quando o desenho contém um erro ao tentar criar um recurso de parede.

Cenário de exemplo para wallError

A imagem a seguir exibe um recurso de parede que não se sobrepõe a nenhuma unidade.

Example of Wall feature that doesn't overlap any units

Como corrigir wallError

Para corrigir um erro wallError , redesenhe a parede para que ela se sobreponha a pelo menos uma unidade. Ou crie uma nova unidade que se sobreponha à parede.

Erros de penetração vertical

verticalPenetrationError

Descrição para verticalPenetrationError

O verticalPenetrationError ocorre quando o desenho contém um recurso de penetração vertical ambígua.

O verticalPenetrationError ocorre devido a um ou mais dos seguintes motivos:

O desenho contém uma área de penetração vertical sem sobreposição de áreas de penetração vertical em quaisquer níveis acima ou abaixo dela.
O pacote de desenho contém um nível com dois ou mais recursos de penetração vertical que se sobrepõem a um único recurso de penetração vertical em outro nível diretamente acima ou abaixo dele.

Cenário de exemplo para verticalPenetrationError

A imagem a seguir mostra uma área de penetração vertical sem áreas de penetração vertical sobrepostas em níveis acima ou abaixo dela.

Example of a vertical penetration 1

A imagem a seguir mostra uma área de penetração vertical que se sobrepõe a mais de uma área de penetração vertical em um nível adjacente.

Example of a vertical penetration 2

Como corrigir verticalPenetrationError

Para corrigir um erro verticalPenetrationError, leia sobre como usar um recurso de penetração vertical no artigo Requisitos do pacote de desenho.

Próximos passos

Como usar o visualizador de erros de Desenho do Azure Maps

Guia do pacote de desenho

Criador para mapeamento interno