Share via

Adathalmaz létrehozása GeoJson-csomag használatával (előzetes verzió)

  • Cikk

Az Azure Térképek Creator lehetővé teszi a felhasználók számára, hogy GeoJSON formátumban importálják a beltéri térképadatokat az Facility Ontology 2.0 használatával, amely aztán egy adatkészlet létrehozásához használható.

Megjegyzés:

Ez a cikk bemutatja, hogyan hozhat létre adatkészletet GeoJSON-csomagból. A beltéri térkép elvégzéséhez szükséges további lépésekről további információt a Következő lépések című témakörben talál.

Előfeltételek

Fontos

  • Ez a cikk a us.atlas.microsoft.com földrajzi URL-címet használja. Ha a Létrehozó szolgáltatás nem a Egyesült Államok lett létrehozva, más földrajzi URL-címet kell használnia. További információ: Access to Creator services.
  • A cikkben szereplő URL-példákban le kell cserélnie {Your-Azure-Maps-Subscription-key} az Azure Térképek előfizetési kulcsát.

Adatkészlet létrehozása a GeoJSON-csomag használatával

A GeoJSON-csomagról további információt a Geojson zip-csomagra vonatkozó követelmények szakaszában talál.

A GeoJSON-csomag feltöltése

Kövesse az Adatregisztrációs adatbázis létrehozása című cikkben ismertetett lépéseket a GeoJSON-csomag Azure-tárfiókba való feltöltéséhez, majd az Azure-Térképek-fiókban való regisztrálásához.

Fontos

Ügyeljen arra, hogy jegyezze fel az egyedi azonosító (udid) értékét, szüksége lesz rá. Így udid hivatkozhat az Azure-tárfiókba feltöltött GeoJSON-csomagra a forráskódból és a HTTP-kérelmekből.

Adathalmaz létrehozása

Az adatkészletek térképfunkciók, például épületek, szintek és szobák gyűjteményei. Ha a GeoJSON-ból szeretne adathalmazt létrehozni, használja az új Adathalmaz létrehozása API-t. Az Adathalmaz létrehozása API az udid előző szakaszban kapott adatokat veszi át, és visszaadja az datasetId új adatkészletet.

Fontos

Ez eltér az adathalmaz-létrehozási API korábbi verziójától, mivel nem igényel conversionId átalakított rajzcsomagot.

Adatkészlet létrehozása:

  1. Adja meg az adathalmaz-szolgáltatás következő URL-címét. A kérésnek a következő URL-címhez hasonlóan kell kinéznie (cserélje le a(z) {udid} fájlt a udid GeoJSON-csomag feltöltése szakaszban beszerzettre):
https://us.atlas.microsoft.com/datasets?api-version=2023-03-01-preview&udid={udid}&subscription-key={Your-Azure-Maps-Subscription-key}
  1. Másolja a kulcs értékét a Operation-Location válaszfejlécbe. A Operation-Location kulcs más néven az status URL adathalmaz létrehozási folyamatának állapotának ellenőrzéséhez és a datasetIdcsempék létrehozásához szükséges kulcs lekéréséhez szükséges.

Az adathalmaz létrehozásának állapotának ellenőrzése

Az adathalmaz-létrehozási folyamat állapotának ellenőrzéséhez és a következő lekéréséhez datasetId:

  1. Adja meg az adathalmaz létrehozása nézetben másolt állapot URL-címét. A kérésnek a következő URL-címhez hasonlóan kell kinéznie:

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

  2. A HTTP-válasz fejlécében másolja ki a kulcsban Resource-Location található egyedi azonosító értékét.

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

A beltéri térkép befejezését segítő cikkekre mutató hivatkozások a következő lépésekben találhatók.

Adatok hozzáadása meglévő adatkészlethez

Az adatok hozzáadhatók egy meglévő adatkészlethez úgy, hogy megadja a datasetId paramétert az Adathalmaz létrehozási API-jának , valamint a hozzáadni kívánt adatok egyedi azonosítóját. Az egyedi azonosító lehet a udid vagy conversionId. Ez létrehoz egy új adatkészletet, amely a meglévő és az importált új adatokból származó adatokat (létesítményeket) tartalmazza. Az új adathalmaz sikeres létrehozása után a régi adatkészlet törölhető.

Egy meglévő adatkészlethez való hozzáadáskor figyelembe kell venni a funkcióazonosítók létrehozását. Ha egy átalakított rajzcsomagból hoz létre adathalmazt, a rendszer automatikusan létrehozza a funkcióazonosítókat. Ha geojSON-csomagból hoz létre adathalmazt, a geojSON-fájlban meg kell adni a szolgáltatásazonosítókat. Meglévő adatkészlethez való hozzáfűzéskor az eredeti adatkészlet a funkcióazonosítók létrehozásának módját vezérli. Ha az eredeti adatkészletet egy udidhasználatával hozták létre, a GeoJSON azonosítóit használja, és a jövőben is ezt fogja tenni az adatkészlethez fűzött összes GeoJSON-csomaggal. Ha az adathalmazt egy conversionId, az adathalmazhoz fűzött összes GeoJSON-csomaggal belsőleg hozza létre a rendszer, az azonosítókat pedig belsőleg hozza létre.

Hozzáadás GeoJSON-forrásból létrehozott adatkészlethez

Ha az eredeti adatkészlet egy GoeJSON-forrásból lett létrehozva, és egy rajzcsomagból létrehozott másik létesítményt szeretne hozzáadni, azt hozzáfűzheti a meglévő adatkészlethez conversionIda http POST-kérelemnek megfelelően:

https://us.atlas.microsoft.com/datasets?api-version=2023-03-01-preview&conversionId={conversionId}&outputOntology=facility-2.0&datasetId={datasetId}
Azonosító Leírás
conversionId A rajzcsomag konvertálásakor visszaadott azonosító. További információ: Rajzcsomag konvertálása.
datasetId A GeoJSON-csomagból az eredeti adatkészlet létrehozásakor visszaadott adathalmaz-azonosító.

Geojson zip-csomagra vonatkozó követelmények

A GeoJSON zip-csomag egy vagy több RFC 7946-kompatibilis GeoJSON-fájlból áll, egyet minden szolgáltatásosztályhoz, mindegyik a gyökérkönyvtárban (az alkönyvtárak nem támogatottak), szabványos Zip-tömörítéssel tömörítve és a .ZIP bővítmény használatával elnevezve.

Minden szolgáltatásosztályfájlnak meg kell egyeznie az Facility Ontology 2.0 definíciójával, és minden funkciónak globálisan egyedi azonosítóval kell rendelkeznie.

A funkcióazonosítók csak alfa-numerikus (a-z, A-Z, 0-9), kötőjel (-), pont (.) és aláhúzásjel (_) karaktereket tartalmazhatnak.

Tipp.

Ha biztos szeretne lenni abban, hogy globálisan egyedi azonosítóval (GUID) rendelkezik, érdemes lehet létrehoznia egy GUID-generáló eszközt, például a Guidgen.exe parancssori programot (amely a Visual Studióval érhető el). A Guidgen.exe soha nem állítja elő kétszer ugyanazt a számot, függetlenül attól, hogy hányszor fut, vagy hány különböző gépen fut.

Létesítmény ontológia 2.0-s ellenőrzései az adathalmazban

Az Facility Ontology 2.0 azt határozza meg, hogy az Azure Térképek Creator hogyan tárolja belsőleg a létesítményadatokat funkcióosztályokra osztva egy Creator-adatkészletben. GeoJSON-csomag importálásakor, amikor hozzáad vagy módosít egy funkciót, az érvényesítések sorozata fut. Ez magában foglalja a hivatkozási integritás-ellenőrzéseket, valamint a geometria és az attribútumok érvényesítését. Ezeket az érvényesítéseket részletesebben az alábbi listában ismertetjük.

  • Az adathalmazba egyszerre importálható funkciók maximális száma 150 000.
  • A létesítmény területe 4 és 4000 Sq Km között lehet.
  • A legfelső szintű elem a létesítmény, amely meghatározza az egyes épületeket a file facility.geojson fájlban.
  • Minden létesítmény egy vagy több szinttel rendelkezik, amelyek a file levels.goejson fájlban vannak meghatározva.
    • Minden szintnek a létesítményen belül kell lennie.
  • Minden szint egységeket, struktúrákat, függőleges műveket és nyílásokat tartalmaz. A szintben definiált összes elemnek teljes mértékben tartalmaznia kell a szintgeometrián belül.
    • unitolyan elemekből állhat, mint a folyosók, irodák és udvarok, amelyeket terület-, vonal- vagy pontelemek határoznak meg. Az egységek a unit.goejson fájlban vannak definiálva.
      • Minden unit elemnek teljes mértékben a saját szintjén belül kell lennie, és meg kell metszeni a gyermekekkel.
    • structure Olyan fizikai, nem átfedésben lévő területeket határoz meg, amelyeken nem lehet navigálni, például a falakat. A struktúrák a file structure.goejson fájlban vannak definiálva.
    • verticalPenetrationA szintek ( például lépcsők és liftek) közötti függőleges navigálás módszerét jelöli, és a verticalPenetration.geojson fájlban vannak definiálva.
      • A verticalPenetrations nem tud metszeni más függőlegespenetrációkkal ugyanazon a szinten.
    • openingskét egység közötti bejárható határokat definiálhat, illetve a unitverticalPenetration fájlmegnyitás.geojson fájlban definiálhatók.
      • A nyílások nem tudnak metszeni más, azonos szinten lévő nyílásokkal.
      • Mindegyiknek opening legalább egy verticalPenetration vagy unit.

További lépések

Csempekészlet létrehozása