Twórca map wnętrz

Uwaga

Wycofanie usługi Azure Maps Creator

Usługa mapy wewnętrznej usługi Azure Maps Creator jest teraz przestarzała i zostanie wycofana w dniu 30.09.25. Aby uzyskać więcej informacji, zobacz Ogłoszenie o zakończeniu życia twórcy usługi Azure Maps.

W tym artykule przedstawiono pojęcia i narzędzia, które mają zastosowanie do twórcy usługi Azure Maps. Zalecamy przeczytanie tego artykułu przed rozpoczęciem korzystania z interfejsu API i zestawu SDK dla twórców usługi Azure Maps.

Za pomocą twórcy można tworzyć aplikacje z funkcjami mapy opartymi na danych mapy wewnętrznej. W tym artykule opisano proces przekazywania, konwertowania, tworzenia i używania danych mapy. Zazwyczaj przepływ pracy jest wykonywany przez dwie różne osoby z różnymi obszarami wiedzy i odpowiedzialności:

• Twórca mapy: odpowiedzialny za curowanie i przygotowywanie danych mapy.
• Użytkownik danych mapy twórcy: używa danych mapy klienta w aplikacjach.

Na poniższym diagramie przedstawiono cały przepływ pracy.

Tworzenie twórcy usługi Azure Maps

Aby korzystać z usług Creator, należy utworzyć zasób twórcy usługi Azure Maps i skojarzyć go z kontem usługi Azure Maps z warstwą cenową Gen 2. Aby uzyskać informacje o sposobie tworzenia zasobu twórcy usługi Azure Maps na platformie Azure, zobacz Zarządzanie twórcą usługi Azure Maps.

Napiwek

Aby uzyskać informacje o cenach, zobacz sekcję Twórca w cenniku usługi Azure Maps.

Uwierzytelnianie twórców

Twórca dziedziczy ustawienia kontroli dostępu do usługi Azure Maps (IAM). Wszystkie wywołania interfejsu API na potrzeby dostępu do danych muszą być wysyłane z regułami uwierzytelniania i autoryzacji.

Dane użycia twórcy są uwzględniane na wykresach użycia usługi Azure Maps i w dzienniku aktywności. Aby uzyskać więcej informacji, zobacz Zarządzanie uwierzytelnianiem w usłudze Azure Maps.

Ważne

Zalecamy użycie:

• Identyfikator Entra firmy Microsoft we wszystkich rozwiązaniach utworzonych przy użyciu konta usługi Azure Maps przy użyciu usług Creator. Aby uzyskać więcej informacji na temat identyfikatora Entra firmy Microsoft, zobacz Microsoft Entra authentication (Uwierzytelnianie entra firmy Microsoft).

• Ustawienia kontroli dostępu opartej na rolach. Korzystając z tych ustawień, twórcy map mogą pełnić rolę współautora danych usługi Azure Maps, a użytkownicy danych mapy twórcy mogą pełnić rolę czytelnika danych usługi Azure Maps. Aby uzyskać więcej informacji, zobacz Autoryzacja z kontrolą dostępu opartą na rolach.

Typy elementów danych twórcy

Usługi twórców tworzą, przechowują i używają różnych typów danych zdefiniowanych i omówionych w poniższych sekcjach. Element danych twórcy może mieć następujące typy:

• Przekonwertowane dane
• Zestaw danych
• Zestaw kafelków
• — styl
• Konfiguracja mapy
• Zestaw tras

Przekazywanie pakietu rysunkowego

Twórca zbiera dane mapy wewnętrznej, konwertując przekazany pakiet rysunkowy. Pakiet rysunkowy reprezentuje skonstruowany lub przebudowany obiekt. Aby uzyskać informacje na temat wymagań dotyczących pakietu rysunkowego, zobacz Wymagania dotyczące pakietu rysunku.

Wykonaj kroki opisane w artykule How to create data registry (Jak utworzyć rejestr danych), aby przekazać pakiet rysunkowy na konto usługi Azure Storage, a następnie zarejestrować go na koncie usługi Azure Maps.

Ważne

Pamiętaj, aby zanotować wartość unikatowego identyfikatora (udid), która będzie potrzebna. Element udid jest wymagany do przekonwertowania przekazanego pakietu na dane mapy wewnętrznej.

Konwertowanie pakietu rysunkowego

Usługa konwersji konwertuje przekazany pakiet rysunku na dane mapy wewnętrznej. Usługa konwersji weryfikuje również pakiet. Problemy z walidacją są klasyfikowane na dwa typy:

• Błędy: Jeśli zostaną wykryte jakiekolwiek błędy, proces konwersji zakończy się niepowodzeniem. W przypadku wystąpienia błędu usługa konwersji udostępnia link do autonomicznej aplikacji internetowej wizualizatora błędów rysunku w usłudze Azure Maps. Możesz użyć wizualizatora błędów rysunku, aby sprawdzić ostrzeżenia i błędy pakietu rysunku, które wystąpiły podczas procesu konwersji. Po usunięciu błędów możesz spróbować przekazać i przekonwertować pakiet.
• Ostrzeżenia: jeśli zostaną wykryte jakiekolwiek ostrzeżenia, konwersja powiedzie się. Zalecamy jednak przejrzenie i rozwiązanie wszystkich ostrzeżeń. Ostrzeżenie oznacza, że część konwersji została zignorowana lub automatycznie naprawiona. Niepowodzenie rozwiązywania ostrzeżeń może spowodować błędy w późniejszych procesach. Aby uzyskać więcej informacji, zobacz Rysowanie ostrzeżeń i błędów pakietu.

Tworzenie danych mapy wewnętrznej

Usługa Azure Maps Creator udostępnia następujące usługi, które obsługują tworzenie mapy:

• Usługa zestawu danych.
• Usługa zestawu kafelków. Użyj usługi Zestaw kafelków, aby utworzyć wektorową reprezentację zestawu danych. Aplikacje mogą używać zestawu kafelków do prezentowania wizualnego widoku zestawu danych opartego na kafelkach.
• Niestandardowa usługa stylów. Użyj edytora stylów lub stylu wizualizacji, aby dostosować elementy wizualne mapy wnętrz.
• Usługa Wayfinding. Użyj interfejsu API tworzenia metody, aby wygenerować ścieżkę między dwoma punktami w obiekcie. Użyj interfejsu API zestawu tras, aby utworzyć dane potrzebne do wygenerowania ścieżek przez usługę wayfinding.

Zestawy danych

Zestaw danych to kolekcja funkcji mapy wewnętrznej. Funkcje mapy wewnętrznej reprezentują obiekty zdefiniowane w przekonwertowanym pakiecie rysunkowym. Po utworzeniu zestawu danych za pomocą usługi Dataset można utworzyć dowolną liczbę zestawów kafelków.

W dowolnym momencie deweloperzy mogą używać usługi Dataset do dodawania lub usuwania obiektów do istniejącego zestawu danych. Aby uzyskać więcej informacji na temat aktualizowania istniejącego zestawu danych przy użyciu interfejsu API, zobacz opcje dołączania w usłudze Zestaw danych. Aby zapoznać się z przykładem aktualizowania zestawu danych, zobacz Konserwacja danych.

Zestawy kafelków

Zestaw kafelków to kolekcja danych wektorowych, która reprezentuje zestaw jednolitych kafelków siatki. Deweloperzy mogą używać usługi Zestaw kafelków do tworzenia zestawów kafelków na podstawie zestawu danych.

Aby odzwierciedlić różne etapy zawartości, można utworzyć wiele zestawów kafelków z tego samego zestawu danych. Na przykład można zrobić jeden zestaw kafelków z meblami i sprzętem, a drugi kafelki bez mebli i sprzętu. Możesz wygenerować jeden zestaw kafelków z najnowszymi aktualizacjami danych, a drugi zestaw kafelków bez najnowszych aktualizacji danych.

Oprócz danych wektorowych zestaw kafelków udostępnia metadane na potrzeby optymalizacji renderowania map. Na przykład metadane zestawu kafelków zawierają minimalny i maksymalny poziom powiększenia zestawu kafelków. Metadane zawierają również pole ograniczenia, które definiuje zakres geograficzny zestawu kafelków. Aplikacja może użyć pola ograniczenia, aby programowo ustawić prawidłowy punkt środkowy. Aby uzyskać więcej informacji na temat metadanych zestawu kafelków, zobacz Lista zestawów kafelków.

Po utworzeniu zestawu kafelków jest on pobierany przy użyciu usługi Renderowanie.

Jeśli zestaw kafelków staje się nieaktualny i nie jest już przydatny, możesz usunąć zestaw kafelków. Aby uzyskać informacje o sposobie usuwania zestawów kafelków, zobacz Konserwacja danych.

Uwaga

Zestaw kafelków jest niezależny od zestawu danych, z którego został utworzony. Jeśli utworzysz zestawy kafelków na podstawie zestawu danych, a następnie zaktualizujesz ten zestaw danych, zestawy kafelków nie zostaną zaktualizowane.

Aby odzwierciedlić zmiany w zestawie danych, należy utworzyć nowe zestawy kafelków. Podobnie, jeśli usuniesz zestaw kafelków, zestaw danych nie będzie miał wpływu.

Niestandardowe style (wersja zapoznawcza)

Styl definiuje wygląd wizualizacji mapy. Definiuje ona dane do rysowania, kolejność ich rysowania oraz sposób tworzenia stylu danych podczas ich rysowania. Style twórcy usługi Azure Maps obsługują standard MapLibre dla warstw stylów i sprites.

Podczas konwertowania pakietu rysunkowego po przekazaniu go na konto usługi Azure Maps domyślne style są stosowane do elementów mapy. Niestandardowa usługa stylów umożliwia dostosowanie wyglądu wizualizacji mapy. Możesz to zrobić, edytując ręcznie kod JSON stylu i importując go do konta usługi Azure Maps przy użyciu stylu — utwórz żądanie HTTP, jednak zalecane jest użycie edytora stylów wizualizacji. Aby uzyskać więcej informacji, zobacz Tworzenie niestandardowych stylów dla map wnętrz.

Przykładowa warstwa w pliku 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"
},

Właściwości warstwy	opis
identyfikator	Nazwa warstwy
type	Typ renderowania dla tej warstwy. Oto niektóre z bardziej typowych typów: wypełnienie: wypełniony wielokąt z opcjonalnym obramowaniem pociągniętym. Linia: linia pociągnięta. Symbol: ikona lub etykieta tekstowa. wypełnienie-wytłaczanie: wielokąt ekstrudowany (3D).
filtr	Wyświetlane są tylko funkcje zgodne z kryteriami filtrowania.
mobilny	Właściwości układu dla warstwy.
minzoom	Liczba z zakresu od 0 do 24, która reprezentuje minimalny poziom powiększenia dla warstwy. Na poziomach powiększenia mniejszych niż minzoom warstwa jest ukryta.
farba	Domyślne właściwości farby dla tej warstwy.
warstwa źródłowa	Źródło dostarcza dane ze źródła kafelka wektorowego wyświetlanego na mapie. Wymagane dla źródeł kafelków wektorowych; zabronione dla wszystkich innych typów źródeł, w tym źródeł GeoJSON.

Konfiguracja mapy

Konfiguracja mapy to tablica konfiguracji. Każda konfiguracja składa się z mapy podstawowej i co najmniej jednej warstwy składającej się z krotki zestawów kafelków stylów + .

Konfiguracja mapy jest używana podczas tworzenia wystąpień w menedżerze wnętrz obiektu Mapy podczas tworzenia aplikacji w usłudze Azure Maps. Odwołuje się do niego przy użyciu elementu mapConfigurationId lub alias. Konfiguracje mapy są niezmienne. Podczas wprowadzania zmian w istniejącej konfiguracji mapy zostanie utworzona nowa konfiguracja mapy, co spowoduje powstanie innego mapConfingurationIdelementu . Za każdym razem, gdy tworzysz konfigurację mapy przy użyciu aliasu, który jest już używany przez istniejącą konfigurację mapy, wskazuje nową konfigurację mapy.

Poniższy kod JSON jest przykładem domyślnej konfiguracji mapy. Aby uzyskać opis każdego elementu pliku, zobacz następującą tabelę:

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

Właściwości obiektu stylu	opis
Nazwa/nazwisko	Nazwa stylu.
displayName	Nazwa wyświetlana stylu.
opis	Użytkownik zdefiniował opis stylu.
thumbnail	Użyj polecenia , aby określić miniaturę używaną w selektorze stylów dla tego stylu. Aby uzyskać więcej informacji, zobacz kontrolkę selektora stylów.
baseMap	Służy do ustawiania stylu mapy podstawowej.
Warstwy	Tablica warstw składa się z co najmniej jednej kolekcji kafelków i krotki stylu , z których każda jest warstwą mapy. Umożliwia to wiele budynków na mapie, każdy budynek reprezentowany we własnym zestawie kafelków.

Dodatkowe informacje

• Aby uzyskać więcej informacji na temat modyfikowania stylów przy użyciu edytora stylów, zobacz Tworzenie niestandardowych stylów dla map wnętrz.
• Aby uzyskać więcej informacji na temat interfejsu API REST stylu, zobacz style w dokumentacji interfejsu API REST twórcy w usłudze Maps.
• Aby uzyskać więcej informacji na temat interfejsu API REST konfiguracji mapy, zobacz Creator — konfiguracja mapy interfejsu API REST.

Wayfinding (wersja zapoznawcza)

Usługa Wayfinding umożliwia zapewnienie klientom najkrótszej ścieżki między dwoma punktami w obiekcie. Po zaimportowaniu danych mapy wewnętrznej i utworzeniu zestawu danych można go użyć do utworzenia zestawu tras. Zestaw tras udostępnia dane wymagane do wygenerowania ścieżek między dwoma punktami. Usługa wayfinding uwzględnia takie elementy jak minimalna szerokość otworów i opcjonalnie może wykluczać windy lub schody podczas poruszania się między poziomami w wyniku.

Sposób tworzenia jest obsługiwany przez Havok.

Ścieżki sposobu findowania

Po pomyślnym wygenerowaniu ścieżki określenia sposobu znajduje najkrótszą ścieżkę między dwoma punktami w określonym obiekcie. Każde piętro w podróży jest reprezentowane jako oddzielna noga, podobnie jak wszelkie schody lub windy używane do poruszania się między podłogami.

Na przykład pierwsza część ścieżki może pochodzić od źródła do windy na tym piętrze. Następną nogą jest winda, a następnie ostatnią nogą jest ścieżka z windy do miejsca docelowego. Szacowany czas podróży jest również obliczany i zwracany w formacie JSON odpowiedzi HTTP.

Struktura

Aby można było pracować, dane obiektu muszą zawierać strukturę. Usługa wayfinding oblicza najkrótszą ścieżkę między dwoma wybranymi punktami w obiekcie. Usługa tworzy ścieżkę, nawigując po strukturach, takich jak ściany i wszelkie inne nieprzepuszczalne struktury.

Penetracja pionowa

Jeśli wybrane źródło i miejsce docelowe znajdują się na różnych piętrach, usługa wayfinding określa, jakie obiekty pionowePenetration , takie jak schody lub windy, są dostępne jako możliwe ścieżki do poruszania się w pionie między poziomami. Domyślnie jest używana opcja, która powoduje najkrótszą ścieżkę.

Usługa Wayfinding obejmuje schody lub windy w ścieżce na podstawie wartości właściwości penetracji direction pionowej. Aby uzyskać więcej informacji na temat właściwości kierunku, zobacz verticalPenetration w artykule Dotyczącym ontologii obiektu. Zapoznaj się z avoidFeatures właściwościami i minWidth w dokumentacji interfejsuAPIego interfejsu API, aby dowiedzieć się więcej o innych czynnikach, które mogą mieć wpływ na wybór ścieżki między poziomami podłogi.

Aby uzyskać więcej informacji, zobacz artykuł How-to service wayfinding usługi Map krytych.

Korzystanie z map wnętrz

Renderowanie — uzyskiwanie interfejsu API kafelka mapy

Interfejs API usługi Azure Maps [Render — Pobierz kafelek mapy] został rozszerzony w celu obsługi zestawów kafelków dla twórców.

Aplikacje mogą używać interfejsu API renderowania — pobierz kafelek mapy w celu żądania zestawów kafelków. Zestawy kafelków można następnie zintegrować z kontrolką mapy lub zestawem SDK. Przykład kontrolki mapy korzystającej z usługi Renderowanie można znaleźć w temacie Indoor Maps Module (Moduł map wnętrz).

Internetowy interfejs API usługi funkcji

Usługa funkcji sieci Web (WFS) umożliwia wykonywanie zapytań dotyczących zestawów danych. Program WFS jest zgodny z funkcjami interfejsu API Open Geospatial Consortium. Interfejs API systemu plików WFS umożliwia wykonywanie zapytań dotyczących funkcji w samym zestawie danych. Na przykład można użyć systemu WFS, aby znaleźć wszystkie średniej wielkości sale konferencyjne określonego obiektu i poziomu podłogi.

Interfejs API aliasu

Usługi twórców, takie jak Konwersja, Zestaw danych i Zestaw kafelków, zwracają identyfikator dla każdego zasobu utworzonego na podstawie interfejsów API. Interfejs API aliasu umożliwia przypisanie aliasu do odwoływania się do identyfikatora zasobu.

Moduł planów wnętrz

Zestaw SDK sieci Web usługi Azure Maps zawiera moduł Mapy wewnętrzne. Ten moduł oferuje rozszerzone funkcje biblioteki kontrolki mapy usługi Azure Maps. Moduł Mapy wnętrz renderuje mapy wewnętrzne utworzone w kreatorze. Integruje widżety, takie jak selektor podłogowy, które ułatwiają użytkownikom wizualizowanie różnych pomieszczeń.

Za pomocą modułu Mapy wnętrz można tworzyć aplikacje internetowe integrujące dane mapy wewnętrznej z innymi usługami Azure Maps. Najbardziej typowe konfiguracje aplikacji obejmują dodawanie wiedzy z innych map — takich jak droga, obrazy, pogoda i tranzyt — do map w pomieszczeniach.

Moduł Mapy wnętrz obsługuje również dynamiczne style map, aby uzyskać więcej informacji, zobacz Ulepszanie map wnętrz za pomocą funkcji mapy w czasie rzeczywistym.

Integracja z usługą Azure Maps

W miarę rozpoczynania opracowywania rozwiązań dla map wewnętrznych można znaleźć sposoby integrowania istniejących funkcji usługi Azure Maps. Można na przykład zaimplementować scenariusze śledzenia zasobów lub bezpieczeństwa przy użyciu usługi Geofence z mapami wnętrz twórcy. Na przykład możesz użyć interfejsu API geofencingu, aby określić, czy pracownik wchodzi do określonych obszarów w pomieszczeniach, czy opuszcza go.

Konserwacja danych

Za pomocą interfejsu API listy twórców, aktualizacji i usuwania usługi Azure Maps możesz wyświetlać, aktualizować i usuwać zestawy danych i zestawy kafelków.

Uwaga

Podczas przeglądania listy elementów w celu określenia, czy je usunąć, należy wziąć pod uwagę wpływ tego usunięcia na wszystkie zależne interfejsy API lub aplikacje. Jeśli na przykład usuniesz zestaw kafelków używany przez aplikację za pomocą interfejsu API [Render — Pobierz kafelek mapy], aplikacja nie będzie renderować tego zestawu kafelków.

Przykład: aktualizowanie zestawu danych

W poniższym przykładzie pokazano, jak zaktualizować zestaw danych, utworzyć nowy zestaw kafelków i usunąć stary zestaw kafelków:

1. Wykonaj kroki opisane w sekcjach Przekazywanie pakietu rysunkowego i Konwertowanie pakietu rysunkowego w celu przekazania i przekonwertowania nowego pakietu rysunkowego.
2. Użyj polecenia Dataset Create , aby dołączyć przekonwertowane dane do istniejącego zestawu danych.
3. Użyj zestawu kafelków Utwórz , aby wygenerować nowy zestaw kafelków ze zaktualizowanego zestawu danych.
4. Zapisz nowy element tilesetId na potrzeby następnego kroku.
5. Aby włączyć wizualizację zaktualizowanego zestawu danych kampusu, zaktualizuj identyfikator zestawu kafelków w aplikacji. Jeśli stary zestaw kafelków nie jest już używany, możesz go usunąć.