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

Feljegyzés

Az Azure Maps Creator kivonása

Az Azure Maps Creator beltéri térképszolgáltatása elavult, és 25.09.30-án megszűnik. További információkért lásd az Azure Maps Creator élettartamának megszűnését ismertető közleményét.

Ez a cikk az Azure Maps Creatorra vonatkozó fogalmakat és eszközöket ismerteti. Javasoljuk, hogy olvassa el ezt a cikket, mielőtt elkezdené használni az Azure Maps 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 Maps Creator létrehozása

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

Tipp.

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

Létrehozó hitelesítése

A létrehozó örökli az Azure Maps hozzáférés-vezérlési (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 bekerülnek az Azure Maps használati diagramjaiba és tevékenységnaplójába. További információ: Hitelesítés kezelése az Azure Mapsben.

Fontos

A következőket javasoljuk:

• Microsoft Entra-azonosító minden olyan megoldásban, amely egy Azure Maps-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 Maps-adatszolgáltatói szerepkörként működhetnek, a létrehozói térképadatok felhasználói pedig Azure Maps-adatolvasó 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ó
• Ú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.

Az Adatregisztrációs adatbázis létrehozása című cikkben ismertetett lépéseket követve töltse fel a rajzcsomagot az Azure Storage-fiókjába, majd regisztrálja az Azure Maps-fiókjában.

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 Önálló Azure Maps Rajzhibák vizualizációja 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 Maps Creator a következő szolgáltatásokat nyújtja, amelyek támogatják a térképlétrehozást:

• 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.
• 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 létrehozhat.

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.

Feljegyzé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 Maps Creator stílusai támogatják a MapLibre szabványt a stílusrétegekhez és a spritesekhez.

Ha egy rajzcsomagot az Azure Maps-fiókba 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 Maps-fiókjába a Style – Create HTTP kéréssel, 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 Maps-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ával kapcsolatos további információkért tekintse meg a stílust a Maps Creator Rest API-referenciájában.
• 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.

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 Maps [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 Renderelési szolgáltatást használó térképvezérlőre 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 és a Csempék készlet, 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 Maps Web SDK tartalmazza a Beltéri térképek modult. Ez a modul kiterjesztett funkciókat kínál az Azure Maps Térképvezérlő kódtára számára. A Beltéri térképek modul a Létrehozóban 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.

Az Indoor Maps modullal olyan webalkalmazásokat hozhat létre, amelyek beltéri térképadatokat integrálnak más Azure Maps-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 további információkért, lásd : Beltéri térképek továbbfejlesztése valós idejű térképfunkció-stílussal.

Azure Maps-integráció

Amikor megkezdi a beltéri térképek megoldásainak fejlesztését, felfedezheti a meglévő Azure Maps-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.

Adatkarbantartás

Az Azure Maps Creator List, Update és Delete API használatával listázhatja, frissítheti és törölheti az adathalmazokat és csempéket.

Feljegyzé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.