QGIS'i GeoCatalog kaynağına erişecek şekilde yapılandırma

Bu kılavuzda, Microsoft Entra ID kimlik doğrulamasını kullanarak Microsoft Planetary Computer Pro GeoCatalog'dan jeo-uzamsal veri kümelerine erişmek için açık kaynak QGIS masaüstü GIS yazılımının nasıl yapılandırılma şekli açıklanmaktadır.

QGIS, Microsoft Planetary Computer Pro'daki STAC koleksiyonlarıyla doğrudan etkileşime olanak tanır. QGIS ile verileri anında görselleştirebilir, analiz edebilir ve şekillendirebilir ve Azure'ın yerel katmanlarıyla tümleştirebilirsiniz.

Tüm GeoCatalog varlıkları masaüstünüzde indirilebilir. Bulut için İyileştirilmiş GeoTIFF (COG) veya Bulut için İyileştirilmiş Nokta Bulutu (COPC) biçimindeki varlıklar doğrudan yayın yapar.

Yapılandırma iki bölümden oluşur:

Microsoft Entra uygulamasını kaydetmek, kiracınız için tek seferlik bir görevdir. Kayıt sonrasında, kullanıcılar STAC bağlantısını ayarlamak için QGIS'te Uygulama (istemci) Kimliği ve Dizin (kiracı) kimliğini girer.

Önkoşullar

Microsoft Entra Uygulama kayıtları

  • Microsoft Entra ID kiracısına erişim
  • Kimliğinizin şu rollerden birine sahip olduğu Azure aboneliği: Uygulama Geliştiricisi, Bulut Uygulaması Yöneticisi veya Uygulama Yöneticisi.

QGIS STAC bağlantısı

  • QGIS 4.0+ sürümünü indirme ve yükleme
  • GeoCatalog Okuyucusu veya GeoCatalog Yöneticisi rol tabanlı erişim denetimleri.
  • En az bir koleksiyon içeren Microsoft Planet Computer Pro GeoCatalog dağıtımı.

QGIS için Microsoft Entra uygulamasını kaydetme

İpucu

Uygulama kaydıyla ilgili arka plan bilgileri için Microsoft Entra Id'de uygulama kaydetme makalesini gözden geçirin.

QGIS'i Microsoft Entra Id'ye bir uygulama olarak kaydedin ve oturum açmış kullanıcı adına hareket edebilmesi için temsilci izinleri verin.

Azure portalında Microsoft Entra ID > Uygulama kayıtları > Yeni kayıt'a gidin:

Yeni kayıt düğmesinin vurgulandığı Uygulama kayıtları sayfasının ekran görüntüsü.

Uygulamayı kaydetme

  1. Uygulama için açıklayıcı bir ad girin.
  2. Desteklenen hesap türleri için kuruluşunuzun kullandığı kiracı seçeneğini belirtin (yalnızca tek kiracı veya çok kiracılı).
  3. Yeniden Yönlendirme URI'si'nin altında Genel istemci/yerel (mobil & masaüstü) öğesini seçin ve URI'yi olarak http://localhost:7070ayarlayın.
  4. Kayıt'ı seçin.
    Ad, hesap türü ve yeniden yönlendirme URI'sinin doldurulmuş olduğu Yeni uygulama kayıt formunun ekran görüntüsü.

API izinlerini yapılandırma

Devredilen API izinlerini yapılandırın.

  1. Uygulama kaydında API izinleri>İzin ekle'yi seçin.

    Geçerli vekaletle verilen izinleri listeleyen API izinleri dikey penceresinin ekran görüntüsü.

  2. Kuruluşumun kullandığı API'leri seçin, araması Azure Orbital Spatioyapın ve izin iletişim kutusunu açmak için hizmeti seçin.

    Azure Orbital Spatio API'sinin vurgulandığı izin seçimi iletişim kutusunun ekran görüntüsü.

  3. API izinleri iste bölümünde Temsilci izinleri'ni seçin, user_impersonation denetleyin ve ardından kapsamı vermek için İzin ekle'yi seçin.

    User_impersonation yetkilendirme kapsamının seçili olduğu API izin isteği iletişim kutusunun ekran görüntüsü.

Uygulama ve Dizin Kimliklerini Gözden Geçirme

Genel Bakış'a dönün ve Uygulama (istemci) Kimliği ile Dizin (kiracı) Kimliğini kaydedin. STAC bağlantısını yapılandırmak için bunları daha sonra QGIS'e girmeniz gerekir.

Uygulama (istemci) Kimliği ve Dizin (kiracı) Kimliği değerlerini gösteren Genel Bakış sayfasının ekran görüntüsü.

GeoCatalog erişimi için QGIS'i yapılandırma

QGIS'teki STAC kataloğu, göz atılabilir bir veri kaynağıdır. Tek bir statik dosya yerine hiyerarşik STAC meta verilerini (katalog → koleksiyonu → öğe → varlık) kullanıma sunar. Düğümleri genişlettiğinizde QGIS, GeoCatalog STAC uç noktasına gerçek zamanlı API istekleri ileterek GeoCatalog'unuzda sürekli en son koleksiyonları ve öğeleri görürsünüz.

STAC bağlantısını oluşturma

Aşağıdaki adımları izleyerek QGIS içinde STAC bağlantısını oluşturun:

  1. Tarayıcı panelinde bağlantı menüsünü görüntülemek için STAC'yi genişletin.
  2. YAPıLANDıRMA iletişim kutusunu açmak için STAC'ye sağ tıklayın ve Yeni STAC Bağlantısı'nı seçin. Yeni STAC Bağlantısı'nın seçili olduğu QGIS Tarayıcısı paneli bağlam menüsünün ekran görüntüsü.

STAC bağlantı kimlik doğrulamayı yapılandırma

  1. "Ad" alanında bu bağlantıyı adlandırın.
  2. GeoCatalog'unuzun URL'sini girin ve URL'ye ekleyerek /stac STAC API yolunu ekleyin.
  3. Kimlik doğrulamasını yapılandırmak için artı (+) düğmesini seçin. URL alanını ve kimlik doğrulama düğmesini gösteren STAC bağlantısı iletişim kutusunun ekran görüntüsü.

STAC bağlantı kimlik doğrulaması yapılandırması

  1. Kimlik Doğrulaması'ndan Microsoft Planet Bilgisayar'ı seçin. Microsoft PlanetAry Computer'ın seçili olduğu kimlik doğrulama profili listesinin ekran görüntüsü.

  2. "Sunucu türü" açılan listesinden Planetary Computer Pro'ya tıklayın. Planet Computer Pro'nun seçili olduğu kimlik doğrulama sunucusu türü listesinin ekran görüntüsü.

  3. Metin kutularına aşağıdaki bilgileri girin:

İstemci ve kiracı kimliklerinin doldurularak tamamlanmış STAC kimlik doğrulaması ayarlarının ekran görüntüsü.

Bu ayarlar tamamlandıktan sonra GeoCatalog'unuz QGIS STAC bağlantısı üzerinden erişim için yapılandırılır.

QGIS STAC bağlantısını kullanma

Koleksiyonlara göz atmak için veri katmanı tarayıcısında GeoCatalog'unuzu seçin ve genişletin.

Genişletildikten sonra QGIS, Microsoft Entra ile kimlik doğrulaması yapmak için sizi bir web tarayıcısına yönlendirir. Kuruluşunuzun devam etmesi için kimlik doğrulama işlemini tamamlayın.

Planetary Computer Pro koleksiyon ağacını gösteren QGIS Browser panelinin ekran görüntüsü.

İpucu

GeoCatalog'unuzda sıfır STAC Koleksiyonu varsa bir Host requires authentication hata görürsünüz. Bu hatayı çözmek için bir STAC Koleksiyonu oluşturun.

Bir STAC Öğesi bulana kadar koleksiyonları genişletmeye devam edin. Bu öğeyi görselleştirmek için öğeyi seçin ve harita görünümüne sürükleyin. Veriler Bulut için Optimizasyonlu bir GeoTIFF (COG) veya Bulut için Optimizasyonlu Nokta Bulutu (COPC) ise, otomatik olarak haritaya aktarılır ve projelendirilir.

QGIS'e eklenen bir STAC öğesini görüntüleyen harita görünümünün ekran görüntüsü.

STAC arama ve filtreleme

Verileri aramak veya kataloğunuzda bir STAC filtresi çalıştırmak istiyorsanız, STAC API'si Katman yöneticisi aracılığıyla kullanıma sunulur.

  1. Katman menüsünde Katman Ekle> ve STAC Kataloğu'ndan Katman Ekle'yi seçin. QGIS'te açılan STAC Kataloğundan Katman Ekle iletişim kutusunun ekran görüntüsü.

  2. GeoCatalog ile STAC bağlantınızı ve ardından Bağlan'ı seçin. Sorgulamadan önce yapılandırılmış STAC bağlantısını gösteren Veri Kaynağı Yöneticisi'nin ekran görüntüsü.

  3. Filtrelemek istediğiniz dizini seçin. Uzamsal, zamana bağlı veya koleksiyon kapsamını filtreleyebilirsiniz. Uzamsal kapsam filtresi uygulanmış STAC sorgu iletişim kutusunun ekran görüntüsü.

  4. Öğeyi seçerek harita kapsamına ekleyin veya varlıkları doğrudan yerel makinenize indirin. Öğenin üzerine geldiğinizde, uzamsal kapsam, harita alanında kırmızı renkle önizlenir. QGIS'te katman olarak eklemeye hazır COG varlık seçiminin ekran görüntüsü.