Errores y advertencias de conversión de dibujos
Nota:
Retirada de Azure Maps Creator
El servicio de mapa de interiores de Azure Maps Creator ya está en desuso y se retirará el 30/9/25. Para más información, consulte Anuncio de fin de ciclo de vida de Azure Maps Creator.
El servicio de conversión de Azure Maps permite convertir paquetes de dibujo cargados en datos de mapa. Los paquetes de dibujos deben ajustarse a los requisitos de los paquetes de dibujos. Si no se cumplen uno o más requisitos, el servicio de conversión devuelve errores o advertencias. En este artículo se enumeran los códigos de error y de advertencia de conversión, con recomendaciones sobre cómo resolverlos. También proporciona algunos ejemplos de dibujos que pueden hacer que el servicio de conversión devuelva estos códigos.
El servicio de conversión realiza la operación correctamente si hay advertencias de conversión. Sin embargo, se recomienda que revise y resuelva todas las advertencias. Una advertencia significa que parte de la conversión se ignoró o corrigió automáticamente. Si no se resuelven las advertencias, podrían producirse errores en procesos posteriores.
Advertencias generales
geometryWarning
Descripción de geometryWarning
Se produce una advertencia geometryWarning cuando el dibujo contiene una entidad no válida. Una entidad no válida es una entidad que no se ajusta a las restricciones geométricas. Algunos ejemplos de entidades no válidas son un polígono que forma intersección con él mismo o una polilínea abierta en una capa que solo admite geometría cerrada.
El servicio de conversión no puede crear una característica del mapa a partir de una entidad no válida y, en su lugar, la omite.
Ejemplos de geometryWarning
Las dos imágenes siguientes muestran ejemplos de polígonos que forman intersección con ellos mismos.
En la imagen siguiente se muestra una polilínea abierta. Supongamos que la capa solo admite geometría cerrada.
Cómo corregir geometryWarning
Inspeccione geometryWarning para cada entidad para comprobar que sigue las restricciones geométricas.
unexpectedGeometryInLayer
Descripción de unexpectedGeometryInLayer
Se produce una advertencia unexpectedGeometryInLayer cuando el dibujo contiene geometría incompatible con el tipo de geometría esperado para una capa determinada. Cuando el servicio de conversión devuelve una advertencia unexpectedGeometryInLayer, omite esa geometría.
Ejemplo de unexpectedGeometryInLayer
En la imagen siguiente se muestra una polilínea abierta. Supongamos que la capa solo admite geometría cerrada.
Cómo corregir unexpectedGeometryInLayer
Inspeccione cada advertencia unexpectedGeometryInLayer y mueva la geometría incompatible a una capa compatible. Si no es compatible con ninguna de las demás capas, se debe quitar.
unsupportedFeatureRepresentation
Descripción de unsupportedFeatureRepresentation
La advertencia unsupportedFeatureRepresentation se produce cuando el dibujo contiene un tipo de entidad no admitido.
Ejemplo de unsupportedFeatureRepresentation
La imagen siguiente muestra un tipo de entidad no admitido como un objeto de texto de varias líneas en una capa de etiquetas.
Cómo corregir unsupportedFeatureRepresentation
Asegúrese de que los archivos DWG contengan solo los tipos de entidad admitidos. Los tipos admitidos se enumeran en la sección Requisitos de los archivos de dibujos en el artículo Requisitos de los paquetes de dibujos.
automaticRepairPerformed
Descripción de automaticRepairPerformed
La advertencia automaticRepairPerformed se produce cuando el servicio de conversión repara automáticamente geometría no válida.
Ejemplos de automaticRepairPerformed
En la imagen siguiente se muestra cómo el servicio de conversión reparó un polígono que formaba intersección con él mismo y generó una geometría válida.
En la imagen siguiente se muestra cómo el servicio de conversión ha ajustado el primero y el último vértice de una polilínea sin cerrar para crear una polilínea abierta, en la que el primero y el último vértice tenían menos de 1 mm de distancia.
En la imagen siguiente se muestra cómo, en una capa que solo admite polilíneas cerradas, el servicio de conversión reparó varias polilíneas abiertas. Para evitar descartar las polilíneas abiertas, el servicio las combinó en una única polilínea cerrada.
Cómo corregir automaticRepairPerformed
Para corregir una advertencia automaticRepairPerformed, realice las siguientes acciones:
- Inspeccione la geometría de cada advertencia y el texto de advertencia específico.
- Determine si la reparación automatizada es correcta.
- Si la reparación es correcta, continúe. En caso contrario, vaya al archivo de diseño y resuelva la advertencia manualmente.
Sugerencia
Para suprimir una advertencia en el futuro, realice cambios en el dibujo original para que el dibujo original coincida con el dibujo reparado.
Advertencias del manifiesto
redundantAttribution
Descripción de redundantAttribution
La advertencia redundantAttribution se produce cuando el manifiesto contiene propiedades de objeto redundantes o en conflicto.
Ejemplos de redundantAttribution
El siguiente ejemplo de JSON contiene dos o más objetos
unitProperties
con el mismoname
."unitProperties": [ { "unitName": "L1-100", "categoryName": "room.office" }, { "unitName": "L1-101", "categoryName": "room.office" }, { "unitName": "L1-101", "categoryName": "room.office" } ]
En el siguiente fragmento de JSON, dos o más objetos
zoneProperties
tienen el mismoname
."zoneProperties": [ { "zoneName": "Assembly Area 1", "categoryName": "zone.assembly" }, { "zoneName": "Assembly Area 2", "categoryName": "zone.assembly" }, { "zoneName": "Assembly Area 2", "categoryName": "zone.assembly" }
Cómo corregir redundantAttribution
Para corregir una advertencia *redundantAttribution, quite las propiedades de objeto redundantes o en conflicto.
manifestWarning
Descripción de manifestWarning
Se produce una advertencia manifestWarning cuando el manifiesto contiene objetos unitProperties o zoneProperties que no se usan durante la conversión.
Ejemplos de manifestWarning
El manifiesto contiene un objeto
unitProperties
con un elementounitName
que no tiene ninguna etiqueta coincidente en una capaunitLabel
.El manifiesto contiene un objeto
zoneProperties
con un elementozoneName
que no tiene ninguna etiqueta coincidente en una capazoneLabel
.
Cómo corregir manifestWarning
Para corregir una advertencia manifestWarning, quite el objeto unitProperties
o zoneProperties
sin usar del manifiesto, o agregue una etiqueta de unidad o zona al dibujo para que el objeto de propiedades se use durante la conversión.
Advertencias de paredes
wallOutsideLevel
Descripción de wallOutsideLevel
La advertencia wallOutsideLevel se produce cuando el dibujo contiene una geometría de pared fuera de los límites del esquema de un nivel.
Ejemplo de wallOutsideLevel
En la imagen siguiente se muestra una pared interior, en rojo, fuera del límite del nivel amarillo.
En la imagen siguiente se muestra una pared exterior, en rojo, fuera del límite del nivel amarillo.
Cómo corregir wallOutsideLevel
Para corregir una advertencia wallOutsideLevel, amplíe la geometría del nivel para incluir todas las paredes. O bien, modifique los límites de la pared para que quepan dentro del límite del nivel.
Advertencias de unidades
unitOutsideLevel
Descripción de unitOutsideLevel
Se produce una advertencia unitOutsideLevel cuando el dibujo contiene una geometría de unidad fuera de los límites del esquema del nivel.
Ejemplo de unitOutsideLevel
En la imagen siguiente, la geometría de la unidad, en rojo, supera los límites del límite del nivel amarillo.
Cómo corregir unitOutsideLevel
Para corregir una advertencia unitOutsideLevel, amplíe el límite del nivel para incluir todas las unidades. O bien, modifique la geometría de la unidad para que quepa dentro del límite del nivel.
partiallyOverlappingUnit
Descripción de partiallyOverlappingUnit
Se produce una advertencia partiallyOverlappingUnit cuando el dibujo contiene una geometría de unidad parcialmente superpuesta en otra geometría de unidad. El servicio de conversión descarta las unidades superpuestas.
Escenarios de ejemplo con partiallyOverlappingUnit
En la imagen siguiente, la unidad superpuesta se resalta en rojo. UNIT110
y HALLWAY
se descartan.
Cómo corregir partiallyOverlappingUnit
Para corregir una advertencia partiallyOverlappingUnit, vuelva a dibujar cada unidad parcialmente superpuesta para que no se superponga a otras unidades.
Advertencias de puertas
doorOutsideLevel
Descripción de doorOutsideLevel
Se produce una advertencia doorOutsideLevel cuando el dibujo contiene una geometría de puerta fuera de los límites de la geometría del nivel.
Ejemplo de doorOutsideLevel
En la imagen siguiente, la geometría de la puerta, resaltada en rojo, se superpone con el límite del nivel amarillo.
Cómo corregir doorOutsideLevel
Para corregir una advertencia doorOutsideLevel, vuelva a dibujar la geometría de la puerta para que esté dentro de los límites del nivel.
Advertencias de zonas
zoneWarning
Descripción de zoneWarning
La advertencia zoneWarning se produce cuando una zona no contiene una etiqueta. El servicio de conversión descarta una zona sin etiqueta.
Ejemplo de zoneWarning
En la imagen siguiente se muestra una zona que no contiene ninguna etiqueta.
Cómo corregir zoneWarning
Para corregir una advertencia zoneWarning, compruebe que cada zona tenga una sola etiqueta.
Advertencias de etiquetas
labelWarning
Descripción de labelWarning
La advertencia labelWarning se produce cuando el dibujo contiene una característica de etiquetas ambigua o contradictoria.
Se produce una advertencia labelWarning debido a uno o más de los siguientes motivos:
- Una etiqueta de unidad no está en ninguna unidad.
- Una etiqueta de zona no está en ninguna zona.
- Una etiqueta de zona está dentro de dos o más zonas.
Ejemplo de labelWarning
En la imagen siguiente se muestra una etiqueta que se encuentra dentro de dos zonas.
Cómo corregir labelWarning
Para corregir una advertencia labelWarning, asegúrese de lo siguiente:
- Todas las etiquetas de unidad están dentro de unidades.
- Todas las etiquetas de zona están dentro de zonas.
- Todas las etiquetas de zona se encuentran en una sola zona.
Errores de paquetes de dibujos
invalidArchiveFormat
Descripción de invalidArchiveFormat
Se produce un error invalidArchiveFormat cuando el paquete de dibujos está en un formato de archivo no válido, como GZIP o 7-Zip. Solo se admite el formato de archivo ZIP.
También se produce un error invalidArchiveFormat si el archivo ZIP está vacío.
Cómo corregir invalidArchiveFormat
Para corregir un error invalidArchiveFormat, compruebe lo siguiente:
- El nombre del archivo de almacenamiento termina en .zip.
- El archivo ZIP contiene datos.
- Puede abrir el archivo ZIP.
invalidUserData
Descripción de invalidUserData
Se produce un error invalidUserData cuando el servicio de conversión no puede leer un objeto de datos de usuario del almacenamiento.
Escenario de ejemplo de invalidUserData
Ha intentado cargar un paquete de dibujos con un parámetro udid
incorrecto.
Cómo corregir invalidUserData
Para corregir un error invalidUserData, compruebe lo siguiente:
- Ha proporcionado un
udid
correcto para el paquete cargado. - Azure Maps Creator se ha habilitado para la cuenta de Azure Maps que usó a fin de cargar el paquete de dibujos.
- La solicitud de la API al servicio de conversión contiene la clave de suscripción a la cuenta de Azure Maps que usó para cargar el paquete de dibujos.
dwgError
Descripción de dwgError
Se produce un error dwgError cuando el paquete de dibujos tiene un problema con uno o más archivos DWG en el archivo ZIP cargado.
El error dwgError se produce cuando el paquete de dibujos contiene un archivo DWG que no se puede abrir porque no es válido o está dañado.
- Un archivo DWG no es un dibujo en el formato de archivo DWG de AutoCAD válido.
- Un archivo DWG está dañado.
- Un archivo DWG aparece en el archivo manifest.json, pero no está en el archivo ZIP.
Cómo corregir dwgError
Para corregir un error dwgError, inspeccione el archivo manifest.json para confirmar lo siguiente:
- Todos los archivos DWG del archivo ZIP son dibujos válidos en el formato DWG de AutoCAD; abra cada uno de ellos en AutoCAD. Quite o corrija todos los dibujos no válidos.
- La lista de archivos DWG en el archivo manifest.json coincide con los archivos DWG del archivo ZIP.
Errores del manifiesto
invalidJsonFormat
Descripción de invalidJsonFormat
Se produce un error invalidJsonFormat cuando no se puede leer el archivo manifest.json.
No se puede leer el archivo _manifest.json_ debido a errores de formato o sintaxis JSON. Para obtener más información sobre el formato y la sintaxis JSON, consulte Formato de intercambio de datos de notación de objetos JavaScript (JSON).
Cómo corregir invalidJsonFormat
Para corregir un error invalidJsonFormat, use un linter de JSON para detectar y resolver errores de JSON.
missingRequiredField
Descripción de missingRequiredField
Se produce un error missingRequiredField cuando el archivo manifest.json no contiene datos obligatorios.
Cómo corregir missingRequiredField
Para corregir un error missingRequiredField, compruebe que el manifiesto contiene todas las propiedades obligatorias. Para obtener una lista completa de los objetos del manifiesto obligatorios, consulte la sección sobre el manifiesto en los requisitos del paquete de dibujos.
missingManifest
Descripción de missingManifest
El error missingManifest se produce cuando falta el archivo manifest.json en el archivo ZIP.
El error labelWarning se produce debido a uno o más de los siguientes motivos:
- El nombre del archivo manifest.json está mal escrito.
- Falta el archivo manifest.json.
- El archivo manifest.json no está dentro del directorio raíz del archivo ZIP.
Cómo corregir missingManifest
Para corregir un error missingManifest, confirme que el archivo tiene un archivo denominado manifest.json en el nivel raíz del archivo ZIP.
conflict
Descripción de conflict
El error conflict se produce cuando el archivo manifest.json contiene información en conflicto.
Escenario de ejemplo de conflict
El servicio de conversión devuelve un error conflict cuando se defina más de un nivel con el mismo ordinal de nivel. El siguiente fragmento de JSON muestra dos niveles definidos con el mismo ordinal.
"buildingLevels":
{
"levels": [
{
"levelName": "Ground",
"ordinal": 0,
"filename": "./Level_0.dwg"
},
{
"levelName": "Parking",
"ordinal": 0,
"filename": "./Level_P.dwg"
}
]
}
Cómo corregir conflict
Para corregir un error conflict, inspeccione el archivo manifest.json y quite cualquier información en conflicto.
invalidGeoreference
Descripción de invalidGeoreference
Se produce el error invalidGeoreference cuando un archivo manifest.json contiene una referencia geográfica no válida.
El error invalidGeoreference se produce debido a uno o más de los siguientes motivos:
- El usuario está realizando una referencia geográfica de un valor de latitud o longitud que está fuera del intervalo.
- El usuario está realizando una referencia geográfica de un valor de rotación que está fuera del intervalo.
Escenario de ejemplo de invalidGeoreference
En el siguiente fragmento de JSON, la latitud está por encima del límite superior.
"georeference"
{
"lat": 88.0,
"lon": -122.132600,
"angle": 0
},
Cómo corregir invalidGeoreference
Para corregir un error invalidGeoreference, compruebe que los valores de la referencia geográfica se encuentran dentro del intervalo.
Importante
En GeoJSON, el orden de las coordenadas es longitud y latitud. Si no usa el orden correcto, puede que haga referencia accidentalmente a un valor de latitud o longitud que esté fuera del intervalo.
Errores de paredes
wallErrors
Descripción de wallError
El error wallError se produce cuando el dibujo contiene un error al intentar crear una característica de pared.
Escenario de ejemplo de wallError
En la imagen siguiente se muestra una característica de pared que no se superpone a ninguna unidad.
Cómo corregir wallError
Para corregir un error wallError, vuelva a dibujar la pared para que se superponga al menos a una unidad. O bien, cree una nueva unidad que se superponga a la pared.
Errores de penetraciones verticales
verticalPenetrationError
Descripción de verticalPenetrationError
El error verticalPenetrationError se produce cuando el dibujo contiene una característica de penetración vertical ambigua.
El error verticalPenetrationError se produce debido a uno o más de los siguientes motivos:
- El dibujo contiene un área de penetración vertical sin áreas de penetración vertical superpuestas en ningún nivel por encima o por debajo.
- El paquete de dibujos contiene un nivel con dos o más características de penetración vertical que se superponen a una única característica de penetración vertical en otro nivel directamente por encima o por debajo.
Escenario de ejemplo de verticalPenetrationError
En la imagen siguiente se muestra un área de penetración vertical sin áreas de penetración vertical superpuestas en los niveles por encima o por debajo.
En la imagen siguiente se muestra un área de penetración vertical que se superpone a más de un área de penetración vertical en un nivel adyacente.
Cómo corregir verticalPenetrationError
Para corregir un error verticalPenetrationError, consulte cómo usar una característica de penetración vertical en el artículo Requisitos de los paquetes de dibujos.