Rajzolási csomag követelményei

A feltöltött rajzcsomagokat térképadatokká alakíthatja az Azure Maps Konverziós szolgáltatással. Ez a cikk a Conversion API rajzcsomag-követelményeit ismerteti. A mintacsomag megtekintéséhez letöltheti a minta rajzcsomagot.

Előfeltételek

A rajzcsomag DWG formátumban mentett rajzokat tartalmaz, amely az Autodesk AutoCAD-szoftverének® natív fájlformátuma.

Bármelyik CAD-szoftvert kiválaszthatja a rajzcsomagban lévő rajzok létrehozásához.

A Konvertálási szolgáltatás térképadatokká alakítja a rajzcsomagot. A konvertálási szolgáltatás az AutoCAD DWG fájlformátummal AC1032működik.

Szószedet

Az egyszerű hivatkozás érdekében íme néhány kifejezés és definíció, amelyek fontosak a cikk elolvasásához.

Rajzcsomag felépítése

A rajzcsomag egy .zip archívum, amely a következő fájlokat tartalmazza:

• DWG-fájlok AutoCAD DWG fájlformátumban.
• A rajzcsomag DWG-fájljait leíró manifest.json fájl.

A rajzcsomagot egyetlen archív fájlba kell tömöríteni, a .zip kiterjesztéssel. A DWG-fájlok bármilyen módon rendszerezhetők a csomagon belül, de a jegyzékfájlnak a tömörített csomag gyökérkönyvtárában kell lennie. A következő szakaszok részletesen ismertetik a DWG-fájlokra, a jegyzékfájlra és a fájlok tartalmára vonatkozó követelményeket. A mintacsomag megtekintéséhez letöltheti a mintarajzcsomagot.

DWG-fájlkonvertálási folyamat

A konvertálási szolgáltatás minden DWG-fájlon a következőket hajtja végre:

• Kinyeri a funkcióosztályokat:
  • Szintek
  • Egység
  • Zóna
  • Nyílások
  • Falak
  • Függőleges behatolások
• Létrehoz egy létesítményfunkciót.
• A többi szolgáltatás által hivatkozott alapértelmezett kategóriafunkciók minimális készletét hozza létre:
  • szoba
  • szerkezet
  • fal
  • nyitás.ajtó
  • zóna
  • Létesítmény

DWG-fájlkövetelmények

A létesítmény minden szintjén egyetlen DWG-fájl szükséges. Az egyetlen szintű adatoknak egyetlen DWG-fájlban kell lenniük. Minden külső hivatkozást (xrefs) a szülőrajzhoz kell kötni. Egy háromszintű létesítményben például három DWG-fájl található a rajzcsomagban.

Minden DWG-fájlnak meg kell felelnie a következő követelményeknek:

• A DWG-fájlnak meg kell határoznia a külső és egységrétegeket. Opcionálisan a következő rétegeket definiálhatja: Wall, Door, UnitLabel, Zone és ZoneLabel.
• A DWG-fájl nem tartalmazhat több szint szolgáltatásait.
• A DWG-fájl nem tartalmazhat több létesítmény szolgáltatásait.
• A DWG-nek ugyanarra a mérési rendszerre és mértékegységre kell hivatkoznia, mint a rajzcsomag többi DWG-fájljának.

DWG-rétegkövetelmények

Minden DWG-rétegnek be kell tartania a következő szabályokat:

• A rétegnek kizárólag egyetlen osztály funkcióit kell tartalmaznia. Az egységek és falak például nem lehetnek ugyanabban a rétegben.
• A funkciók egyetlen osztályát több réteg is képviselheti.
• Az önműködő sokszögek engedélyezettek, de automatikusan javíthatók. A javításuk után a konverziós szolgáltatás figyelmeztetést ad. Célszerű manuálisan megvizsgálni a javított eredményeket, mert előfordulhat, hogy nem felelnek meg a várt eredményeknek.
• Minden réteg rendelkezik az entitástípusok támogatott listájával. A réteg többi entitástípusa figyelmen kívül lesz hagyva. A szöveges entitások például nem támogatottak a falrétegen.

Az alábbi táblázat az egyes rétegek támogatott entitástípusait és konvertált leképezési funkcióit ismerteti. Ha egy réteg nem támogatott entitástípusokat tartalmaz, akkor a Konverziós szolgáltatás figyelmen kívül hagyja ezeket az entitásokat.

A következő szakaszok az egyes rétegek követelményeit ismertetik.

Külső réteg

Az egyes szintek DWG-fájljának tartalmaznia kell egy réteget az adott szint szegélyének meghatározásához. Ezt a réteget külső rétegnek nevezzük. Ha például egy létesítmény két szintet tartalmaz, akkor két DWG-fájllal kell rendelkeznie, mindegyik fájlhoz egy külső réteggel.

Függetlenül attól, hogy hány entitásrajz található a külső rétegben, az eredményként kapott létesítményadatkészlet csak egy szintű funkciót tartalmaz minden egyes DWG-fájlhoz. Továbbá:

• A külsőket poligon, POLILINE (zárt), CIRCLE vagy ELLIPSE (zárt) elemként kell rajzolni.
• A külsők átfedésben lehetnek, de egy geometriába vannak feloldva.
• Az eredményként kapott szintnek legalább 4 négyzetméternek kell lennie.
• Az eredményként kapott szintfunkció nem lehet nagyobb 400 000 négyzetméternél.

Ha a réteg több egymást átfedő vonalláncot tartalmaz, azok egyetlen szintbeli funkcióvá lesznek feloldva. Ehelyett, ha a réteg több nem egymást átfedő vonalláncot tartalmaz, az eredményként kapott Szint funkció több-sokszögű ábrázolással rendelkezik.

A külső rétegre a mintarajzcsomag vázlatrétegeként láthat példát.

Egységréteg

Az egyes szintek DWG-fájlja egységeket tartalmazó réteget határoz meg. Az egységek hajózható terek az épületben, például irodák, folyosók, lépcsők és liftek. Ha a VerticalPenetrationCategory tulajdonság meg van határozva, a több szintet ( például lifteket és lépcsőket) felölelő navigálási egységek függőleges behatolási funkciókká alakulnak. Az egymást átfedő függőleges behatolási funkciók egyhez setidvannak rendelve.

Az Egységek rétegnek meg kell felelnie a következő követelményeknek:

• Az egységeket POLIGON, POLILINE (zárt), CIRCLE vagy ELLIPSE (zárt) néven kell rajzolni.
• Az egységeknek a létesítmény külső szegélyhálózatán belül kell lenniük.
• Az egységek nem lehetnek részlegesen átfedésben.
• Az egységek nem tartalmazhatnak önműködő geometriát.

Adjon nevet egy egységnek úgy, hogy létrehoz egy szöveges objektumot a UnitLabel rétegben, majd az objektumot az egység határán belülre helyezi. További információ: UnitLabel réteg.

A minta rajzcsomagban látható egy példa az Egységek rétegre.

Falréteg

Az egyes szintek DWG-fájlja tartalmazhat olyan réteget, amely meghatározza a falak, oszlopok és egyéb épületszerkezetek fizikai kiterjedéseit.

• A falakat POLIGON, POLILINE (zárt), KÖR vagy ELLIPSZIS (zárt) elemként kell rajzolni.
• A falrétegnek vagy rétegeknek csak épületszerkezetként értelmezett geometriát kell tartalmazniuk.

A minta rajzcsomagban látható a Falak réteg egy példája.

Ajtóréteg

Az ajtókat tartalmazó DWG-réteget is belefoglalhatja. Minden ajtónak át kell fednie egy egység szélét az egységrétegből.

Az Azure Maps-adathalmaz ajtónyílásai egysoros szegmensként jelennek meg, amely több egységhatárt fed át. Az alábbi képek bemutatják, hogyan alakítja át az Azure Maps az ajtóréteg geometriát adathalmaz nyitó funkcióivá.

Zónaréteg

Az egyes szintek DWG-fájlja tartalmazhat egy zónaréteget, amely meghatározza a zónák fizikai kiterjedéseit. A zóna egy nem navigálásra alkalmas terület, amely elnevezhető és megjeleníthető. A zónák több szintre is kiterjedhetnek, és a zoneSetId tulajdonság használatával csoportosíthatók.

• A zónákat POLIGON, POLYLINE (zárt) vagy ELLIPSE (zárt) elemként kell rajzolni.
• A zónák átfedésben lehetnek.
• A zónák a létesítmény külső szegélyén belülre vagy kívül eshetnek.

Nevezze el a zónát úgy, hogy létrehoz egy szöveges objektumot a ZoneLabel rétegben, és a szövegobjektumot a zóna határai között helyezi el. További információ: ZoneLabel-réteg.

A mintarajzcsomagban látható egy példa a zónarétegre.

UnitLabel-réteg

Az egyes szintekhez tartozó DWG-fájl egy UnitLabel-réteget tartalmazhat. A UnitLabel-réteg hozzáad egy névtulajdonságot az egységrétegből kinyert egységekhez. A névtulajdonságú egységek további részleteket is megadhatnak a jegyzékfájlban.

• Az egységcímkéknek egysoros szöveges entitásoknak kell lenniük.
• Az egységcímkéknek teljesen az egységük határán belül kell lenniük.
• Az egységek nem tartalmazhatnak több szöveges entitást a UnitLabel-rétegben.

A mintarajzcsomagban egy példa látható a UnitLabel-rétegre.

ZoneLabel-réteg

Az egyes szintekhez tartozó DWG-fájl tartalmazhat Egy ZoneLabel-réteget. Ez a réteg hozzáad egy névtulajdonságot a zónarétegből kinyert zónákhoz. A névtulajdonságú zónák további részleteket is megadhatnak a jegyzékfájlban.

• A zónák címkéinek egysoros szöveges entitásoknak kell lenniük.
• A zónák címkéinek a zónájuk határán belülre kell esniük.
• A zónák nem tartalmazhatnak több szöveges entitást a ZoneLabel-rétegben.

A mintarajzcsomagban egy példa látható a ZoneLabel-rétegre.

Jegyzékfájlra vonatkozó követelmények

A zip mappának tartalmaznia kell egy jegyzékfájlt a könyvtár gyökérszintjén, és a fájlt el kell nevezni manifest.json. Ismerteti a DWG-fájlokat, amelyek lehetővé teszik a konverziós szolgáltatás számára a tartalom elemzését. Csak a jegyzékben azonosított fájlok kerülnek betöltésre. A zip mappában lévő, de a jegyzékben nem megfelelően felsorolt fájlok figyelmen kívül lesznek hagyva.

Bár a jegyzékobjektumok használatakor vannak követelmények, nem minden objektumra van szükség. Az alábbi táblázat a Konvertálási szolgáltatás 1.1-es verziójához szükséges és nem kötelező objektumokat mutatja be.

A következő szakaszok részletesen ismertetik az egyes objektumok követelményeit.

directoryInfo

buildingLevels

Az buildingLevels objektum épületszintek JSON-tömbjét tartalmazza.

georeference

dwgLayers

unitProperties

Az unitProperties objektum egységtulajdonságokat tartalmazó JSON-tömböt tartalmaz.

zoneProperties

Az zoneProperties objektum zónatulajdonságokat tartalmazó JSON-tömböt tartalmaz.

Minta rajzcsomag jegyzékfájlja

Az alábbiakban a mintarajzcsomag jegyzékfájlja látható. A teljes csomag letöltéséhez nyissa meg az Azure Maps Creator mintarajzcsomagot a GitHubon.

Jegyzékfájl

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

A feltöltött rajzcsomagokat térképadatokká alakíthatja az Azure Maps Konverziós szolgáltatással. Ez a cikk a Conversion API rajzcsomag-követelményeit ismerteti. A mintacsomag megtekintéséhez letöltheti a minta rajzcsomag v2-t.

A rajzcsomag előkészítésével kapcsolatos útmutatót a Rajzcsomag útmutatójában találja.

Módosítások és változatok

• A felhasználó által definiált szolgáltatásosztályok támogatása hozzáadva.
• A DWG-rétegek egyszerűsített követelményei.

Előfeltételek

A rajzcsomag DWG formátumban mentett rajzokat tartalmaz, amely az Autodesk AutoCAD-szoftverének® natív fájlformátuma.

Bármelyik CAD-szoftvert kiválaszthatja a rajzcsomagban lévő rajzok létrehozásához.

A Konvertálási szolgáltatás térképadatokká alakítja a rajzcsomagot. A konvertálási szolgáltatás az AutoCAD DWG AC1032 fájlformátummal működik.

Szószedet

Az egyszerű hivatkozás érdekében íme néhány kifejezés és definíció, amelyek fontosak a cikk elolvasásához.

Rajzcsomag felépítése

A rajzcsomagok a következő fájlokat tartalmazó ZIP-archívumok:

• DWG-fájlok AutoCAD DWG fájlformátumban.
• A rajzcsomag DWG-fájljait leíró manifest.json fájl.

A rajzcsomagot egyetlen archív fájlba kell tömöríteni, a .zip kiterjesztéssel. A DWG-fájlok bármilyen módon rendszerezhetők a rajzcsomagon belül, de a jegyzékfájlnak a gyökérkönyvtárban kell lennie. A következő szakaszok a DWG- és jegyzékfájlok konvertálási folyamatát és követelményeit, valamint a fájlok tartalmát ismertetik. A mintacsomag megtekintéséhez letöltheti a minta rajzcsomag v2-t.

DWG-fájlkonvertálási folyamat

Az Azure Maps Konverziós szolgáltatás átalakítja egy létesítmény DWG-fájljait egy létesítmény adatait és funkcióit ábrázoló adatok leképezéséhez.

Az Azure Maps Konverziós szolgáltatás a következőket hozza létre:

• Létesítményfunkció: A létesítmény legfelső szintű funkciója, amelyhez egy létesítmény minden szintje társítva van.
• Szintfunkciók: Egy szint funkció jön létre a létesítmény minden egyes emeletéhez. A szint összes funkciója egy szinthez van társítva.
• Felhasználó által definiált szolgáltatások: A DWG-rétegek egy felhasználó által meghatározott szolgáltatásosztályhoz vannak leképezve, és a szolgáltatásosztály példányaivá válnak.

DWG-fájlkövetelmények

Minden DWG-fájlnak meg kell felelnie az alábbi követelményeknek:

• A DWG-fájl nem tartalmazhat több létesítmény szolgáltatásait.
• A DWG-fájl nem tartalmazhat több szint szolgáltatásait. Egy háromszintű létesítményben például három DWG-fájl található a rajzcsomagban.
• Az egyetlen szintű adatoknak egyetlen DWG-fájlban kell lenniük. Minden külső hivatkozást (xrefs) a szülőrajzhoz kell kötni.
• A DWG-fájlnak meg kell határoznia az adott szint határát képviselő réteg(ek)et.
• A DWG-nek ugyanarra a mérési rendszerre és mértékegységre kell hivatkoznia, mint a rajzcsomag többi DWG-fájljának.
• A DWG-fájlt úgy kell egymáshoz igazítani, hogy ugyanazon létesítmény egy másik szintjén halmozva legyenek.

DWG-rétegkövetelmények

Szolgáltatásosztályok

Egy vagy több DWG-réteg leképezhető egy felhasználó által definiált szolgáltatásosztályra. A szolgáltatás egy példánya a megfeleltetett réteg egy entitásából jön létre. A DWG-rétegek széke, asztala és kanapéja például egy bútornak nevezett funkcióosztályra van leképezve. A rendszer minden entitáshoz létrehoz egy bútorfunkciót a meghatározott rétegekből. Továbbá:

• Minden réteget el kell különíteni, hogy a létesítmény különböző funkciótípusait képviselje.
• Minden entitásnak a szint kerületének határain belülre kell esnie.
• Támogatott AutoCAD-entitástípusok: TEXT, MTEXT, POINT, ARC, CIRCLE, LINE, POLYLINE, ELLIPSE.

Szolgáltatásosztály tulajdonságai

A zárt alakzatok határán belül eső szöveges entitások tulajdonságként társíthatók ehhez a funkcióhoz. Egy helyiségfunkciós osztály például tartalmazhat olyan szöveget, amely leírja a helyiség nevét, egy másik pedig a szobatípus minta rajzcsomagját 2. Továbbá:

• Tulajdonságként csak TEXT és MTEXT entitások vannak társítva a szolgáltatáshoz. A rendszer figyelmen kívül hagyja az összes többi entitástípust.
• A SZÖVEG és az MTEXT igazítási pontnak a zárt alakzat határán belülre kell esnie.
• Ha egynél több TEXT tulajdonság van a zárt alakzat határán belül, és mindkettő egy tulajdonsághoz van megfeleltetve, akkor a rendszer véletlenszerűen kijelöl egy tulajdonságot.

Létesítmény szintje

Az egyes szintek DWG-fájljának tartalmaznia kell egy réteget az adott szint szegélyének meghatározásához. Ha például egy létesítmény két szintet tartalmaz, akkor két DWG-fájllal kell rendelkeznie, amelyek mindegyike rendelkezik egy olyan réteggel, amely meghatározza az adott szint szegélyhálózatát.

Függetlenül attól, hogy hány entitásrajz található a szint peremrétegében, az eredményként kapott létesítményadatkészlet csak egy szintű funkciót tartalmaz minden DWG-fájlhoz. Továbbá:

• A szint kerületeit POLIGON, POLYLINE (zárt), CIRCLE vagy ELLIPSE (zárt) értékként kell rajzolni.
• A szint kerületei átfedésben lehetnek, de egy geometriába vannak feloldva.
• Az eredményként kapott szintnek legalább 4 négyzetméternek kell lennie.
• Az eredményként kapott szintfunkció nem lehet nagyobb 400 000 négyzetméternél.

Ha a réteg több egymást átfedő POLILINE-t tartalmaz, azokat egyetlen szintbeli funkcióba egyesítjük. Ehelyett, ha a réteg több nem összecsukható POLILINE-t tartalmaz, az eredményül kapott Szint funkció több-sokszögű ábrázolással rendelkezik.

A 2- es minta rajzcsomag rétegeként GROS$ láthat egy példát a Szint szegélyrétegre.

Jegyzékfájlra vonatkozó követelmények

A rajzcsomagnak tartalmaznia kell egy jegyzékfájlt a gyökérszinten, a fájlt pedig el kell nevezni manifest.json. Ismerteti a DWG-fájlokat, amelyek lehetővé teszik a konverziós szolgáltatás számára a tartalom elemzését. A rendszer csak a jegyzékben azonosított fájlokat használja. A rendszer figyelmen kívül hagyja a rajzcsomagban lévő, de a jegyzékben nem megfelelően felsorolt fájlokat.

A jegyzékfájl buildingLevels objektumában lévő fájl elérési útjainak a rajzcsomag gyökeréhez képest kell lenniük. A DWG-fájlnévnek pontosan meg kell egyeznie a létesítményszint nevével. A "Pince" szint DWG-fájlja például Basement.dwg. A 2 . szintű DWG-fájl neve level_2.dwg. A fájlnevek nem tartalmazhatnak szóközöket, a szóközöket aláhúzás használatával helyettesítheti.

Bár a jegyzékobjektumok használatakor vannak követelmények, nem minden objektumra van szükség. Az alábbi táblázat a 2023-03-01 előzetes verziójú konverziós szolgáltatáshoz szükséges és opcionális objektumokat mutatja be.

Jegyzék JSON-fájl

A következő szakaszok részletesen ismertetik az egyes objektumok követelményeit.

buildingLevels

szint

featureClass

featureClassProperty

georeferencia

Minta rajzcsomag jegyzékfájlja

A példában szereplő JSON a minta rajzcsomag jegyzékfájlja. A teljes csomag letöltéséhez nyissa meg az Azure Maps Creator v2-hez készült mintacsomagot a GitHubon.

Jegyzékfájl

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