A beltéri térképek létrehozója

Ez a cikk az Azure Térképek Creatorra vonatkozó fogalmakat és eszközöket ismerteti. Javasoljuk, hogy olvassa el ezt a cikket, mielőtt elkezdené használni az Azure Térképek Creator API-t és az SDK-t.

A Creator használatával olyan alkalmazásokat fejleszthet, amelyek a beltéri térképadatokon alapuló térképfunkciókkal rendelkeznek. Ez a cikk a térképadatok feltöltésének, átalakításának, létrehozásának és használatának folyamatát ismerteti. A munkafolyamatot általában két különböző, különböző szakértelemmel és felelősségi területtel rendelkező személy hajtja végre:

• Térképkészítő: a térképadatok kurálásáért és előkészítéséért felelős.
• Létrehozói leképezési adatfelhasználó: az ügyfelek térképadatait használja az alkalmazásokban.

Az alábbi ábra a teljes munkafolyamatot szemlélteti.

Azure Térképek Creator létrehozása

A Creator-szolgáltatások használatához létre kell hoznia egy Azure Térképek Creator-erőforrást, és hozzá kell társítania egy Azure Térképek-fiókot a Gen 2 tarifacsomaggal. Az Azure Térképek Creator-erőforrás Azure-beli létrehozásáról további információt az Azure Térképek Creator kezelése című témakörben talál.

Tipp.

A díjszabással kapcsolatos információkért tekintse meg az Azure Térképek díjszabásának Létrehozó szakaszát.

Létrehozó hitelesítése

A létrehozó örökli az Azure Térképek Hozzáférés-vezérlés (IAM) beállításait. Az adathozzáférésre vonatkozó összes API-hívást hitelesítési és engedélyezési szabályokkal kell elküldeni.

A létrehozó használati adatai belefoglalva lesznek az Azure Térképek használati diagramjaiba és tevékenységnaplójába. További információ: Hitelesítés kezelése az Azure Térképek-ban.

Fontos

A következőket javasoljuk:

• Microsoft Entra-azonosító minden olyan megoldásban, amely egy Azure-Térképek-fiókkal készült a Creator-szolgáltatások használatával. A Microsoft Entra-azonosítóval kapcsolatos további információkért lásd a Microsoft Entra-hitelesítést.

• Szerepköralapú hozzáférés-vezérlési beállítások. Ezen beállítások használatával a térképkészítők Azure Térképek adatszolgáltatói szerepkörként működhetnek, a létrehozói térképadatok felhasználói pedig Azure Térképek adatolvasói szerepkörként működhetnek. További információ: Engedélyezés szerepköralapú hozzáférés-vezérléssel.

Létrehozói adatelem-típusok

A létrehozói szolgáltatások különböző adattípusokat hoznak létre, tárolnak és használnak, amelyeket a következő szakaszok definiálnak és tárgyalnak. A létrehozó adatelem a következő típusú lehet:

• Konvertált adatok
• Adathalmaz
• Csempék
• style
• Térképkonfiguráció
• Funkcióállapot-halmaz
• Útvonalkészlet

Rajzcsomag feltöltése

A létrehozó egy feltöltött rajzcsomag konvertálásával gyűjti össze a beltéri térképadatokat. A rajzcsomag egy épített vagy átalakított létesítményt jelöl. A rajzcsomag követelményeiről további információt a Rajzcsomag követelményei című témakörben talál.

Kövesse az Adatregisztrációs adatbázis létrehozása című cikk lépéseit a rajzcsomag Azure-tárfiókba való feltöltéséhez, majd az Azure-Térképek-fiókban való regisztrálásához.

Fontos

Ügyeljen arra, hogy jegyezze fel az egyedi azonosító (udid) értékét, szüksége lesz rá. A udid feltöltött csomag beltéri térképadatokká alakításához szükséges.

Rajzcsomag konvertálása

A Konverziós szolgáltatás egy feltöltött rajzcsomagot beltéri térképadatokká alakít át. A Konverziós szolgáltatás a csomagot is ellenőrzi. Az érvényesítési problémák két típusba vannak besorolva:

• Hibák: Ha bármilyen hibát észlel, a konvertálási folyamat meghiúsul. Hiba esetén a Konverziós szolgáltatás egy hivatkozást biztosít az Azure Térképek Drawing Error Visualizer önálló webalkalmazásra. A Rajzhibák vizualizációja segítségével megvizsgálhatja a rajzcsomagokra vonatkozó figyelmeztetéseket és hibákat , amelyek a konvertálási folyamat során történtek. A hibák kijavítása után megpróbálhatja feltölteni és átalakítani a csomagot.
• Figyelmeztetések: Ha bármilyen figyelmeztetést észlel, az átalakítás sikeres lesz. Javasoljuk azonban, hogy tekintse át és oldja fel az összes figyelmeztetést. A figyelmeztetés azt jelenti, hogy az átalakítás egy része figyelmen kívül lett hagyva vagy automatikusan ki lett javítva. Ha nem sikerül megoldani a figyelmeztetéseket, az a későbbi folyamatok hibáit eredményezheti. További információ: Rajzcsomagra vonatkozó figyelmeztetések és hibák.

Beltéri térképadatok létrehozása

Az Azure Térképek Creator a következő szolgáltatásokat nyújtja, amelyek támogatják a térkép létrehozását:

• Adathalmaz-szolgáltatás.
• Tileset szolgáltatás. A Tileset szolgáltatással vektoralapú adathalmaz-ábrázolás hozható létre. Az alkalmazások csempékkel jeleníthetik meg az adathalmaz vizuális csempealapú nézetét.
• Egyéni stílusszolgáltatás. A stílusszolgáltatás vagy a vizuális stílusszerkesztő használatával testre szabhatja egy beltéri térkép vizuális elemeit.
• Szolgáltatásállapot-szolgáltatás. A Funkcióállapot szolgáltatással támogatja a dinamikus térképformázást. Az alkalmazások dinamikus térképformázással valós idejű eseményeket tükrözhetnek az IoT-rendszer által biztosított helyeken.
• Wayfinding szolgáltatás. A wayfinding API használatával hozzon létre egy útvonalat egy létesítmény két pontja között. A routeset API használatával hozza létre azokat az adatokat, amelyeket a wayfinding szolgáltatásnak elérési utak létrehozásához kell létrehoznia.

Adathalmazok

Az adatkészletek beltéri térképfunkciók gyűjteményei. A beltéri térkép funkciói egy átalakított rajzcsomagban definiált létesítményeket jelölnek. Miután létrehozott egy adathalmazt az Adathalmaz szolgáltatással, tetszőleges számú csempét vagy szolgáltatásállapot-készletet hozhat létre.

A fejlesztők az Adathalmaz szolgáltatással bármikor hozzáadhatnak vagy eltávolíthatnak létesítményeket egy meglévő adathalmazhoz. A meglévő adathalmaz API-val való frissítéséről további információt az Adathalmaz szolgáltatás hozzáfűzési beállításaiban talál. Az adatkészletek frissítésére vonatkozó példa: Adatkarbantartás.

Csempék

A csempék olyan vektoradatok gyűjteményei, amelyek egységes rácscsempék készletét jelölik. A fejlesztők a Tileset szolgáltatással hozhatnak létre csempéket egy adatkészletből.

A különböző tartalomszakaszok tükrözése érdekében több csempekészletet is létrehozhat ugyanabból az adatkészletből. Létrehozhat például egy csempét bútorokkal és berendezésekkel, egy másik csempét pedig bútor és berendezés nélkül. Dönthet úgy, hogy létrehoz egy csempét a legújabb adatfrissítésekkel, egy másik csempét pedig a legújabb adatfrissítések nélkül.

A vektoradatok mellett a csempekészlet metaadatokat is biztosít a leképezési renderelés optimalizálásához. A csempék metaadatai például a csempékhalmaz minimális és maximális nagyítási szintjét tartalmazzák. A metaadatok egy határolókeretet is biztosítanak, amely meghatározza a csempekészlet földrajzi kiterjedését. Az alkalmazások egy határolókerettel programozott módon állíthatják be a megfelelő középpontot. A csempekészlet metaadataival kapcsolatos további információkért tekintse meg a Csempék listája című témakört.

A csempék létrehozása után a rendszer lekéri a Render szolgáltatással.

Ha egy csempekészlet elavulttá válik, és már nem hasznos, törölheti a csempéket. A csempék törléséről további információt az Adatkarbantartás című témakörben talál.

Megjegyzés:

A csempék függetlenek attól az adatkészlettől, amelyből létrehozták. Ha egy adatkészletből hoz létre csempéket, majd később frissíti az adathalmazt, a csempekészletek nem frissülnek.

Az adathalmaz változásainak tükrözéséhez új csempéket kell létrehoznia. Hasonlóképpen, ha töröl egy csempét, az adathalmazra nincs hatással.

Egyéni stílus (előzetes verzió)

A stílus határozza meg a térkép vizuális megjelenését. Meghatározza a rajzolni kívánt adatokat, a rajzolás sorrendjét és az adatok stílusát a rajzoláskor. Az Azure Térképek Alkotói stílusok támogatják a MapLibre szabványt a stílusrétegekhez és a spritesekhez.

Ha egy rajzcsomagot az Azure Térképek-fiókjába való feltöltés után konvertál, a rendszer az alapértelmezett stílusokat alkalmazza a térkép elemeire. Az egyéni stílusszolgáltatással testre szabhatja a térkép vizuális megjelenését. Ezt úgy teheti meg, hogy manuálisan szerkeszti a JSON stílust, és importálja azt az Azure Térképek-fiókjába a Stílus – HTTP-kérés használatával, de az ajánlott módszer a vizuális stílusszerkesztő használata. További információ: Egyéni stílusok létrehozása beltéri térképekhez.

Példaréteg a style.json fájlban:

{
	"id": "indoor_unit_gym_label",
	"type": "symbol",
	"filter": ["all", ["has","floor0"], ["any", ["==", "categoryName", "room.gym"]]],
	"layout": {
		"visibility": "none",
		"icon-image": "gym",
		"icon-size": {"stops": [[17.5, 0.7], [21, 1.1]]},
		"symbol-avoid-edges": true,
		"symbol-placement": "point",
		"text-anchor": "top",
		"text-field": "{name}",
		"text-font": ["SegoeFrutigerHelveticaMYingHei-Medium"],
		"text-keep-upright": true,
		"text-letter-spacing": 0.1,
		"text-offset": [0, 1.05],
		"text-size": {"stops": [[18, 5], [18.5, 6.5], [19, 8], [19.5, 9.5], [20, 11]]}
	},
	"metadata": {"microsoft.maps:layerGroup": "labels_indoor"},
	"minzoom": 17.5,
	"paint": {
		"text-color": "rgba(0, 0, 0, 1)",
		"text-halo-blur": 0.5,
		"text-halo-color": "rgba(255, 255, 255, 1)",
		"text-halo-width": 1,
		"text-opacity": ["step", ["zoom"], 0, 18, 1]
	},
	"source-layer": "Indoor unit"
},

Rétegtulajdonságok	Leírás
id	A réteg neve
típus	A réteg renderelési típusa. A leggyakoribb típusok közé tartoznak a következők: kitöltés: Egy kitöltött sokszög, amely nem kötelezően simított szegéllyel rendelkezik. Vonal: Egy tollas vonal. Szimbólum: Ikon vagy szövegfelirat. fill-extrusion: Egy extrudált (3D) sokszög.
szűrő	Csak a szűrési feltételeknek megfelelő funkciók jelennek meg.
elrendezés	A réteg elrendezési tulajdonságai.
minzoom	0 és 24 közötti szám, amely a réteg minimális nagyítási szintjét jelöli. A minzoomnál kisebb nagyítási szinteken a réteg rejtett.
Festék	A réteg alapértelmezett festéktulajdonságai.
forrásréteg	Egy forrás egy vektorcsempe-forrásból látja el az adatokat egy térképen. Vektorcsempe-forrásokhoz szükséges; minden más forrástípusra, beleértve a GeoJSON-forrásokat is.

Térképkonfiguráció

A térképkonfiguráció konfigurációk tömbje. Minden konfiguráció egy alaptérképből és egy vagy több rétegből áll, mindegyik réteg stíluscsempékből + áll.

A térképkonfigurációt akkor használja a rendszer, ha az Azure Térképek-alkalmazások fejlesztésekor példányosít egy térképobjektum Beltéri kezelőjét. A hivatkozás a mapConfigurationId következő használatával történik: vagy alias. A térképkonfigurációk nem módosíthatók. Meglévő térképkonfiguráció módosításakor egy új térképkonfiguráció jön létre, amely egy másikat mapConfingurationIderedményez. Amikor egy meglévő térképkonfiguráció által már használt alias használatával hoz létre térképkonfigurációt, az új térképkonfigurációra mutat.

Az alábbi JSON egy alapértelmezett térképkonfiguráció példája. A fájl egyes elemeinek leírását az alábbi táblázatban talál:

{
    "version": 1.0,
    "description": "This is the default Azure Maps map configuration for facility ontology tilesets.",
    "defaultConfiguration": "indoor_light",
    "configurations": [
        {
            "name": "indoor_light",
            "displayName": "Indoor light",
            "description": "A base style for Azure Maps.",
            "thumbnail": "indoor_2022-01-01.png",
            "baseMap": "microsoft_light",
            "layers": [
                {
                    "tilesetId": "fa37d225-924e-3f32-8441-6128d9e5519a",
                    "styleId": "microsoft-maps:indoor_2022-01-01"
                }
            ]
        },
        {
            "name": "indoor_dark",
            "displayName": "Indoor dark",
            "description": "A base style for Azure Maps.",
            "thumbnail": "indoor_dark_2022-01-01.png",
            "baseMap": "microsoft_dark",
            "layers": [
                {
                    "tilesetId": "fa37d225-924e-3f32-8441-6128d9e5519a",
                    "styleId": "microsoft-maps:indoor_dark_2022-01-01"
                }
            ]
        }
    ]
}

Stílusobjektum tulajdonságai	Leírás
Név	A stílus neve.
displayName	A stílus megjelenítendő neve.
leírás	A stílus felhasználó által definiált leírása.
miniatűr	Itt adhatja meg a stílusválasztóban használt miniatűrt. További információt a stílusválasztó vezérlőben talál.
alaptérkép	Az alaptérkép stílusának beállítása.
Rétegek	A rétegek tömbje egy vagy több csempekészletből és stíluscsuplából áll, és mindegyik a térkép egy rétege. Ez lehetővé teszi, hogy több épület is szerepel a térképen, és mindegyik épület a saját csempéiben jelenik meg.

További információk

• További információ a stílusok stílusszerkesztővel történő módosításáról: Egyéni stílusok létrehozása beltéri térképekhez.
• A Rest API stílusáról további információt a Térképek Creator Rest API-referencia stílusában talál.
• A rest API térképkonfigurációjáról további információt a Creator – map configuration Rest API című témakörben talál.

Funkcióállapot-halmazok

A funkcióállapotkészletek olyan dinamikus tulajdonságok (állapotok) gyűjteményei, amelyek adathalmaz-funkciókhoz, például helyiségekhez vagy berendezésekhez vannak rendelve. Az állapotra példa lehet a hőmérséklet vagy a kihasználtság. Minden állapot egy kulcs/érték pár, amely tartalmazza a tulajdonság nevét, az értéket és az utolsó frissítés időbélyegét.

A Szolgáltatásállapot szolgáltatással létrehozhat és kezelhet egy adathalmazhoz tartozó szolgáltatásállapot-halmazt. Az állapothalmazt egy vagy több állam határozza meg. Minden funkcióhoz, például egy helyiséghez egy állapot is csatolható.

Az állapothalmazok egyes állapotainak értékét IoT-eszközök vagy más alkalmazások frissítik vagy kérik le. A Feature State Update API használatával például a helyfoglalatot mérő eszközök szisztematikusan közzétehetik a helyiség állapotváltozását.

Az alkalmazások egy funkcióállapot-készlet használatával dinamikusan renderelhetik egy létesítmény funkcióit az aktuális állapotuknak és a megfelelő térképstílusnak megfelelően. A funkcióállapot-készletekkel a renderelési térkép funkcióinak stílusával kapcsolatos további információkért tekintse meg a Beltéri Térképek modult.

Megjegyzés:

A csempékhez hasonlóan az adathalmaz módosítása nem befolyásolja a meglévő funkcióállapotkészletet, és a funkcióállapot-halmaz törlése nem befolyásolja azt az adatkészletet, amelyhez csatolva van.

Wayfinding (előzetes verzió)

A Wayfinding szolgáltatás lehetővé teszi, hogy ügyfelei számára a lehető legrövidebb utat biztosítsa egy létesítmény két pontja között. Miután importálta a beltéri térképadatokat, és létrehozta az adathalmazt, ezzel létrehozhat egy útvonalkészletet. Az útvonalkészlet biztosítja a két pont közötti útvonalak létrehozásához szükséges adatokat. A wayfinding szolgáltatás figyelembe veszi például a nyílások minimális szélességét, és opcionálisan kizárhatja a lifteket vagy a lépcsőket a szintek közötti navigálás során.

A létrehozói útdefiniálást a Havok működteti.

Útdefiniálási útvonalak

Ha a wayfinding elérési út sikeresen létre van hozva, a megadott létesítmény két pontja közötti legrövidebb útvonalat találja meg. Az utazás minden emelete külön lábként jelenik meg, ahogy a padlók közötti mozgáshoz használt lépcsők vagy liftek is.

Az útvonal első szakasza lehet például a forrástól a liftig az adott emeleten. A következő láb a lift, majd az utolsó láb a lifttől a célig vezető út. A becsült utazási idő kiszámítása és visszaadása a HTTP-válasz JSON-jában is történik.

Struktúra

A munkavégzéshez a létesítmény adatainak struktúrát kell tartalmazniuk. A wayfinding szolgáltatás kiszámítja a legrövidebb útvonalat egy létesítmény két kiválasztott pontja között. A szolgáltatás úgy hozza létre az útvonalat, hogy körüljárja a struktúrákat, például a falakat és az egyéb áthatolhatatlan struktúrákat.

Függőleges behatolás

Ha a kiválasztott forrás és cél különböző szinteken található, a wayfinding szolgáltatás határozza meg, hogy milyen függőleges objektumok , például lépcsők vagy liftek érhetők el a szintek közötti függőleges navigáláshoz. Alapértelmezés szerint a legrövidebb elérési utat eredményező beállítást használja a rendszer.

A Wayfinding szolgáltatás lépcsőket vagy lifteket tartalmaz egy útvonalon a függőleges behatolás direction tulajdonságának értéke alapján. További információ az iránytulajdonságról: verticalPenetration in the Facility Ontology article. Tekintse meg a avoidFeatures wayfinding API dokumentációjának tulajdonságait és minWidth tulajdonságait, és ismerje meg azokat a tényezőket, amelyek befolyásolhatják a padlószintek közötti útvonalválasztást.

További információ: Indoor Maps wayfinding service how-to article.

Beltéri térképek használata

Renderelés – Térképcsempe API lekérése

Az Azure Térképek [Render – Térképcsempe lekérése] API-t kiterjesztették a létrehozói csempék támogatására.

Az alkalmazások használhatják a Render – Térkép csempe API-t a csempék igényléséhez. A csempék ezután integrálhatók térképvezérlőbe vagy SDK-ba. A Render szolgáltatást használó térképvezérlőkre példa: Beltéri Térképek modul.

Webszolgáltatás API

A webszolgáltatással (WFS) adathalmazokat kérdezhet le. A WFS az Open Geospatial Consortium API-funkciókat követi. A WFS API-val lekérdezheti az adathalmaz funkcióit. A WFS használatával például megkeresheti egy adott létesítmény és padlószint összes közepes méretű tárgyalóját.

Alias API

Az olyan létrehozói szolgáltatások, mint a Konverzió, az Adatkészlet, a Csempék és a Szolgáltatásállapot, az API-kból létrehozott minden erőforráshoz egy azonosítót ad vissza. Az Alias API lehetővé teszi egy alias hozzárendelését egy erőforrás-azonosítóra való hivatkozáshoz.

Beltéri térképek modul

Az Azure Térképek Web SDK tartalmazza a Beltéri Térképek modult. Ez a modul kiterjesztett funkciókat kínál az Azure Térképek Térképvezérlési kódtárhoz. A Beltéri Térképek modul a Creatorban létrehozott beltéri térképeket jeleníti meg. Olyan widgeteket integrál, mint a padlóválasztó , amely segít a felhasználóknak a különböző padlók vizualizációjában.

A Beltéri Térképek modullal olyan webalkalmazásokat hozhat létre, amelyek beltéri térképadatokat integrálnak más Azure Térképek-szolgáltatásokkal. A leggyakoribb alkalmazásbeállítások közé tartozik, hogy más térképekről – például az útról, a képekről, az időjárásról és az átvitelről – származó ismereteket adja hozzá a beltéri térképekhez.

A Beltéri Térképek modul a dinamikus térképformázást is támogatja. A funkcióállapot-halmaz dinamikus stílusának alkalmazásbeli implementálásához részletes útmutatót a Beltéri térkép modul használata című témakörben talál.

Azure Térképek integrációja

Amikor megkezdi a beltéri térképek megoldásainak fejlesztését, felfedezheti a meglévő Azure Térképek képességek integrálásának módjait. Például eszközkövetési vagy biztonsági forgatókönyveket valósíthat meg a Geofence szolgáltatás és a Creator beltéri térképek használatával. A Geofence API használatával például meghatározhatja, hogy egy feldolgozó belép-e vagy elhagy bizonyos beltéri területeket. Az Azure Térképek IoT-telemetriával való összekapcsolásával kapcsolatos további információkért lásd: Oktatóanyag: IoT térbeli elemzés implementálása az Azure Térképek használatával.

Adatkarbantartás

Az Azure Térképek Creator List, Update és Delete API használatával listázhatja, frissítheti és törölheti adathalmazait, csempéit és szolgáltatásállapot-készleteit.

Megjegyzés:

Amikor áttekinti az elemek listáját annak megállapításához, hogy törli-e őket, fontolja meg a törlés hatását az összes függő API-ra vagy alkalmazásra. Ha például töröl egy olyan csempét, amelyet egy alkalmazás a [Render – Get Map Tile] API használatával használ, az alkalmazás nem tudja megjeleníteni a csempéket.

Példa: Adatkészlet frissítése

Az alábbi példa bemutatja, hogyan frissíthet egy adatkészletet, hozhat létre új csempéket, és törölheti a régi csempéket:

1. Kövesse a Rajzcsomag feltöltése és a Rajzcsomag szakaszainak konvertálása az új rajzcsomag feltöltéséhez és átalakításához című szakasz lépéseit.
2. Az Adathalmaz létrehozása használatával fűzze hozzá a konvertált adatokat a meglévő adatkészlethez.
3. A Tileset Create használatával új csempekészletet hozhat létre a frissített adatkészletből.
4. Mentse az új tilesetId azonosítót a következő lépéshez.
5. A frissített campus-adatkészlet vizualizációjának engedélyezéséhez frissítse a csempekészlet azonosítóját az alkalmazásban. Ha a régi csempekészlet már nincs használatban, törölheti.

További lépések

Oktatóanyag: Alkotó beltéri térképének létrehozása