Creator for indoor maps

Tento článek představuje koncepty a nástroje, které platí pro Azure Mapy Creator. Než začnete používat rozhraní API a sadu SDK pro tvůrce Azure Mapy, doporučujeme si přečíst tento článek.

Tvůrce můžete použít k vývoji aplikací s funkcemi mapy, které jsou založené na datech vnitřních map. Tento článek popisuje proces nahrávání, převádění, vytváření a používání dat mapy. Pracovní postup obvykle provádí dvě různé osoby s odlišnými oblastmi odborných znalostí a zodpovědností:

• Tvůrce map: zodpovídá za kurátorování a přípravu mapových dat.
• Uživatel mapových dat pro tvůrce: používá data map zákazníků v aplikacích.

Následující diagram znázorňuje celý pracovní postup.

Vytvoření Azure Mapy Creatoru

Pokud chcete používat služby Creator, musí se prostředek Azure Mapy Creator vytvořit a přidružit k účtu Azure Mapy s cenovou úrovní Gen2. Informace o tom, jak vytvořit prostředek Azure Mapy Creator v Azure, najdete v tématu Správa Azure Mapy Creator.

Tip

Informace o cenách najdete v části Creator v Azure Mapy cenách.

Ověřování tvůrce

Tvůrce dědí nastavení Řízení přístupu (IAM) Azure Mapy. Všechna volání rozhraní API pro přístup k datům se musí odesílat pomocí ověřovacích a autorizačních pravidel.

Data o využití v Tvůrci se začlení do grafů využití Azure Mapy a protokolu aktivit. Další informace najdete v tématu Správa ověřování v Azure Mapy.

Důležité

Doporučujeme použít:

• Microsoft Entra ID ve všech řešeních vytvořených pomocí účtu Azure Mapy pomocí služeb Creator. Další informace o Microsoft Entra ID naleznete v tématu Ověřování Microsoft Entra.

• Nastavení řízení přístupu na základě role Pomocí těchto nastavení můžou tvůrci map fungovat jako role Přispěvatel dat Azure Mapy a uživatelé mapových dat Creatoru můžou fungovat jako role Čtenář dat Azure Mapy. Další informace najdete v tématu Autorizace pomocí řízení přístupu na základě role.

Typy datových položek pro tvůrce

Služby Creator vytvářejí, ukládají a používají různé datové typy, které jsou definovány a popsány v následujících částech. Datová položka tvůrce může mít následující typy:

• Převedená data
• Datová sada
• Sada dlaždic
• – styl
• Konfigurace mapy
• Sada stavů funkcí
• Sada tras

Nahrání balíčku výkresu

Creator shromažďuje data vnitřní mapy převodem nahraného balíčku výkresu. Výkresový balíček představuje sestavené nebo remodelované zařízení. Informace o požadavcích na balíček výkresu naleznete v tématu Požadavky na balíček výkresu.

Postupujte podle kroků popsaných v článku Vytvoření registru dat a nahrajte balíček výkresu do účtu úložiště Azure a pak ho zaregistrujte ve svém účtu Azure Mapy.

Důležité

Nezapomeňte si poznamenat jedinečnou hodnotu identifikátoru (udid) a budete ji potřebovat. Vyžaduje udid se k převodu nahraného balíčku na data vnitřní mapy.

Převod balíčku výkresu

Služba Převod převede nahraný balíček výkresu na data vnitřní mapy. Služba Převod také ověří balíček. Problémy s ověřováním jsou klasifikovány do dvou typů:

• Chyby: Pokud se zjistí nějaké chyby, proces převodu selže. Pokud dojde k chybě, služba Převod poskytuje odkaz na samostatnou webovou aplikaci Azure Mapy Vizualizér chyb kreslení. Pomocí vizualizéru chyb výkresu můžete zkontrolovat upozornění balíčku výkresu a chyby , ke kterým došlo během procesu převodu. Po opravě chyb se můžete pokusit balíček nahrát a převést.
• Upozornění: Pokud se zjistí nějaká upozornění, převod proběhne úspěšně. Doporučujeme ale zkontrolovat a vyřešit všechna upozornění. Upozornění znamená, že část převodu byla ignorována nebo automaticky opravena. Při řešení upozornění může docházet k chybám v pozdějších procesech. Další informace naleznete v tématu Upozornění a chyby balíčku výkresu.

Vytvoření dat vnitřní mapy

Azure Mapy Creator poskytuje následující služby, které podporují vytváření map:

• Služba datové sady.
• Služba sady dlaždic. Pomocí služby Tileset můžete vytvořit vektorovou reprezentaci datové sady. Aplikace můžou pomocí sady dlaždic prezentovat vizuální zobrazení datové sady založené na dlaždicích.
• Služba vlastního stylu Pomocí služby stylu nebo editoru vizuálního stylu můžete přizpůsobit vizuální prvky vnitřní mapy.
• Služba stavu funkce Pomocí služby Stav funkce můžete podporovat dynamické styly mapování. Aplikace můžou pomocí dynamického stylu mapy odrážet události v reálném čase v prostorech poskytovaných systémem IoT.
• Služba wayfinding. Pomocí rozhraní API pro definici cesty vygenerujte cestu mezi dvěma body v rámci zařízení. Pomocí rozhraní API sady tras vytvořte data, která služba wayfinding potřebuje ke generování cest.

Datové sady

Datová sada je kolekce funkcí vnitřní mapy. Vnitřní funkce mapy představují zařízení definovaná v převedeném balíčku výkresu. Po vytvoření datové sady se službou Dataset můžete vytvořit libovolný počet sad dlaždic nebo sad stavů funkcí.

Vývojáři můžou službu Dataset kdykoli použít k přidání nebo odebrání zařízení do existující datové sady. Další informace o tom, jak aktualizovat existující datovou sadu pomocí rozhraní API, najdete v možnostech připojení ve službě Dataset. Příklad aktualizace datové sady najdete v tématu Údržba dat.

Tilesets

Sada dlaždic je kolekce vektorových dat, která představuje sadu jednotných dlaždic mřížky. Vývojáři můžou pomocí služby Tileset vytvářet sady dlaždic z datové sady.

Pokud chcete odrážet různé fáze obsahu, můžete vytvořit několik sad dlaždic ze stejné datové sady. Můžete například vytvořit jednu sadu dlaždic s nábytkem a vybavením a jinou sadu dlaždic bez nábytku a vybavení. Můžete se rozhodnout vygenerovat jednu sadu dlaždic s nejnovějšími aktualizacemi dat a jinou sadu dlaždic bez nejnovějších aktualizací dat.

Kromě vektorových dat poskytuje sada dlaždic metadat pro optimalizaci vykreslování map. Metadata sady dlaždic například obsahují minimální a maximální úroveň přiblížení sady dlaždic. Metadata také poskytují ohraničující rámeček, který definuje geografický rozsah sady dlaždic. Aplikace může pomocí ohraničujícího rámečku programově nastavit správný středový bod. Další informace o metadatech sady dlaždic naleznete v tématu Seznam sad dlaždic.

Po vytvoření sady dlaždic se načte pomocí služby Render.

Pokud je sada dlaždic zastaralá a už není užitečná, můžete sadu dlaždic odstranit. Informace o tom, jak odstranit sady dlaždic, najdete v tématu Údržba dat.

Poznámka:

Sada dlaždic je nezávislá na datové sadě, ze které byla vytvořena. Pokud vytváříte sady dlaždic z datové sady a následně tuto datovou sadu aktualizujete, sady dlaždic se neaktualizují.

Aby se změny projevily v datové sadě, musíte vytvořit nové sady dlaždic. Podobně platí, že pokud odstraníte sadu dlaždic, datová sada to neovlivní.

Vlastní styl (Preview)

Styl definuje vizuální vzhled mapy. Definuje, jaká data se mají nakreslit, jak je nakreslit a jak je při kreslení nakreslit. Styly Azure Mapy Creator podporují standard MapLibre pro vrstvy stylů a sprity.

Při převodu balíčku výkresu po nahrání do účtu Azure Mapy se na prvky mapy použijí výchozí styly. Služba vlastního stylu umožňuje přizpůsobit vzhled vizuálu mapy. Můžete to provést ruční úpravou formátu JSON stylu a jeho importem do účtu Azure Mapy pomocí požadavku Style – Vytvoření požadavku HTTP, ale doporučeným přístupem je použití editoru vizuálních stylů. Další informace najdete v tématu Vytváření vlastních stylů pro vnitřní mapy.

Příklad vrstvy v souboru style.json:

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

Vlastnosti vrstvy	Popis
ID	Název vrstvy
type	Typ vykreslování pro tuto vrstvu. Mezi nejběžnější typy patří: fill: Vyplněný mnohoúhelník s volitelným ohraničením tahu. Čára: Čára s tahem. Symbol: Ikona nebo textový popisek. výplní: polygon s vysunutím (3D).
filter	Zobrazí se jenom funkce, které odpovídají kritériím filtru.
rozložení	Vlastnosti rozložení vrstvy
minzoom	Číslo mezi 0 a 24, které představuje minimální úroveň přiblížení vrstvy. Na úrovních přiblížení menší než minzoom je vrstva skrytá.
Malovat	Výchozí vlastnosti malování pro tuto vrstvu
zdrojová vrstva	Zdroj poskytuje data ze zdroje vektorové dlaždice zobrazené na mapě. Požadováno pro zdroje vektorových dlaždic; zakázáno pro všechny ostatní typy zdrojů, včetně zdrojů GeoJSON.

Konfigurace mapy

Konfigurace mapy je pole konfigurací. Každá konfigurace se skládá ze základní mapy a jedné nebo více vrstev, přičemž každá vrstva se skládá ze sady členů sady dlaždic stylu + .

Konfigurace mapy se používá při vytváření instancí interiérového správce objektu mapy při vývoji aplikací v Azure Mapy. Odkazuje se na ni pomocí mapConfigurationIdalias Konfigurace mapování jsou neměnné. Při provádění změn existující konfigurace mapování se vytvoří nová konfigurace mapování, což vede k jiné mapConfingurationId. Kdykoli vytvoříte konfiguraci mapy pomocí aliasu, který už používá existující konfigurace mapování, odkazuje na novou konfiguraci mapování.

Následující JSON je příkladem výchozí konfigurace mapování. Popis jednotlivých prvků souboru najdete v následující tabulce:

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

Vlastnosti objektu stylu	Popis
Name	Název stylu.
displayName	Zobrazovaný název stylu.
description	Popis stylu definovaný uživatelem.
miniatura	Slouží k určení miniatury použité v nástroji pro výběr stylu pro tento styl. Další informace najdete v ovládacím prvku pro výběr stylu.
baseMap	Slouží k nastavení stylu základní mapy.
Vrstvy	Pole vrstev se skládá z jedné nebo více sad dlaždic + styl řazených kolekcí členů, z nichž každá je vrstvou mapy. To umožňuje více budov na mapě, přičemž každá budova je reprezentovaná ve své vlastní sadě dlaždic.

Další informace

• Další informace o úpravách stylů pomocí editoru stylů najdete v tématu Vytváření vlastních stylů pro vnitřní mapy.
• Další informace o rozhraní REST API stylu najdete v referenčních informacích k rozhraní REST API pro Mapy Creator.
• Další informace o rozhraní REST API pro konfiguraci mapy najdete v tématu Tvůrce – rozhraní REST API pro konfiguraci mapy.

Sady stavů funkcí

Stavy funkcí jsou kolekce dynamických vlastností (stavů), které jsou přiřazené k funkcím datové sady, jako jsou místnosti nebo vybavení. Příkladem stavu může být teplota nebo obsazenost. Každý stav je pár klíč/hodnota, který obsahuje název vlastnosti, hodnotu a časové razítko poslední aktualizace.

Pomocí služby Stav funkce můžete vytvořit a spravovat sadu stavů funkcí pro datovou sadu. Sada stavů je definována jedním nebo více stavy. Každá funkce, například místnost, může mít připojený jeden stav .

Hodnota každého stavu v sadě stavů se aktualizuje nebo načítá zařízeními IoT nebo jinými aplikacemi. Například pomocí rozhraní API aktualizace stavu funkcí můžou zařízení, která měří obsazenost prostoru, systematicky publikovat změnu stavu místnosti.

Aplikace může pomocí sady stavů funkcí dynamicky vykreslovat funkce v zařízení podle jejich aktuálního stavu a odpovídajícího stylu mapy. Další informace o používání sad stavů funkcí k funkcím v mapě vykreslování najdete v tématu Vnitřní Mapy modul.

Poznámka:

Podobně jako sady dlaždic nemá změna datové sady vliv na existující sadu stavů funkcí a odstranění sady stavů funkcí nemá vliv na datovou sadu, ke které je připojená.

Wayfinding (Preview)

Služba Wayfinding umožňuje zákazníkům poskytnout nejkratší cestu mezi dvěma body v rámci zařízení. Jakmile naimportujete data vnitřní mapy a vytvoříte datovou sadu, můžete ji použít k vytvoření sady tras. Sada tras poskytuje data potřebná ke generování cest mezi dvěma body. Služba, která určuje cestu, bere v úvahu například minimální šířku otvorů a může volitelně vyloučit výtahy nebo schody při procházení mezi úrovněmi v důsledku toho.

Autor wayfinding je poháněn Havok.

Cesty k definici cesty

Při úspěšném vygenerování cesty pro určení cesty najde nejkratší cestu mezi dvěma body v zadaném zařízení. Každé patro na cestě je reprezentováno jako samostatná noha, stejně jako schody nebo výtahy používané k pohybu mezi podlahami.

První část cesty může být například od počátku do výtahu v tomto patře. Další noha je výtah a pak poslední noha je cesta z výtahu do cíle. Odhadovaná doba trvání cesty se také vypočítá a vrátí ve formátu JSON odpovědi HTTP.

Struktura

Aby data zařízení fungovala, musí obsahovat strukturu. Služba wayfinding vypočítá nejkratší cestu mezi dvěma vybranými body v zařízení. Služba vytvoří cestu procházením kolem struktur, jako jsou stěny a jakékoli jiné neprostupné struktury.

Svislá průnik

Pokud je vybraný původ a cíl na různých podlažích, služba určení způsobu určení, jaké svislé ObjektyPenetration , jako jsou schody nebo výtahy, jsou k dispozici co možná cesty pro navigaci svisle mezi úrovněmi. Ve výchozím nastavení se použije možnost, která vede k nejkratší cestě.

Služba Wayfinding zahrnuje schody nebo výtahy v cestě na základě hodnoty svislé penetrační direction vlastnosti. Další informace o směru vlastnosti naleznete v článku o objektu Ontology verticalPenetration . avoidFeaturesminWidth Informace o dalších faktorech, které můžou ovlivnit výběr cesty mezi úrovněmi podlahy, najdete v dokumentaci k rozhraní API a jejich vlastnostech.

Další informace najdete v článku s návody k infinding vnitřní mapě .

Použití vnitřních map

Vykreslení – Získání rozhraní API pro dlaždici mapy

Rozhraní API Azure Mapy [Render – Získat dlaždici mapy] bylo rozšířeno tak, aby podporovalo sady dlaždic Creator.

Aplikace můžou k vyžádání sad dlaždic použít rozhraní API pro vykreslení – získání dlaždice mapy. Sady dlaždic je pak možné integrovat do ovládacího prvku mapy nebo sady SDK. Příklad ovládacího prvku mapy, který používá službu Render, naleznete v tématu Vnitřní Mapy Modul.

Rozhraní API služby webových funkcí

K dotazování datových sad můžete použít službu webových funkcí (WFS). WFS se řídí funkcemi rozhraní API open Geospatial Consortium. Rozhraní WFS API můžete použít k dotazování funkcí v samotné datové sadě. WFS můžete například použít k vyhledání všech místností pro schůzky střední velikosti konkrétního zařízení a úrovně podlahy.

Rozhraní API aliasu

Služby pro tvůrce, jako je převod, datová sada, sada dlaždic a stav funkce, vrací identifikátor pro každý prostředek vytvořený z rozhraní API. Rozhraní API aliasu umožňuje přiřadit alias pro odkaz na identifikátor prostředku.

Modul interiérových map

Sada Azure Mapy Web SDK obsahuje modul Vnitřní Mapy. Tento modul nabízí rozšířené funkce pro knihovnu ovládacích prvků map Azure Mapy. Vnitřní Mapy modul vykresluje vnitřní mapy vytvořené v Tvůrci. Integruje widgety, jako je výběr podlahy, které uživatelům pomáhají vizualizovat různé podlahy.

Modul Vnitřní Mapy můžete použít k vytváření webových aplikací, které integrují data vnitřních map s jinými službami Azure Mapy. Mezi nejběžnější nastavení aplikací patří přidání znalostí z jiných map , jako jsou silnice, obrázky, počasí a tranzit – do vnitřních map.

Modul Vnitřní Mapy podporuje také dynamické styly map. Podrobný návod k implementaci dynamického stylu sady stavů funkcí v aplikaci najdete v tématu Použití modulu Vnitřní mapa.

Integrace Mapy Azure

Když začnete vyvíjet řešení pro vnitřní mapy, můžete zjistit způsoby integrace stávajících funkcí azure Mapy. Můžete například implementovat scénáře sledování nebo bezpečnosti prostředků pomocí služby Geofence s vnitřními mapami Creator. Pomocí rozhraní API geografické zóny můžete například určit, jestli pracovník vstoupí nebo opustí konkrétní vnitřní oblasti. Další informace o připojení Azure Mapy s telemetrií IoT najdete v kurzu Implementace prostorové analýzy IoT pomocí Azure Mapy.

Údržba dat

Pomocí rozhraní API Azure Mapy Creator List, Update a Delete můžete vypsat, aktualizovat a odstranit datové sady, sady dlaždic a sady funkcí.

Poznámka:

Když zkontrolujete seznam položek, abyste zjistili, jestli se mají odstranit, zvažte dopad tohoto odstranění na všechny závislé rozhraní API nebo aplikace. Pokud například odstraníte sadu dlaždic, kterou aplikace používá pomocí rozhraní API [Render – Get Map Tile], aplikace tuto sadu dlaždic nevykreslí.

Příklad: Aktualizace datové sady

Následující příklad ukazuje, jak aktualizovat datovou sadu, vytvořit novou sadu dlaždic a odstranit starou sadu dlaždic:

1. Postupujte podle kroků v části Nahrát balíček výkresu a Převést oddíly balíčku výkresu a nahrajte a převeďte nový balíček výkresu.
2. Pomocí funkce Vytvoření datové sady připojte převedená data k existující datové sadě.
3. Pomocí sady dlaždic Vytvořit vygenerujte novou sadu dlaždic z aktualizované datové sady.
4. Uložte nové id sady dlaždic pro další krok.
5. Pokud chcete povolit vizualizaci aktualizované datové sady areálu, aktualizujte identifikátor sady dlaždic ve vaší aplikaci. Pokud už starou sadu dlaždic nepoužíváte, můžete ji odstranit.

Další kroky

Kurz: Vytvoření vnitřní mapy Pro tvůrce