Compartir vía

Requisitos de paquetes de dibujos

  • Artículo

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.

Puede convertir paquetes de dibujo cargados en datos de mapa mediante el servicio de conversión de Azure Maps. En este artículo se describen los requisitos de los paquetes de dibujos para la API de conversión. Para ver un paquete de ejemplo, puede descargar el paquete de dibujos de ejemplo.

Requisitos previos

El paquete de dibujos incluye dibujos guardados en formato DWG, que es el formato de archivo nativo del software AutoCAD® de Autodesk.

Puede elegir cualquier software de CAD para generar los dibujos en el paquete de dibujos.

El servicio de conversión convierte un paquete de dibujos en datos de mapa. El servicio de conversión funciona con el formato de archivo DWG de AutoCAD AC1032.

Glosario de términos

Para facilitar la referencia, estos son algunos términos y definiciones que son importantes a la hora de leer este artículo.

Término Definición
Nivel Capa de DWG de AutoCAD del archivo de dibujo.
Entidad Entidad de DWG de AutoCAD del archivo de dibujo.
Xref Archivo en formato de archivo DWG de AutoCAD adjunto al dibujo principal como referencia externa.
Nivel Área de un edificio en una elevación determinada. Por ejemplo, la planta de un edificio.
Característica Instancia de un objeto generado a partir del servicio de conversión que combina una geometría con información de metadatos.
Clases de características Proyecto común para las características. Por ejemplo, una unidad es una clase de característica y una oficina es una característica.

Estructura de un paquete de dibujos

Un paquete de dibujos es un archivo .zip que contiene los archivos siguientes:

  • Archivos DWG en formato de archivo DWG de AutoCAD.
  • Archivo manifest.json que describe los archivos DWG en el paquete de dibujo.

El paquete de dibujo debe comprimirse en un solo archivo de almacenamiento, con la extensión .zip. Los archivos DWG se pueden organizar de cualquier manera dentro del paquete, pero el archivo de manifiesto debe residir en el directorio raíz del paquete comprimido. En las secciones siguientes se detallan los requisitos para los archivos DWG, el archivo de manifiesto y el contenido de estos archivos. Para ver un paquete de ejemplo, puede descargar el paquete de dibujos de ejemplo.

Proceso de conversión de archivos DWG

El servicio de conversión hace lo siguiente en cada archivo DWG:

  • Extrae clases de características:
    • Niveles
    • Unidades
    • Zones
    • Aperturas
    • Paredes
    • Penetraciones verticales
  • Genera una característica Facility.
  • Produce un conjunto mínimo de funciones de categoría predeterminadas a las que hacen referencia otras funciones:
    • room
    • structure
    • wall
    • opening.door
    • zona
    • dispositivo

Requisitos del archivo DWG

Se requiere un único archivo DWG para cada nivel de la instalación. Todos los datos de una sola capa deben estar contenidos en un único archivo DWG. Cualquier referencia externa (xref) debe estar enlazada al dibujo principal. Por ejemplo, una instalación con tres capas tendrá tres archivos DWG en el paquete de dibujo.

Cada archivo DWG, debe cumplir los siguientes requisitos:

  • El archivo DWG definir las capas Exterior y Unidad. Opcionalmente, puede definir las siguientes capas: Pared, Puerta, UnitLabel, Zona y ZoneLabel.
  • El archivo DWG no puede contener características de varias capas.
  • El archivo DWG no puede contener características de varias instalaciones.
  • El archivo DWG debe hacer referencia al mismo sistema de medida y a la unidad de medida que otros archivos DWG en el paquete de dibujo.

Requisitos de las capas de DWG

Cada capa de DWG debe cumplir las reglas siguientes:

  • Una capa debe contener exclusivamente características de una sola clase. Por ejemplo, las unidades y las paredes no pueden estar en la misma capa.
  • Una única clase de características se puede representar mediante varias capas.
  • Se permiten los polígonos que se autointersecan, pero se reparan automáticamente. Cuando se reparan, el servicio de conversión genera una advertencia. Se recomienda inspeccionar manualmente los resultados reparados, ya que es posible que no coincidan con los resultados esperados.
  • Cada capa tiene una lista admitida de tipos de entidad. Se omitirán todos los demás tipos de entidad de una capa. Por ejemplo, las entidades de texto no se admiten en la capa de pared.

La siguiente tabla describe los tipos de entidades admitidos y las características del mapa convertido para cada capa. Si una capa contiene tipos de entidad no admitidos, el servicio de conversión omitirá esas entidades.

Nivel Tipos de entidades Características convertidas
Exterior POLÍGONO, POLILÍNEA (cerrada), CÍRCULO O ELIPSE (cerrada) Niveles
Unidad POLÍGONO, POLILÍNEA (cerrada), CÍRCULO O ELIPSE (cerrada) Unidades y penetraciones verticales
Pared POLÍGONO, POLILÍNEA (cerrada), CÍRCULO O ELIPSE (cerrada), Estructuras
Puerta POLÍGONO, POLILÍNEA, LÍNEA, ARCO CIRCULAR, CÍRCULO Aperturas
Zona POLÍGONO, POLILÍNEA (cerrada), CÍRCULO O ELIPSE (cerrada) Zones
UnitLabel Texto (una línea) No aplicable. Esta capa solo puede agregar propiedades a las características de las unidades de la capa de unidades. Para más información, consulte la capa de unitLabel.
ZoneLabel Texto (una línea) No aplicable. Esta capa solo puede agregar propiedades a las características de zona de la capa de unidades. Para más información, consulte la capa de ZoneLabel.

Las siguientes secciones describen los requisitos de cada capa.

Capa exterior

El archivo DWG de cada nivel debe contener una capa para definir el perímetro de ese nivel. Esta capa se conoce como capa exterior. Por ejemplo, si una instalación contiene dos niveles, debe tener dos archivos DWG, con una capa exterior para cada archivo.

Independientemente de cuántos dibujos de entidad haya en la capa exterior, el conjunto de la instalación resultante contiene solo una característica de nivel para cada archivo DWG. Además:

  • Los exteriores deben dibujarse como POLÍGONOS, POLILÍNEAS (cerradas), CÍRCULOS o ELIPSES (cerradas).
  • Los exteriores pueden superponerse, pero se disuelven en una geometría.
  • La característica de nivel resultante debe tener al menos 4 metros cuadrados.
  • La característica de nivel resultante no debe tener más de 400 000 metros cuadrados.

Si la capa contiene varias polilíneas superpuestas, estas se disuelven en una única característica de nivel. En su lugar, si la capa contiene varias polilíneas que no se solapan, la característica de nivel resultante tiene una representación multipoligonal.

Puede ver un ejemplo de la capa exterior como capa de contorno en el paquete de dibujos de ejemplo.

Capa de unidades

El archivo DWG para cada nivel define una capa que contenga unidades. Las unidades son espacios transitables en el edificio, como oficinas, vestíbulos, escaleras y ascensores. Si se define la propiedad VerticalPenetrationCategory, las unidades navegables que abarcan varios niveles, como ascensores y escaleras, se convierten en características de penetración vertical. A las características de penetración vertical que se superponen entre sí se les asigna un elemento setid.

La capa de unidades debe cumplir los siguientes requisitos:

  • Las unidades deben dibujarse como POLÍGONOS, POLILÍNEAS (cerradas), CÍRCULOS o ELIPSES (cerradas).
  • Las unidades deben estar dentro de los límites del perímetro exterior de la instalación.
  • Las unidades no pueden superponerse parcialmente.
  • Las unidades no pueden contener ninguna geometría que forme intersección con ella misma.

Asigne un nombre a una unidad creando un objeto de texto en la capa de UnitLabel y, a continuación, coloque el objeto dentro de los límites de la unidad. Para más información, consulte la capa de unitLabel.

Puede ver un ejemplo de la capa de unidades en el paquete de dibujos de ejemplo.

Capa de paredes

El archivo DWG de cada nivel puede contener una capa que defina las extensiones físicas de las paredes, las columnas y otras estructuras del edificio.

  • Las paredes deben dibujarse como POLÍGONOS, POLILÍNEAS (cerradas), CÍRCULOS o ELIPSES (cerradas).
  • La capa de paredes o las paredes solo deben contener geometría que se interprete como estructura del edificio.

Puede ver un ejemplo de la capa de paredes en el paquete de dibujos de ejemplo.

Capa de puertas

Puede incluir una capa DWG que contenga puertas. Cada puerta debe superponerse con el borde de una unidad de la capa de unidad.

Las aberturas de puertas de un conjunto de datos de Azure Maps se representan como un segmento de una sola línea que se superpone sobre varios límites de unidades. Las imágenes siguientes muestran cómo convierte Azure Maps la geometría de capa de puertas en características de aperturas en un conjunto de datos.

Cuatro gráficos que muestran los pasos para generar aperturas

Capa de zonas

El archivo DWG de cada nivel puede contener una capa de zonas que defina las extensiones físicas de las zonas. Una zona es un espacio no navegable que se puede denominar y representar. Las zonas pueden abarcar varios niveles y se agrupan mediante la propiedad zoneSetId.

  • Las zonas deben dibujarse como POLÍGONOS, POLILÍNEAS (cerradas), CÍRCULOS o ELIPSES (cerradas).
  • Las zonas pueden superponerse.
  • Las zonas pueden estar dentro o fuera del perímetro exterior de la instalación.

Asigne un nombre a una zona creando un objeto de texto en la capa de ZoneLabel y colocando el objeto de texto dentro de los límites de la zona. Para más información, consulte la capa de ZoneLabel.

Puede ver un ejemplo de la capa de zona en el paquete de dibujo de ejemplo.

Capa de unitLabel

El archivo DWG de cada nivel puede contener una capa de UnitLabel. La capa de UnitLabel agrega una propiedad de nombre a las unidades extraídas de la capa de unidades. Las unidades con una propiedad de nombre pueden tener más detalles especificados en el archivo de manifiesto.

  • Las etiquetas de las unidades deben ser entidades de texto de una sola línea.
  • Las etiquetas de las unidades deben estar completamente dentro de los límites de su unidad.
  • Las unidades no deben contener varias entidades de texto en la capa de UnitLabel.

Puede ver un ejemplo de la capa de UnitLabel en el paquete de dibujo de ejemplo.

Capa de ZoneLabel

El archivo DWG de cada nivel puede contener una capa de ZoneLabel. Esta capa agrega una propiedad de nombre a las zonas extraídas de la capa de zonas. Las zonas con una propiedad de nombre pueden tener más detalles especificados en el archivo de manifiesto.

  • Las etiquetas de las zonas deben ser entidades de texto de una sola línea.
  • Las etiquetas de las zonas deben estar dentro de los límites de su zona.
  • Las zonas no deben contener varias entidades de texto en la capa de ZoneLabel.

Puede ver un ejemplo de la capa de ZoneLabel en el paquete de dibujo de ejemplo.

Requisitos del archivo de manifiesto

La carpeta ZIP debe contener un archivo de manifiesto en el nivel raíz del directorio y el archivo debe tener el nombre manifest.json. Describe los archivos DWG para permitir que el servicio de conversión analice su contenido. Solo se ingieren los archivos identificados por el manifiesto. Los archivos que se encuentren en la carpeta zip, pero que no se enumeran correctamente en el manifiesto, se omiten.

Aunque hay requisitos al usar los objetos del manifiesto, no se requieren todos los objetos. En la siguiente tabla se muestran los objetos obligatorios y los opcionales para la versión 1.1 del servicio de conversión.

Nota

A menos que se especifique lo contrario, todas las propiedades con un tipo de propiedad de cadena permiten mil caracteres.

Object Obligatorio Descripción
version true Versión del esquema de manifiesto. Actualmente, solo se admite la versión 1.1.
directoryInfo true Describe la información geográfica y de contacto de la instalación. También se puede usar para describir información geográfica y de contacto de un ocupante.
buildingLevels true Especifica los niveles de los edificios y los archivos que contienen el diseño de los niveles.
georeference true Contiene información geográfica numérica para el dibujo de la instalación.
dwgLayers true Enumera los nombres de las capas y cada capa enumera los nombres de sus propias características.
unitProperties false Se puede usar para insertar más metadatos para las características de la unidad.
zoneProperties false Se puede usar para insertar más metadatos para las características de la zona.

En las secciones siguientes se detallan los requisitos de cada objeto.

directoryInfo

Propiedad Type Obligatorio Description
name string true Nombre del edificio.
streetAddress string false Dirección del edificio.
unit string false Unidad en el edificio.
locality string false Nombre de una ciudad, ciudad, área, barrio o región.
adminDivisions Matriz JSON de cadenas false Matriz que contiene designaciones de direcciones. Por ejemplo: (Código, Estado) use códigos de país ISO 3166 y códigos de estado o territorio ISO 3166-2.
postalCode string false Código postal.
hoursOfOperation string false Sigue el formato de horas de apertura de OSM.
phone string false Número de teléfono asociado con el edificio.
website string false Sitio web asociado con el edificio.
nonPublic bool false Marca que especifica si el edificio está abierto al público.
anchorLatitude NUMERIC false Latitud del marcador (chincheta) de la instalación.
anchorLongitude NUMERIC false Longitud del marcador (chincheta) de la instalación.
anchorHeightAboveSeaLevel NUMERIC false Altura de la planta baja de la instalación sobre el nivel del mar, en metros.
defaultLevelVerticalExtent (numérico) false Altura (grosor) predeterminada de un nivel de esta instalación que se usará cuando el valor verticalExtent de un nivel no esté definido.

buildingLevels

El objeto buildingLevels contiene una matriz JSON de los niveles del edificio.

Propiedad Type Obligatorio Description
levelName string true Nombre descriptivo del nivel. Por ejemplo: Piso 1, Vestíbulo, Aparcamiento o Sótano.
ordinal integer true Determina el orden vertical de los niveles. Cada instalación debe tener un nivel con el ordinal 0.
heightAboveFacilityAnchor NUMERIC false Altura del nivel sobre el marcador en metros.
verticalExtent NUMERIC false Altura del suelo al techo (grosor) del nivel en metros.
filename string true Ruta de acceso del sistema de archivos del dibujo de CAD para un nivel del edificio. Debe ser relativa a la raíz del archivo ZIP del edificio.

georeference

Propiedad Type Obligatorio Descripción
lat NUMERIC true Representación decimal de los grados de latitud en el origen del dibujo de la instalación. Las coordenadas de origen deben estar en el formato WGS84 Web Mercator (EPSG:3857).
lon NUMERIC true Representación decimal de los grados de longitud en el origen del dibujo de la instalación. Las coordenadas de origen deben estar en el formato WGS84 Web Mercator (EPSG:3857).
angle NUMERIC true Ángulo en el sentido de las agujas del reloj, en grados, entre el norte verdadero y el eje vertical (Y) del dibujo.

dwgLayers

Propiedad Type Obligatorio Descripción
exterior Matriz de cadenas true Nombres de las capas que definen el perfil exterior del edificio.
unit Matriz de cadenas false Nombres de las capas que definen las unidades.
wall Matriz de cadenas false Nombres de las capas que definen las paredes.
door Matriz de cadenas false Nombres de las capas que definen las puertas.
unitLabel Matriz de cadenas false Nombres de las capas que definen los nombres de las unidades.
zone Matriz de cadenas false Nombres de las capas que definen las zonas.
zoneLabel Matriz de cadenas false Nombres de las capas que definen los nombres de las zonas.

unitProperties

El objeto unitProperties contiene una matriz JSON de las propiedades de la unidad.

Propiedad Type Obligatorio Description
unitName string true Nombre de la unidad que se asociará a este registro unitProperty. Este registro solo es válido cuando se encuentra una etiqueta que coincida con unitName en las capas de unitLabel.
categoryName string false Finalidad de la aplicación. Una lista de valores que los estilos de representación proporcionados pueden usar se documenta en categorías.json.
occupants matriz de objetos directoryInfo false Lista de ocupantes de la unidad.
nameAlt string false Nombre alternativo de la unidad.
nameSubtitle string false Subtítulo de la unidad.
addressRoomNumber string false Número de habitación, unidad, apartamento o suite de la unidad.
verticalPenetrationCategory string false Cuando se define esta propiedad, la característica resultante es una penetración vertical (VRT) en lugar de una unidad. Puede usar penetraciones verticales para ir a otras entidades de penetración vertical en las capas superiores o inferiores. La penetración vertical es un nombre de categoría. Si se define esta propiedad, la propiedad categoryName se reemplaza por verticalPenetrationCategory.
verticalPenetrationDirection string false Si se define verticalPenetrationCategory, defina opcionalmente la dirección válida de desplazamiento. Los valores admitidos son: lowToHigh, highToLow, both y closed. El valor predeterminado es both. El valor distingue mayúsculas de minúsculas.
nonPublic bool false Indica si la unidad está abierta al público.
isRoutable bool false Cuando esta propiedad se establece en false, no se puede ir a la unidad o a través de ella. El valor predeterminado es true.
isOpenArea bool false Permite que el agente de navegación entre en la unidad sin necesidad de una apertura asociada a la unidad. De forma predeterminada, este valor se establece en true para las unidades sin aperturas y en false para las unidades con aperturas. La configuración manual isOpenArea a false en una unidad sin aberturas da como resultado una advertencia, porque un agente de navegación no puede acceder a la unidad resultante.

zoneProperties

El objeto zoneProperties contiene una matriz JSON de las propiedades de la zona.

Propiedad Type Obligatorio Descripción
zoneName string true Nombre de la zona que se asociará al registro zoneProperty. Este registro solo es válido cuando se encuentra una etiqueta que coincida con zoneName en la capa de zoneLabel de la zona.
categoryName string false Finalidad de la zona. Una lista de valores que los estilos de representación proporcionados pueden usar se documenta en categorías.json.
zoneNameAlt string false Nombre alternativo de la zona.
zoneNameSubtitle string false Subtítulo de la zona.
zoneSetId string false Establezca el identificador a fin de fijar una relación entre varias zonas para que se puedan consultar o seleccionar como grupo. Por ejemplo, las zonas que abarcan varios niveles.

Manifiesto de paquete de dibujo de ejemplo

A continuación se muestra el archivo de manifiesto del paquete de dibujo de muestra. Vaya al paquete de dibujo de muestra para Azure Maps Creator en GitHub para descargar todo el paquete.

Archivo de manifiesto

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

Puede convertir paquetes de dibujo cargados en datos de mapa mediante el servicio de conversión de Azure Maps. En este artículo se describen los requisitos de los paquetes de dibujos para la API de conversión. Para ver un paquete de ejemplo, puede descargar el paquete de dibujos de ejemplo v2.

Para obtener una guía sobre cómo preparar tu paquete de dibujo, consulta la Guía del paquete de dibujo.

Cambios y revisiones

  • Más asistencia para las cases de características definidas por el usuario.
  • Requisitos simplificados de las capas DWG.

Requisitos previos

El paquete de dibujos incluye dibujos guardados en formato DWG, que es el formato de archivo nativo del software AutoCAD® de Autodesk.

Puede elegir cualquier software de CAD para generar los dibujos en el paquete de dibujos.

El servicio de conversión convierte un paquete de dibujos en datos de mapa. El servicio de conversión funciona con el formato de archivo DWG de AutoCAD AC1032.

Glosario de términos

Para facilitar la referencia, estos son algunos términos y definiciones que son importantes a la hora de leer este artículo.

Término Definición
Nivel Capa de DWG de AutoCAD del archivo de dibujo.
Entidad Entidad de DWG de AutoCAD del archivo de dibujo.
Xref Archivo en formato de archivo DWG de AutoCAD adjunto al dibujo principal como referencia externa.
Nivel Un área de una instalación en una elevación definida. Por ejemplo, el suelo de una instalación.
Característica Instancia de un objeto generado a partir del servicio de conversión que combina una geometría con información de metadatos.
Clases de características Proyecto común para las características.

Estructura de un paquete de dibujos

Un paquete de dibujos es un archivo .zip que contiene los archivos siguientes:

  • Archivos DWG en formato de archivo DWG de AutoCAD.
  • Archivo manifest.json que describe los archivos DWG en el paquete de dibujo.

El paquete de dibujo debe comprimirse en un solo archivo de almacenamiento, con la extensión .zip. Los archivos DWG se pueden organizar de cualquier manera dentro del paquete de dibujos, pero el archivo de manifiesto debe estar en el directorio raíz. En las secciones siguientes se explican el proceso de conversión y los requisitos de los archivos DWG y de manifiesto, así como el contenido de estos archivos. Para ver un paquete de ejemplo, puede descargar el paquete de dibujos de ejemplo v2.

Proceso de conversión de archivos DWG

El servicio de conversión de Azure Maps convierte los archivos DWG de una instalación para asignar datos que representan una instalación y características de una instalación.

El servicio de conversión de Azure Maps crea:

  • Característica de instalación: la característica de nivel superior de una instalación a la que están asociados todos los niveles de una instalación.
  • Características de nivel: se crea una característica de nivel para cada planta de una instalación. Todas las características de un nivel están asociadas a un nivel.
  • Características definidas por el usuario: las capas DWG se asignan a una clase de característica definida por el usuario y se convierten en instancias de la clase de característica.

Requisitos del archivo DWG

Todos los archivos DWG deben cumplir los siguientes requisitos:

  • El archivo DWG no puede contener características de varias instalaciones.
  • El archivo DWG no puede contener características de varias capas. Por ejemplo, una instalación con tres capas tendrá tres archivos DWG en el paquete de dibujo.
  • Todos los datos de una sola capa deben estar contenidos en un único archivo DWG. Cualquier referencia externa (xref) debe estar enlazada al dibujo principal.
  • El archivo DWG debe definir capas que representen el límite de ese nivel.
  • El archivo DWG debe hacer referencia al mismo sistema de medida y a la unidad de medida que otros archivos DWG en el paquete de dibujo.
  • El archivo DWG debe alinearse cuando se apila en otro nivel de la misma instalación.

Requisitos de las capas de DWG

Clases de características

Una o varias capas DWG se pueden asignar a una clase de característica definida por el usuario. Se crea una instancia de la característica a partir de una entidad en la capa asignada. Por ejemplo, las capas DWG de silla, mesa y sofá se asignan a una clase de características denominada muebles. Se crea una característica de muebles para cada entidad a partir de las capas definidas. Además:

  • Todas las capas se deben separar para representar diferentes tipos de características de la instalación.
  • Todas las entidades deben estar dentro de los límites del perímetro de nivel.
  • Tipos de entidad de AutoCAD admitidos: TEXT, MTEXT, POINT, ARC, CIRCLE, LINE, POLYLINE, ELLIPSE.

Propiedades de clase de características

Las entidades de texto que se encuentran dentro de los límites de una forma cerrada se pueden asociar a esa característica como una propiedad. Por ejemplo, una clase de característica de sala podría tener texto que describa el nombre de la sala y otra, el paquete de dibujos de ejemplo v2 del tipo de sala. Además:

  • Solo las entidades TEXT y MTEXT están asociadas a la característica como una propiedad. Se omiten todos los demás tipos de entidad.
  • El punto de justificación TEXT y MTEXT debe estar dentro de los límites de la forma cerrada.
  • Si más de una propiedad TEXT está dentro de los límites de la forma cerrada y ambas se asignan a una propiedad, se selecciona una aleatoriamente.

Niveles de instalación

El archivo DWG de cada nivel debe contener una capa para definir el perímetro de ese nivel. Por ejemplo, si una instalación contiene dos niveles, debe tener dos archivos DWG, cada uno con una capa que defina el perímetro de ese nivel.

Independientemente de cuántos dibujos de entidad haya en la capa de perímetro de nivel, el conjunto de datos de la instalación resultante contendrá solo una característica de nivel para cada archivo DWG. Además:

  • Los perímetros de nivel deben dibujarse como POLÍGONOS, POLILÍNEAS (cerradas), CÍRCULOS o ELIPSES (cerradas).
  • Los perímetros de nivel pueden superponerse, pero se disuelven en una geometría.
  • La característica de nivel resultante debe tener al menos 4 metros cuadrados.
  • La característica de nivel resultante no debe tener más de 400 000 metros cuadrados.

Si la capa contiene varias polilíneas superpuestas, estas se combinan en una única característica de nivel. En su lugar, si la capa contiene varias polilíneas que no se solapan, la característica de nivel resultante tiene una representación multipoligonal.

Puede ver un ejemplo de la capa de perímetro de nivel como la capa GROS$ en el paquete de dibujos de ejemplo v2.

Requisitos del archivo de manifiesto

El paquete de dibujos debe contener un archivo de manifiesto en el nivel raíz y el archivo debe tener el nombre manifest.json. Describe los archivos DWG para permitir que el servicio de conversión analice su contenido. Solo se usan los archivos identificados por el manifiesto. Los archivos que se encuentren en el paquete de dibujos, pero que no se enumeran correctamente en el manifiesto, se omiten.

Las rutas de acceso en el objeto buildingLevels del archivo de manifiesto deben ser relativas a la raíz del paquete de dibujos. El nombre del archivo DWG debe coincidir exactamente con el nombre del nivel de la instalación. Por ejemplo, un archivo DWG para el nivel "Sótano" es Sótano.dwg. Un archivo DWG para el nivel 2 tiene el nombre nivel_2.dwg. Los nombres de archivo no pueden contener espacios, puede usar un carácter de subrayado para reemplazar los espacios.

Aunque hay requisitos al usar los objetos del manifiesto, no se requieren todos los objetos. En la siguiente tabla se muestran los objetos obligatorios y los opcionales para el servicio de conversión de la 2023-03-01-preview.

Nota

A menos que se especifique lo contrario, todas las propiedades de cadena están limitadas a mil caracteres.

Un archivo de manifiesto JSON

Propiedad Type Obligatorio Descripción
version cadena VERDADERO Versión del esquema de manifiesto. Versión actual "2.0"
buildingLevels Objeto BuildingLevels VERDADERO Especifica los niveles de las instalaciones y los archivos que contienen el diseño de los niveles.
featureClasses Matriz de objetos featureClass VERDADERO Lista de objetos de clase de características que definen cómo se leen las capas del archivo de dibujo DWG.
georeference Objeto Georeference FALSO Contiene información geográfica numérica para el dibujo de la instalación.    
facilityName string FALSO Nombre de la instalación.

En las secciones siguientes se detallan los requisitos de cada objeto.

buildingLevels

Propiedad Type Obligatorio Descripción
dwgLayers Matriz de cadenas VERDADERO Nombres de las capas que definen el perfil exterior de la instalación.
levels Matriz de objetos de nivel VERDADERO Un nivel hace referencia a un piso único en la instalación definida en un archivo DWG, la altura de cada nivel y el orden vertical en el que aparecen.

Nivel

Propiedad Type Obligatorio Description
levelName string VERDADERO Nombre del nivel. Por ejemplo: Piso 1, Vestíbulo, Aparcamiento o Sótano.
ordinal integer VERDADERO Determina el orden vertical de los niveles. Todos los valores ordinal deben ser únicos dentro de una instalación.
filename string VERDADERO Ruta de acceso y nombre del archivo DWG que representa el nivel de una instalación. La ruta de acceso debe ser relativa a la raíz del paquete de dibujos. 
verticalExtent number FALSO Altura vertical del suelo al techo (grosor) del nivel en metros.

featureClass

Propiedad Type Obligatorio Descripción
dwgLayers Matriz de cadenas VERDADERO Nombre de cada capa que define la clase de característica. Cada entidad de la capa especificada se convierte en una instancia de la clase de característica. El nombre dwgLayer del que se convierte una característica termina como una propiedad de esa característica.
featureClassName String VERDADERO Nombre de la clase de característica. Entre los ejemplos típicos se incluyen la sala, el área de trabajo o la pared.
featureClassProperties Matriz de objetos featureClassProperty FALSO Especifica las capas de texto en el archivo DWG asociado a la característica como una propiedad. Por ejemplo, una etiqueta que se encuentra dentro de los límites de un espacio, como un número de sala.

featureClassProperty

Propiedad Type Obligatorio Descripción
dwgLayers Matriz de cadenas VERDADERO Nombre de cada capa que define la propiedad de la clase de característica. Cada entidad de la capa especificada se convierte en una propiedad. Solo las entidades DWG TEXT y MTEXT se convierten en propiedades. Se omiten todas las propiedades.
featureClassPropertyName String VERDADERO Nombre de la propiedad de clase de característica, por ejemplo, spaceName o spaceUseType.

georeference

Propiedad Type Obligatorio Description
lat number VERDADERO Representación decimal de los grados de latitud en el origen del dibujo de la instalación. Las coordenadas de origen deben estar en el formato WGS84 Web Mercator (EPSG:3857).
lon number VERDADERO Representación decimal de los grados de longitud en el origen del dibujo de la instalación. Las coordenadas de origen deben estar en el formato WGS84 Web Mercator (EPSG:3857).
angle number VERDADERO Ángulo en el sentido de las agujas del reloj, en grados, entre el norte verdadero y el eje vertical (Y) del dibujo.

Manifiesto de paquete de dibujo de ejemplo

En el archivo JSON de este ejemplo se muestra el archivo de manifiesto del paquete de dibujos de ejemplo. Vaya al paquete de dibujos de muestra v2 de Azure Maps Creator en GitHub para descargar todo el paquete.

Archivo de manifiesto

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

Pasos siguientes

Para obtener una guía sobre cómo preparar tu paquete de dibujo, consulta la guía del paquete de dibujo.

Guía de paquetes de dibujos