Get Map Provider aksiyonu, uygulamanın o anda kullandığı harita sağlayıcısını getirir. Aksiyon, son kullanıcı bir harita sağlayıcısı seçtiyse bu seçimi, seçim yapmadıysa Config Manager’da tanımlanan varsayılan sağlayıcıyı döndürür.

Son kullanıcıların harita sağlayıcısını kendilerinin seçebildiği uygulamalarda, kullanıcının mevcut tercihini ekranda göstermek veya uygulama akışını seçili sağlayıcıya göre düzenlemek için kullanılır.

Teknik Özellikler

• Parametresiz Kullanım: Herhangi bir parametre gerektirmez.
• Metin Türünde Sonuç: Sonuç olarak String türünde tek bir değer döner: GoogleMaps veya Amap.
• Varsayılan Değer Desteği: Son kullanıcı henüz seçim yapmadıysa Config Manager’daki Default provider alanında seçilen sağlayıcıyı döndürür.
• Web & Mobil Destek: Hem web hem de mobil uygulamalarda kullanılabilir.

Bu aksiyonun anlamlı sonuç verebilmesi için Config Manager’da Maps ayarında Let end users choose the map provider seçeneğinin aktif olması ve Google Maps ile Amap yapılandırmalarının tanımlanmış olması gerekir.

Get Map Provider Aksiyonu Uygulama Adımları

1. UI Design’da Aksiyonu Tanımlama

1. Kuika platformuna giriş yapın.
2. Apps ekranından çalışacağınız projeyi açın.
3. UI Design modülüne geçin.
4. Aksiyonu eklemek istediğiniz ekranı veya elementi seçin.
5. Sağ taraftaki Properties panelinde Actions başlığının yanındaki + butonuna tıklayın.
6. Açılan pencerede arama alanına “get map” yazın veya Category listesinden Geolocation kategorisini seçin.
7. Get Map Provider aksiyonunu seçin ve Add to Page Init butonuna tıklayın.

Aksiyon, pageInit altında String · One dönüş tipiyle listelenir.

2. Aksiyon Parametrelerini Yapılandırma

Get Map Provider aksiyonu parametre almaz. Aksiyonun dönüş değeri, sonraki aksiyonlarda (ör. Set Value) veya element özelliklerinde Symbol Picker aracılığıyla kullanılabilir.

Kullanım Senaryosu: Kullanıcının Harita Tercihini Gösterme

Bir ayarlar ekranında, son kullanıcının hangi harita sağlayıcısını kullandığının bir SelectBox içinde gösterilmesi isteniyor.

Uygulama Akışı:

1. UI Design modülüne geçin.
2. Elements panelinden bir SelectBox elementini ekrana sürükleyip bırakın (ör. selectMapProvider).
3. SelectBox seçeneklerini, değerleri GoogleMaps ve Amap olacak şekilde tanımlayın.

Aksiyon Akışı ve Yapılandırma:

1. Ekranın pageInit aksiyonlarına Get Map Provider aksiyonunu ekleyin.
2. Hemen ardından ikinci bir aksiyon olarak Set Value aksiyonunu ekleyin:
   
   • Target: selectMapProvider
   • Value: Get Map Provider aksiyonunun sonucu

Kullanıcı ekranı açtığında mevcut harita tercihi SelectBox’ta seçili olarak gösterilir.

Get Map Provider Aksiyonu İleri Seviye Özelleştirmeler

• Koşullu Akış: Dönen değere göre farklı ekran veya element göstermek için koşullu aksiyonlarla (ör. değer Amap ise farklı bir bilgilendirme metni gösterme) birlikte kullanılabilir.
• Set Map Provider ile Birlikte Kullanım: Kullanıcının tercihini değiştirebildiği ekranlarda, mevcut değeri göstermek için Get Map Provider, yeni değeri kaydetmek için Set Map Provider aksiyonu kullanılır.

Teknik Riskler ve Kontroller

• Karşılaştırma Değerleri: Dönen değer GoogleMaps veya Amap biçimindedir. Koşullu karşılaştırmalarda bu değerleri birebir aynı yazımla kullanın.
• Yapılandırma Eksikliği: Config Manager’da Maps ayarı tanımlanmamışsa aksiyon beklenen sonucu döndürmeyebilir.

Get Map Provider aksiyonu, son kullanıcının harita tercihini uygulama içinde okumanızı sağlar ve harita sağlayıcısına göre şekillenen akışlar oluşturmanıza yardımcı olur.