Vytvoření datové sady pomocí balíčku GeoJson (Preview)

  • Článek

Azure Mapy Creator umožňuje uživatelům importovat data vnitřní mapy ve formátu GeoJSON s využitím facility Ontology 2.0, která se pak dá použít k vytvoření datové sady.

Poznámka:

Tento článek vysvětluje, jak vytvořit datovou sadu z balíčku GeoJSON. Informace o dalších krocích potřebných k dokončení vnitřní mapy najdete v tématu Další kroky.

Požadavky

Důležité

  • Tento článek používá zeměpisnou us.atlas.microsoft.com adresu URL. Pokud se služba Creator nevytvořila v USA, musíte použít jinou geografickou adresu URL. Další informace najdete v tématu Přístup ke službám Creator.
  • V příkladech adres URL v tomto článku budete muset nahradit {Your-Azure-Maps-Subscription-key} klíčem předplatného Azure Mapy.

Vytvoření datové sady pomocí balíčku GeoJSON

Další informace o balíčku GeoJSON naleznete v části Požadavky na balíček Zip Geojson.

Nahrání balíčku GeoJSON

Postupujte podle kroků uvedených v článku Vytvoření registru dat a nahrajte balíček GeoJSON 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. Takto udid odkazujete na balíček GeoJSON, který jste nahráli do účtu úložiště Azure ze zdrojového kódu a požadavků HTTP.

Vytvoření datové sady

Datová sada je kolekce funkcí mapy, jako jsou budovy, úrovně a místnosti. K vytvoření datové sady z GeoJSON použijte nové rozhraní API pro vytvoření datové sady. Rozhraní API pro vytvoření datové sady přebírá udid rozhraní API, které jste získali v předchozí části, a vrátí datasetId novou datovou sadu.

Důležité

To se liší od předchozí verze rozhraní API pro vytvoření datové sady v tom, že nevyžaduje conversionId z převedeného balíčku výkresu.

Vytvoření datové sady:

  1. Zadejte následující adresu URL služby datové sady. Požadavek by měl vypadat jako následující adresa URL (nahraďte {udid} získanou udid v části Nahrát balíček GeoJSON):
https://us.atlas.microsoft.com/datasets?api-version=2023-03-01-preview&udid={udid}&subscription-key={Your-Azure-Maps-Subscription-key}
  1. Zkopírujte hodnotu Operation-Location klíče v hlavičce odpovědi. Klíč Operation-Location se také označuje jako status URL klíč, který se vyžaduje ke kontrole stavu procesu vytváření datové sady a k získání datasetIdsouboru , který je nutný k vytvoření sady dlaždic.

Kontrola stavu vytvoření datové sady

Pokud chcete zkontrolovat stav procesu vytváření datové sady a načíst datasetId:

  1. Zadejte adresu URL stavu, kterou jste zkopírovali v části Vytvořit datovou sadu. Požadavek by měl vypadat jako následující adresa URL:

    https://us.atlas.microsoft.com/datasets/operations/{operationId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}

  2. V hlavičce odpovědi HTTP zkopírujte hodnotu jedinečného identifikátoru obsaženého v klíči Resource-Location .

    https://us.atlas.microsoft.com/datasets/**c9c15957-646c-13f2-611a-1ea7adc75174**?api-version=2023-03-01-preview

Další kroky najdete v odkazech na články, které vám pomůžou dokončit vnitřní mapu.

Přidání dat do existující datové sady

Data je možné přidat do existující datové sady tím, že poskytnete datasetId parametr rozhraní API pro vytvoření datové sady spolu s jedinečným identifikátorem dat, která chcete přidat. Jedinečný identifikátor může být buď a udid , nebo conversionId. Tím se vytvoří nová datová sada skládající se z dat (zařízení) z existující datové sady i z importovaných nových dat. Po úspěšném vytvoření nové datové sady je možné starou datovou sadu odstranit.

Při přidávání do existující datové sady je potřeba zvážit, jak se vytvářejí ID funkcí. Pokud se datová sada vytvoří z převedeného balíčku výkresu, id funkcí se vygenerují automaticky. Při vytvoření datové sady z balíčku GeoJSON musí být ID funkcí zadané v souboru GeoJSON. Při připojování k existující datové sadě řídí původní datová sada způsob vytváření ID funkcí. Pokud byla původní datová sada vytvořena pomocí objektu udid, použije ID z GeoJSON a bude to i nadále provádět se všemi balíčky GeoJSON připojenými k této datové sadě v budoucnu. Pokud byla datová sada vytvořena pomocí conversionId, ID se interně vygenerují a budou i nadále interně generovány se všemi balíčky GeoJSON připojenými k této datové sadě v budoucnu.

Přidání do datové sady vytvořené ze zdroje GeoJSON

Pokud byla původní datová sada vytvořena ze zdroje GoeJSON a chcete přidat další zařízení vytvořené z balíčku výkresu, můžete ji připojit k existující datové sadě tak, že na ni conversionIdodkazujete, jak ukazuje tento požadavek HTTP POST:

https://us.atlas.microsoft.com/datasets?api-version=2023-03-01-preview&conversionId={conversionId}&outputOntology=facility-2.0&datasetId={datasetId}
Identifikátor Popis
conversionId ID vrácené při převodu balíčku výkresu. Další informace naleznete v tématu Převod balíčku výkresu.
datasetId ID datové sady vrácené při vytváření původní datové sady z balíčku GeoJSON.

Požadavky na balíček zip Geojson

Balíček zip GeoJSON se skládá z jednoho nebo více souborů GEOJSON kompatibilních se standardem RFC 7946 , jednoho pro každou třídu funkcí, všechny v kořenovém adresáři (podadresáře nejsou podporovány), komprimované se standardní kompresí Zip a pojmenované pomocí .ZIP rozšíření.

Každý soubor třídy funkcí musí odpovídat své definici v objektu Ontology 2.0 a každá funkce musí mít globálně jedinečný identifikátor.

ID funkcí můžou obsahovat pouze alfanumerické znaky (a-z, A-Z, 0-9), spojovník (-), tečky (.) a podtržítka (_).

Tip

Pokud chcete mít jistotu, že máte globálně jedinečný identifikátor (GUID), zvažte jeho vytvoření spuštěním nástroje pro generování guid, jako je například program příkazového řádku Guidgen.exe (k dispozici v sadě Visual Studio). Guidgen.exe nikdy nevygeneruje stejné číslo dvakrát, bez ohledu na to, kolikrát je spuštěna nebo kolik různých počítačů běží na.

Ověřování ontologie zařízení 2.0 v datové sadě

Ontologie zařízení 2.0 definuje, jak Azure Mapy Creator interně ukládá data zařízení rozdělená do tříd funkcí v datové sadě Creator. Při importu balíčku GeoJSON se při každé přidání nebo úpravě funkce spustí řada ověření. To zahrnuje kontroly referenční integrity a geometrii a ověřování atributů. Tato ověření jsou podrobněji popsána v následujícím seznamu.

  • Maximální počet funkcí, které lze importovat do datové sady najednou, je 150 000.
  • V areálu zařízení je to 4 až 4 000 km.
  • Prvek nejvyšší úrovně je zařízení, které definuje každou budovu v souboru facility.geojson.
  • Každé zařízení má jednu nebo více úrovní, které jsou definovány v souborových úrovních.goejson.
    • Každá úroveň musí být uvnitř zařízení.
  • Každá úroveň obsahuje jednotky, struktury, svislépenetrace a otvory. Všechny položky definované na úrovni musí být plně obsaženy v geometrii úrovně.
    • unitmůže se skládat z pole položek, jako jsou chodby, kanceláře a nádvoří, které jsou definovány oblastmi, spojnicovými nebo bodovými prvky. Jednotky jsou definovány v souboru unit.goejson.
      • Všechny unit prvky musí být plně obsaženy v jejich úrovni a protínají se svými podřízenými prvky.
    • structure definuje fyzické nepřekrývající se oblasti, které se nedají procházet, například zeď. Struktury jsou definovány v souboru structure.goejson.
    • verticalPenetration představuje metodu navigace svisle mezi úrovněmi, jako jsou schody a výtahy a jsou definovány v souboru verticalPenetration.geojson.
      • verticalPenetrations nemůže protínnout s jinými svislýmiPenetrations na stejné úrovni.
    • openings definovat hranice procházení mezi dvěma jednotkami nebo unit a a verticalPenetration jsou definovány v souboru opening.geojson.
      • Otvory se nemůžou protínají s jinými otvory na stejné úrovni.
      • Každá opening musí být přidružena alespoň k jednomu verticalPenetration nebo unit.

Další kroky

Vytvoření sady dlaždic