Autor pro mapy vnitřníchy

v tomto článku se seznámíte s koncepty a nástroji, které se týkají Azure Maps Creator. doporučujeme, abyste si tento článek přečetli dřív, než začnete používat rozhraní API pro Azure Maps Creator a sadu SDK.

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

• Mapový tvůrce: zodpovídá za obdobu a přípravu dat mapy.
• Tvůrce dat mapy – uživatel: využívá data map zákazníka v aplikacích.

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

vytvořit tvůrce Azure Maps

pokud chcete používat službu creator services, Azure Maps creator musí být vytvořený v účtu Azure Maps s cenovou úrovní 2. generace. informace o tom, jak vytvořit tvůrce Azure Maps v Azure Maps, najdete v tématu správa Azure Maps creator.

Ověřování autora

tvůrce zdědí nastavení Azure Maps Access Control (IAM). 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í tvůrce jsou začleněná do vašich Azure Mapsch grafů využití a protokolu aktivit. Další informace najdete v tématu Správa ověřování v Azure Maps.

Creator – typy datových položek

Tvůrci služeb vytvářejí, ukládají a používají různé typy dat, které jsou definovány a popsány v následujících částech. Datová položka Creator může být následujících typů:

• Převedená data
• Datová sada
• Tileset
• Stateset funkcí

Upload balíčku pro vykreslování

Tvůrce shromažďuje data vnitřních map tím, že převede nahraný balíček pro kreslení. Balíček pro kreslení představuje vytvořené nebo přemodelované zařízení. Informace o požadavcích na balíček pro vykreslování najdete v tématu požadavky na vykreslení balíčku.

pomocí rozhraní Azure Maps Data Upload API nahrajte balíček pro kreslení. po nahrání balení pro vykreslování Data Upload rozhraní API vrátí identifikátor dat uživatele ( udid ). udidPak se dá použít k převedení nahraného balíčku na data mapy interiéru.

Převod balíčku pro kreslení

služba Azure Maps Conversion převede nahraný balíček vykreslování na data mapy vnitřních dat. Služba konverze také ověřuje balíček. Problémy s ověřením jsou klasifikovány do dvou typů:

• Chyby: Pokud jsou zjištěny nějaké chyby, proces převodu se nezdařil. pokud dojde k chybě, služba převodu poskytuje odkaz na Azure Maps vykreslení samostatné webové aplikace vizualizér chyb . K prozkoumání Upozornění a chyb , ke kterým došlo během procesu převodu, můžete použít Vizualizér chyb při vykreslování. Po opravě chyb se můžete pokusit o nahrání a převod balíčku.
• Upozornění: Pokud jsou zjištěna nějaká upozornění, převod je úspěšný. Doporučujeme však zkontrolovat a vyřešit všechna upozornění. Upozornění znamená, že část převodu byla ignorována nebo automaticky opravena. Neúspěšné vyřešení upozornění může mít za následek chyby v pozdějších procesech. Další informace najdete v tématu Upozornění a chyby při vykreslování balíčku.

Vytvoření dat vnitřních map

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

• Služba DataSet
• Služba TILESET Použijte službu TILESET k vytvoření vektorové reprezentace datové sady. Aplikace mohou používat TILESET k prezentaci vizuálního zobrazení na základě dlaždice datové sady.
• Stavová služba funkcí. Použijte službu stavu funkce pro podporu stylů dynamické mapy. Aplikace mohou používat styly dynamických map k vyjádření událostí v reálném čase na prostory poskytované systémem IoT.

Datové sady

Datová sada je kolekce funkcí mapy vnitřních verzí. Funkce mapy vnitřních funkcí představují zařízení, která jsou definována v převedeném balíčku pro kreslení. Po vytvoření datové sady se službou DataSetmůžete vytvořit libovolný počet tilesets nebo funkcí statesets.

Vývojáři mohou kdykoli použít službu DataSet 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 tématu možnosti připojení ve službě DataSet. Příklad, jak aktualizovat datovou sadu, najdete v tématu Údržba dat.

Tilesets

TILESET je kolekce vektorových dat, která představuje sadu jednotných dlaždic mřížky. Vývojáři mohou pomocí služby TILESET vytvořit tilesets z datové sady.

Chcete-li odrážet různé fáze obsahu, můžete vytvořit více tilesets ze stejné datové sady. Můžete například vytvořit jeden TILESET s nábytekem a zařízením a další TILESET bez nábytku a vybavení. Můžete zvolit, že se má vygenerovat jeden TILESET s nejnovějšími aktualizacemi dat, a další TILESET bez nejnovějších aktualizací dat.

Kromě vektorových dat poskytuje TILESET metadata pro optimalizaci vykreslování mapy. Například metadata TILESET obsahují minimální a maximální úroveň přiblížení pro TILESET. Metadata také poskytují ohraničující rámeček, který definuje geografickou velikost TILESET. Aplikace může použít ohraničující rámeček k programovému nastavení správného centrálního bodu. Další informace o metadatech TILESET najdete v tématu rozhraní API pro seznam TILESET.

Po vytvoření je TILESET může získat Služba vykreslování v2.

Pokud se TILESET stane zastaralým a již není užitečný, můžete TILESET odstranit. Informace o tom, jak odstranit tilesets, najdete v tématu Údržba dat.

Statesets funkcí

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

Stavovou službu funkcí můžete použít k vytvoření a správě funkcí stateset pro datovou sadu. Stateset je definován jedním nebo více stavy. Každá funkce, jako je například místnost, může mít k sobě připojen jeden stav .

Hodnota každého stavu ve stateset může být aktualizována nebo načtena zařízeními IoT nebo jinými aplikacemi. Například při použití rozhraní API aktualizace stavu funkcezařízení, která měří obsazení místa, můžou systematicky zveřejnit stavovou změnu místnosti.

Aplikace může používat funkci stateset k dynamickému vykreslování funkcí v zařízení podle jejich aktuálního stavu a odpovídajícího stylu mapy. další informace o používání funkcí statesets k funkcím stylu v mapě vykreslování naleznete v tématu vnitřní Mapy modul.

Použití interiérových map

Rozhraní API V2-Get dlaždic vykreslení mapy

Rozhraní API Mapy Render V2-Get mapy mapy bylo rozšířeno o podporu sad dlaždic pro tvůrce.

Aplikace mohou k vyžádání sad dlaždic V2-Get rozhraní API pro vykreslování dlaždic. 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 V2, najdete v tématu Vnitřní Mapy Module.

Web Feature Service API

K dotazování datových sad můžete Web Feature Service (WFS) API. WFS dodržuje Open Geospatial Consortium API. Rozhraní API WFS můžete použít k dotazování funkcí v rámci samotné datové sady. WFS můžete například použít k vyhledání všech konferenčních místností střední velikosti konkrétního zařízení a úrovně podlaží.

Rozhraní API pro aliasy

Služby creatoru, jako jsou Conversion (Převod), Dataset (Datová sada), Tileset (Sada dlaždic) a Feature State (Stav funkce) vrací identifikátor pro každý prostředek vytvořený z rozhraní API. Rozhraní API pro aliasy umožňuje přiřadit alias pro odkazování na identifikátor prostředku.

Modul interiérových map

Sada Azure Mapy Web SDK zahrnuje vnitřní Mapy modul. Tento modul nabízí rozšířené funkce knihovny Azure Mapy Ovládací prvek Mapa. Interiérový Mapy vykresluje interiérové mapy vytvořené v Tvůrci. Integruje widgety, jako je například výběr podlaží, které uživatelům pomáhají vizualizovat různé podlahy.

Pomocí modulu interiérových Mapy můžete vytvářet webové aplikace, které integrují data interiérových map s dalšími službami Azure Mapy. Mezi nejběžnější nastavení aplikací patří přidání znalostí z jiných map , jako jsou roadmapy, snímky, počasí a doprava, na interiérové mapy.

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

Integrace Mapy Azure

Když začínáte vyvíjet řešení pro interiérové mapy, můžete objevit způsoby, jak integrovat stávající Mapy Azure. Můžete například implementovat scénáře sledování nebo zabezpečení prostředků pomocí rozhraní API Azure Mapy Geofence s interiérové mapy Creatoru. Pomocí rozhraní API pro geografickou replikaci můžete například určit, jestli pracovní proces vstupuje do konkrétních vnitřních oblastí nebo je opustí. Další informace o tom, jak připojit Azure Mapy s telemetrií IoT, najdete v tomto kurzu prostorové analýzy IoT.

Údržba dat

K zobrazení seznamu, aktualizaci a odstranění datových sad, sad dlaždic a stavů funkcí můžete použít rozhraní API pro vytváření sestav Azure Mapy, aktualizace a odstranění.

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. Pokud chcete nahrát a převést nový Upload balíček Drawing, postupujte podle kroků v částech Upload balíčku Drawing a Convert a Drawing package.
2. Pomocí rozhraní API pro vytvoření datové sady připojte převedená data k existující datové sadě.
3. Pomocí rozhraní API pro vytvoření sady dlaždic vygenerování nové sady dlaždic z aktualizované datové sady.
4. Uložte novou dlaždici tilesetId pro další krok.
5. Pokud chcete povolit vizualizaci aktualizované datové sady areálu, aktualizujte identifikátor sady dlaždic ve vaší aplikaci. Pokud se stará sada dlaždic už nebude používat, můžete ji odstranit.

Další kroky