Aracılığıyla paylaş

GeoJson paketi kullanarak veri kümesi oluşturma (Önizleme)

  • Makale

Not

Azure Haritalar Creator'ın kullanımdan kaldırılması

Azure Haritalar Creator iç mekan harita hizmeti artık kullanım dışıdır ve 30.09.25 tarihinde kullanımdan kaldırılacaktır. Daha fazla bilgi için bkz. Azure Haritalar Oluşturucunun Kullanım Süresi Sonu Duyurusu.

Azure Haritalar Oluşturucu, kullanıcıların iç mekan harita verilerini GeoJSON biçiminde içeri aktarmalarını sağlarDaha sonra veri kümesi oluşturmak için kullanılabilen Tesis Ontolojisi 2.0.

Önkoşullar

Önemli

  • Bu makalede coğrafi URL kullanılır us.atlas.microsoft.com . Oluşturucu hizmetiniz Birleşik Devletler oluşturulmadıysa farklı bir coğrafi URL kullanmanız gerekir. Daha fazla bilgi için bkz . Oluşturucu hizmetlerine erişim.
  • Bu makaledeki URL örneklerinde Azure Haritalar abonelik anahtarınızla değiştirmeniz {Your-Azure-Maps-Subscription-key} gerekir.

GeoJSON paketini kullanarak veri kümesi oluşturma

GeoJSON paketi hakkında daha fazla bilgi için Geojson zip paketi gereksinimleri bölümüne bakın.

GeoJSON paketini karşıya yükleme

GeoJSON paketini Azure depolama hesabınıza yüklemek ve ardından Azure Haritalar hesabınıza kaydetmek için Veri kayıt defteri oluşturma makalesinde açıklanan adımları izleyin.

Önemli

Benzersiz tanımlayıcı (udid) değerini not edin, buna ihtiyacınız olacaktır. udid Kaynak kodunuz ve HTTP isteklerinizden Azure depolama hesabınıza yüklediğiniz GeoJSON paketine başvurma yönteminizdir.

Veri kümesi oluşturma

Veri kümesi, binalar, düzeyler ve odalar gibi harita özelliklerinden oluşan bir koleksiyondur. GeoJSON'unuzdan veri kümesi oluşturmak için yeni Veri Kümesi Oluşturma API'sini kullanın. Veri Kümesi Oluşturma API'si udid önceki bölümde aldığınız veri kümesini alır ve yeni veri kümesini döndürür datasetId .

Önemli

Bu, veri kümesi oluşturma API'sinin önceki sürümünden farklıdır, çünkü dönüştürülen bir çizim paketine gerek conversionId yoktur.

Veri kümesi oluşturmak için:

  1. Veri kümesi hizmetinin aşağıdaki URL'sini girin. İstek aşağıdaki URL gibi görünmelidir ({udid} değerini GeoJSON paketini karşıya yükleme bölümünde elde edilen url ile udid değiştirin):
https://us.atlas.microsoft.com/datasets?api-version=2023-03-01-preview&udid={udid}&subscription-key={Your-Azure-Maps-Subscription-key}
  1. Yanıt üst bilgisindeki anahtarın değerini Operation-Location kopyalayın. Operation-Location Anahtar olarak da bilinir status URL ve veri kümesi oluşturma işleminin durumunu denetlemek ve kutucuk kümesi oluşturmak için gereken değerini almak datasetIdiçin gereklidir.

Veri kümesi oluşturma durumunu denetleme

Veri kümesi oluşturma işleminin durumunu denetlemek ve almak için datasetId:

  1. Veri kümesi oluşturma bölümüne kopyaladığınız durum URL'sini girin. İstek aşağıdaki URL gibi görünmelidir:

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

  2. HTTP yanıtının Üst Bilgisinde, anahtarın içerdiği Resource-Location benzersiz tanımlayıcının değerini kopyalayın.

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

Mevcut bir veri kümesine veri ekleme

Veri Kümesi Oluşturma API'sine parametresi ve eklemek istediğiniz verilerin benzersiz tanımlayıcısı sağlanarak datasetId veriler mevcut bir veri kümesine eklenebilir. Benzersiz tanımlayıcı veya udid conversionIdolabilir. Bu, hem mevcut veri kümesinden hem de içeri aktarılan yeni verilerden (tesisler) oluşan yeni bir veri kümesi oluşturur. Yeni veri kümesi başarıyla oluşturulduktan sonra eski veri kümesi silinebilir.

Mevcut bir veri kümesine ekleme yaparken dikkate alınması gereken bir şey, özellik kimliklerinin nasıl oluşturulduğudur. Dönüştürülen çizim paketinden bir veri kümesi oluşturulursa özellik kimlikleri otomatik olarak oluşturulur. GeoJSON paketinden bir veri kümesi oluşturulduğunda, GeoJSON dosyasında özellik kimlikleri sağlanmalıdır. Mevcut bir veri kümesine eklerken, özgün veri kümesi özellik kimliklerinin oluşturulma şeklini belirler. Özgün veri kümesi kullanılarak udidoluşturulduysa, GeoJSON'daki kimlikleri kullanır ve gelecekte bu veri kümesine eklenen tüm GeoJSON paketleriyle bunu yapmaya devam eder. Veri kümesi kullanılarak conversionIdoluşturulduysa, kimlikler dahili olarak oluşturulur ve gelecekte bu veri kümesine eklenen tüm GeoJSON paketleriyle dahili olarak oluşturulmaya devam eder.

GeoJSON kaynağından oluşturulan veri kümesine ekleme

Özgün veri kümeniz bir GoeJSON kaynağından oluşturulduysa ve bir çizim paketinden oluşturulmuş başka bir tesis eklemek istiyorsanız, bu HTTP POST isteğinde gösterildiği gibi öğesine başvurarak conversionIdveri kümenize ekleyebilirsiniz:

https://us.atlas.microsoft.com/datasets?api-version=2023-03-01-preview&conversionId={conversionId}&outputOntology=facility-2.0&datasetId={datasetId}
Tanımlayıcı Açıklama
conversionId Çizim paketiniz dönüştürülürken döndürülen kimlik.
datasetId Bir GeoJSON paketinden özgün veri kümesi oluşturulurken döndürülen veri kümesi kimliği.

Geojson zip paketi gereksinimleri

GeoJSON zip paketi, bir veya daha fazla RFC 7946 uyumlu GeoJSON dosyasından oluşur. Her özellik sınıfı için bir dosya, tümü kök dizinde (alt dizinler desteklenmez), standart Zip sıkıştırması ile sıkıştırılmış ve uzantı kullanılarak .ZIP adlandırılmıştır.

Her özellik sınıfı dosyası, Tesis Ontolojisi 2.0'daki tanımıyla eşleşmelidir ve her özelliğin genel olarak benzersiz bir tanımlayıcısı olmalıdır.

Özellik kimlikleri yalnızca alfasayısal (a-z, A-Z, 0-9), kısa çizgi (-), nokta (.) ve alt çizgi (_) karakterleri içerebilir.

İpucu

Genel olarak benzersiz bir tanımlayıcıya (GUID) sahip olduğunuzdan emin olmak istiyorsanız, Guidgen.exe komut satırı programı (Visual Studio ile kullanılabilir) gibi bir GUID oluşturma aracı çalıştırarak oluşturmayı göz önünde bulundurun. Guidgen.exe, kaç kez çalıştırılırsa veya kaç farklı makinede çalıştırılırsa çalışsın aynı sayıyı hiçbir zaman iki kez üretmez.

Veri Kümesindeki tesis ontolojisi 2.0 doğrulamaları

Facility Ontology 2.0, Azure Haritalar Creator'ın bir Oluşturucu veri kümesinde özellik sınıflarına ayrılmış olan tesis verilerini dahili olarak nasıl depoladüğünü tanımlar. GeoJSON paketini içeri aktarırken, her özellik eklendiğinde veya değiştirildiğinde bir dizi doğrulama çalıştırılır. Buna bilgi tutarlılığı denetimleri ile geometri ve öznitelik doğrulamaları dahildir. Bu doğrulamalar aşağıdaki listede daha ayrıntılı olarak açıklanmıştır.

  • Bir veri kümesine aynı anda içeri aktarılabilir özellik sayısı üst sınırı 150.000'dir.
  • Tesis alanı 4 ile 4.000 Sq Km arasında olabilir.
  • En üst düzey öğe, file facility.geojson dosyasındaki her bir binayı tanımlayan tesistir.
  • Her tesisin, levels.goejson dosyasında tanımlanan bir veya daha fazla düzeyi vardır.
    • Her seviye tesisin içinde olmalıdır.
  • Her düzey birimler, yapılar, dikey Ağlar ve açıklıklar içerir. Düzeyde tanımlanan tüm öğeler, Düzey geometrisinin içinde tam olarak bulunmalıdır.
    • unitalan, çizgi veya nokta elemanlarıyla tanımlanan koridorlar, ofisler ve avlular gibi bir dizi öğeden oluşabilir. Birimler unit.goejson dosyasında tanımlanır.
      • Tüm unit öğeler kendi düzeylerinde tam olarak bulunmalı ve çocuklarıyla kesişmelidir.
    • structure , duvar gibi gezinilemeyen fiziksel, örtüşmeyen alanları tanımlar. Yapılar structure.goejson dosyasında tanımlanır.
    • verticalPenetration, merdivenler ve asansörler gibi düzeyler arasında dikey olarak gezinme yöntemini temsil eder ve verticalPenetration.geojson dosyasında tanımlanır.
      • verticalPenetrations aynı düzeydeki diğer verticalPenetrations ile kesişemez.
    • openingsiki birim veya ve unit verticalPenetration arasında geçirilebilir sınırlar tanımlayın ve dosyası opening.geojson içinde tanımlanır.
      • Açılışlar aynı düzeydeki diğer açıklıklarla kesişemez.
      • Her opening biri en az bir verticalPenetration veya unitile ilişkilendirilmelidir.