Inkapı haritaları için Oluşturucu
bu makalede, Azure Haritalar oluşturucu için uygulanan kavramlar ve araçlar açıklanır. Azure Haritalar Creator apı ve SDK 'yı kullanmaya başlamadan önce bu makaleyi okumanızı öneririz.
Oluşturucu, iç eşleme verilerini temel alan harita özellikleriyle uygulama geliştirmek için ' i kullanabilirsiniz. Bu makalede harita verilerinizi yükleme, dönüştürme, oluşturma ve kullanma işlemi açıklanmaktadır. Genellikle iş akışı, uzmanlığın ve sorumluluğun farklı alanlarındaki iki farklı kişilik tarafından tamamlanır:
- Harita Oluşturucu: harita verilerini seçmekten ve hazırlamadan sorumludur.
- Oluşturan harita verileri kullanıcısı: uygulamalardaki müşteri eşleme verilerini kullanır.
Aşağıdaki diyagramda iş akışının tamamı gösterilmektedir.
Azure Haritalar oluşturucu oluştur
creator hizmetlerini kullanmak için azure Haritalar creator, Gen 2 fiyatlandırma katmanıyla bir Azure Haritalar hesabında oluşturulmalıdır. azure Haritalar azure Haritalar creator oluşturma hakkında daha fazla bilgi için bkz. azure Haritalar oluşturucusunu yönetme.
İpucu
fiyatlandırma bilgileri için Azure Haritalar fiyatlandırması' nda oluşturucu bölümüne bakın.
Oluşturucu kimlik doğrulaması
oluşturucu Azure Haritalar Access Control (ıam) ayarlarını devralır. Veri erişimi için tüm API çağrılarının kimlik doğrulama ve yetkilendirme kurallarıyla gönderilmesi gerekir.
oluşturucu kullanım verileri, Azure Haritalar kullanım grafiklerinize ve etkinlik günlüğüne eklenir. daha fazla bilgi için bkz. Azure Haritalar kimlik doğrulamasını yönetme.
Önemli
Şunları kullanmanızı öneririz:
oluşturucu hizmetleri kullanılarak azure Haritalar hesabıyla oluşturulan tüm çözümlerde Azure Active Directory (azure AD). Azure AD hakkında daha fazla bilgi için bkz. Azure AD kimlik doğrulaması.
Rol tabanlı erişim denetimi ayarları. bu ayarları kullanarak, eşleme oluşturucuları azure Haritalar veri katılımcısı rolü olarak davranabilir ve oluşturan harita verileri kullanıcıları azure Haritalar veri okuyucu rolü olarak davranabilir. Daha fazla bilgi için bkz. rol tabanlı erişim denetimi Ile yetkilendirme.
Oluşturucu veri öğesi türleri
Creator Hizmetleri, aşağıdaki bölümlerde tanımlanan ve açıklanan çeşitli veri türlerini oluşturun, depolayın ve kullanın. Bir Oluşturucu veri öğesi aşağıdaki türlerde olabilir:
- Dönüştürülen veriler
- Veri kümesi
- Tileset
- Özellik stateset
bir çizim paketi Upload
Oluşturucu, karşıya yüklenen bir çizim paketini dönüştürerek ınkapısı eşleme verilerini toplar. Çizim paketi oluşturulmuş veya uzaktan kaldırma özelliğini temsil eder. Paket gereksinimlerini çizme hakkında daha fazla bilgi için bkz. Çizim paketi gereksinimleri.
bir çizim paketini karşıya yüklemek için Azure Haritalar Data Upload apı 'sini kullanın. çizim paketleme karşıya yüklendikten sonra, veri Upload apı 'si bir kullanıcı veri tanımlayıcısı () döndürür udid . udidDaha sonra karşıya yüklenen paketi ınkapımap verilerine dönüştürmek için kullanılabilir.
Bir çizim paketini dönüştürme
Azure Haritalar dönüştürme hizmeti , karşıya yüklenen bir çizim paketini ınkapılı harita verilerine dönüştürür. Dönüştürme hizmeti Ayrıca paketi de doğrular. Doğrulama sorunları iki tür halinde sınıflandırılır:
- Hatalar: herhangi bir hata algılanırsa, dönüştürme işlemi başarısız olur. bir hata oluştuğunda, dönüştürme hizmeti Azure Haritalar çizim hatası görselleştiricisi tek başına web uygulamasına bir bağlantı sağlar. Çizim paketi uyarılarını ve dönüştürme işlemi sırasında oluşan hataları Incelemek Için çizim hatası görselleştiricisi ' nı kullanabilirsiniz. Hataları düzelttikten sonra, paketi karşıya yüklemeyi ve dönüştürmeyi deneyebilirsiniz.
- Uyarılar: herhangi bir uyarı algılanırsa, dönüştürme başarılı olur. Bununla birlikte, tüm uyarıları incelemenizi ve çözmeniz önerilir. Uyarı, dönüştürmenin bir kısmının yoksayıldığı veya otomatik olarak düzeltilmediği anlamına gelir. Uyarıları çözememesi sonraki işlemlerde hatalara neden olabilir. Daha fazla bilgi için bkz. paket uyarılarını ve hatalarını çizme.
Inkapılı harita verileri oluşturma
Azure Haritalar oluşturucu, harita oluşturmayı destekleyen aşağıdaki hizmetleri sağlar:
- Veri kümesi hizmeti.
- Tileset hizmeti. Bir veri kümesinin vektör tabanlı temsilini oluşturmak için tileset hizmetini kullanın. Uygulamalar, veri kümesinin görsel kutucuk tabanlı görünümünü sunmak için bir tileset kullanabilir.
- Özellik durumu hizmeti. Dinamik harita stillendirilmesini desteklemek için özellik durumu hizmetini kullanın. Uygulamalar, IoT sistemi tarafından sunulan boşlukların gerçek zamanlı olaylarını yansıtmak için dinamik harita stili kullanabilir.
Veri kümeleri
Veri kümesi, bir ınkapımap özellikleri koleksiyonudur. Inkapımap özellikleri, dönüştürülmüş bir çizim paketinde tanımlanan tesisleri temsil eder. Veri kümesi hizmetiile bir veri kümesi oluşturduktan sonra istediğiniz sayıda tilesets veya özellik statesetsoluşturabilirsiniz.
Geliştiriciler dilediğiniz zaman, mevcut bir veri kümesine tesis eklemek veya kaldırmak için DataSet hizmetini kullanabilir. API kullanarak var olan bir veri kümesini güncelleştirme hakkında daha fazla bilgi için bkz. DataSet Serviceiçindeki ekleme seçenekleri. Bir veri kümesini güncelleştirme hakkında bir örnek için bkz. veri Bakımı.
Tilesets 'ler
Bir tileset, bir Tekdüzen kılavuz kutucukları kümesini temsil eden bir vektör verileri koleksiyonudur. Geliştiriciler bir veri kümesinden tilesets oluşturmak için tileset hizmetini kullanabilir.
Farklı içerik aşamalarını yansıtmak için aynı veri kümesinden birden çok tilesets oluşturabilirsiniz. Örneğin, mobilya ve ekipmanla bir tileset, mobilya ve ekipman olmadan başka bir döşeme kümesi de yapabilirsiniz. En son veri güncelleştirmeleriyle tek bir tilekümesi oluşturmayı ve en son veri güncelleştirmeleri olmadan başka bir tileset oluşturmayı tercih edebilirsiniz.
Vektör verilerine ek olarak, tileset, harita işleme iyileştirmesi için meta veriler sağlar. Örneğin, tileset meta verileri, tileset için en düşük ve en yüksek yakınlaştırma düzeyini içerir. Meta veriler ayrıca, tileset 'in coğrafi kapsamını tanımlayan bir sınırlayıcı kutu sağlar. Bir uygulama, doğru merkez noktasını programlı bir şekilde ayarlamak için sınırlayıcı bir kutu kullanabilir. Tileset meta verileri hakkında daha fazla bilgi için bkz. tileset LIST API.
Bir tileset oluşturulduktan sonra, oluşturma v2 hizmetitarafından alınabilir.
Bir tileset tarihi geçmiş hale gelirse ve artık yararlı değilse, tileset 'i silebilirsiniz. Tilesets 'in nasıl silineceği hakkında daha fazla bilgi için bkz. veri Bakımı.
Not
Bir tileset oluşturulduğu veri kümesinden bağımsızdır. Bir veri kümesinden tilesets 'ler oluşturup daha sonra bu veri kümesini güncelleştirirseniz, tilesets güncellenemez.
Bir veri kümesindeki değişiklikleri yansıtmak için yeni bir tilesets oluşturmanız gerekir. Benzer şekilde, bir tileset silerseniz, veri kümesi etkilenmez.
Özellik statesets 'ler
Özellik statesets 'ler, odalar veya ekipman gibi veri kümesi özelliklerine atanan dinamik Özellikler (eyaletler) koleksiyonlarıdır. Bir durum örneği sıcaklık veya doluluk olabilir. Her durum , özelliğin adını, değerini ve son güncelleştirmenin zaman damgasını içeren bir anahtar/değer çiftidir.
Bir veri kümesi için bir özellik stateset oluşturmak ve yönetmek için özellik durumu hizmetini kullanabilirsiniz. Stateset bir veya daha fazla durum tarafından tanımlanır. Oda gibi her bir özelliğin, kendisine bağlı bir durum olabilir.
Bir stateset içindeki her durum değeri IoT cihazları veya diğer uygulamalar tarafından güncelleştirilebilen veya alınabilir. Örneğin, özellik durumu GÜNCELLEŞTIRME API'sini kullanarak, alan doluluk ölçen cihazlar, bir odanın durum değişikliğini sistematik olarak gönderebilir.
Bir uygulama, bir tesis içindeki özellikleri geçerli durumlarına ve ilgili harita stiline göre dinamik olarak işlemek için bir özellik stateset kullanabilir. özellik statesets 'i bir işleme eşlemesindeki stil özelliklerine kullanma hakkında daha fazla bilgi için bkz. ınkapıHaritalar modülü.
Not
Tilesets gibi, bir veri kümesini değiştirmek var olan durum kümesini etkilemez ve bir özellik stateset silindiğinde eklendiği veri kümesini etkilemez.
Inkapıharitaları kullanma
V2-Get harita kutucuğu API 'sini işle
Azure Haritalar işleme V2-Get harita kutucuğu apı 'si , oluşturucu tilesets 'leri destekleyecek şekilde genişletildi.
Uygulamalar, tilesets 'leri istemek için render V2-Get Map kutucuğu API 'sini kullanabilir. Daha sonra, tilesets 'ler bir harita denetimiyle veya SDK ile tümleştirilebilirler. oluşturma V2 hizmetini kullanan bir harita denetimi örneği için bkz. ınkapıHaritalar modülü.
Web özelliği hizmet API 'SI
Veri kümelerini sorgulamak için Web özelliği hizmeti (WFS) API 'sini kullanabilirsiniz. WFS, Open GEOSPATIAL CONSORTIUM API özellikleriniizler. WFS API 'sini kullanarak veri kümesinin içindeki özellikleri sorgulayabilirsiniz. Örneğin, belirli bir tesis ve kat düzeyi için tüm orta ölçekli toplantı odalarını bulmak üzere WFS 'yi kullanabilirsiniz.
Diğer ad API 'SI
Dönüştürme, veri kümesi, tileset ve özellik durumu gibi Oluşturucu Hizmetleri, API 'lerden oluşturulan her kaynak için bir tanımlayıcı döndürür. Diğer ad API 'si , kaynak tanımlayıcısına başvurmak için bir diğer ad atamanıza izin verir.
İç Mekan Haritaları modülü
Azure Haritalar Web SDK 'sı , ınkapıHaritalar modülünü içerir. bu modül, Azure Haritalar Harita Denetimi kitaplığına genişletilmiş işlevler sunar. ınkapıHaritalar modülü, oluşturucu içinde oluşturulan ınkapısı haritalarını işler. Kullanıcıların farklı katları görselleştirmesine yardımcı olan zemin Seçicisi gibi pencere öğelerini tümleştirir.
ınkapısı eşleme verilerini diğer Azure Haritalar hizmetleriyletümleştiren web uygulamaları oluşturmak için ınkapıHaritalar modülünü kullanabilirsiniz. En yaygın uygulama kurulumları, yol, Imagery, hava durumu ve geçiş-kapılı haritalar gibi diğer haritalardan bilgi eklemeyi içerir.
ınkapıHaritalar modülü ayrıca dinamik harita stillendirilmesini destekler. Bir uygulamada Özellik stateset dinamik stilini uygulamaya yönelik adım adım yönergeler için bkz. ınkapısı eşleme modülünü kullanma.
Azure Haritalar tümleştirmesi
ınkapıeşlemler için çözümler geliştirmeye başladığınızda, mevcut Azure Haritalar yeteneklerini tümleştirme yollarını bulabilirsiniz. örneğin, oluşturucu ınkapısı eşlemeleriyle Azure Haritalar geofence apı 'sini kullanarak varlık izleme veya güvenlik senaryoları uygulayabilirsiniz. Örneğin, bir çalışanın belirli ınkapılı alanları girip girmediğini veya ayrılmadığını anlamak için geofence API 'sini kullanabilirsiniz. Azure Haritalar ıot telemetrisi ile bağlanma hakkında daha fazla bilgi için bkz. bu ıot uzamsalanalizler öğreticisi.
Veri Bakımı
veri kümelerinizi, tilekümelerinizi ve özellik statesets 'leri listelemek, güncelleştirmek ve silmek için Azure Haritalar oluşturucu listesi, güncelleştirme ve silme apı 'sini kullanabilirsiniz.
Not
Öğelerin listesini gözden geçirdikten sonra, bu silmenin tüm bağımlı API veya uygulamalar üzerinde etkisini göz önünde bulundurun. Örneğin, işleme V2-Get harita kutucuğu API 'siaracılığıyla bir uygulama tarafından kullanılan bir kutucuk kümesini silerseniz, uygulama bu kutucuk kümesini işleyebilir.
Örnek: bir veri kümesini güncelleştirme
Aşağıdaki örnekte, bir veri kümesini güncelleştirme, yeni bir tileset oluşturma ve eski bir tileset 'i silme işlemlerinin nasıl yapılacağı gösterilmektedir:
- çizim paketindeki Upload adımları izleyin ve yeni çizim paketini karşıya yüklemek ve dönüştürmek için bir çizim paketi bölümünü dönüştürün .
- Dönüştürülen verileri varolan veri kümesine eklemek için veri kümesi oluşturma API 'sini kullanın.
- Güncelleştirilmiş veri kümesinden yeni bir tileset oluşturmak için tileset Create API 'sini kullanın.
- Yeni Tilesetıd 'yi bir sonraki adım için kaydedin.
- Güncelleştirilmiş kampüs veri kümesinin görselleştirmesini etkinleştirmek için uygulamanızdaki tileset tanımlayıcısını güncelleştirin. Eski tileset artık kullanılmıyorsa, bunu silebilirsiniz.