Set Map Provider aksiyonu, son kullanıcının uygulamada hangi harita sağlayıcısını kullanacağını belirler. Kullanıcının harita tercihini değiştirmesine olanak tanıyan ekranlarda, seçilen sağlayıcının kaydedilmesi için kullanılır.

Teknik Özellikler

• Kullanıcı Tercihini Kaydetme: Son kullanıcının harita sağlayıcısı tercihini GoogleMaps veya Amap olarak ayarlar.
• Dinamik Kullanım: Provider değeri sabit olarak girilebilir veya bir elementten (ör. SelectBox) dinamik olarak alınabilir.
• Web & Mobil Destek: Hem web hem de mobil uygulamalarda kullanılabilir.

Bu aksiyonu kullanabilmek 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.

Set 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 (ör. bir SelectBox veya buton) 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 “set map” yazın veya Category listesinden Geolocation kategorisini seçin.
7. Set Map Provider aksiyonunu seçin ve aksiyonu ekleyin.

2. Aksiyon Parametrelerini Yapılandırma

• Provider (String): Son kullanıcı için ayarlanacak harita sağlayıcısı. Aşağıdaki değerlerden biri olmalıdır:
  
  • GoogleMaps
  • Amap

Değeri Fixed Value olarak doğrudan yazabilir veya sihirli değnek ikonuna tıklayarak bir elementten (ör. SelectBox’ın seçili değeri) dinamik olarak alabilirsiniz.

Kullanım Senaryosu: Kullanıcının Harita Tercihini Değiştirmesi

Bir ayarlar ekranında, son kullanıcının SelectBox üzerinden harita sağlayıcısını seçmesi ve bu tercihin kaydedilmesi 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. Mevcut tercihi göstermek için ekranın pageInit aksiyonlarına Get Map Provider ve ardından Set Value aksiyonlarını ekleyin (bkz. Get Map Provider Aksiyonu).
2. SelectBox’ın değeri değiştiğinde çalışan aksiyonlara Set Map Provider aksiyonunu ekleyin.
3. Provider parametresine selectMapProvider elementinin seçili değerini verin.

Kullanıcı SelectBox’tan yeni bir harita sağlayıcısı seçtiğinde tercih kaydedilir ve uygulamadaki haritalar seçilen sağlayıcı üzerinden gösterilir.

Set Map Provider Aksiyonu İleri Seviye Özelleştirmeler

• Buton ile Kaydetme: Tercihin anında değil, kullanıcı onayladığında kaydedilmesini istiyorsanız aksiyonu SelectBox yerine bir “Kaydet” butonunun OnClick olayına ekleyebilirsiniz.
• Bilgilendirme Mesajı: Set Map Provider aksiyonundan sonra bir bildirim (Notify) aksiyonu ekleyerek kullanıcıya tercihinin kaydedildiğini bildirebilirsiniz.

Teknik Riskler ve Kontroller

• Geçersiz Değer: Provider parametresine GoogleMaps veya Amap dışında bir değer verilirse tercih kaydedilmeyebilir. Değerleri büyük-küçük harf dahil birebir aynı yazımla kullanın.
• Yapılandırma Eksikliği: Config Manager’da seçilen sağlayıcıya ait yapılandırma tanımlanmamışsa harita görüntülenemeyebilir.

Set Map Provider aksiyonu, son kullanıcılara harita sağlayıcısı seçme esnekliği sunar ve farklı bölgelerde veya tercihlerde çalışan kullanıcılar için uygulama deneyimini kişiselleştirmenizi sağlar.