Maps ayarı, geliştirdiğiniz web veya mobil uygulamada harita kullanımı varsa harita sağlayıcısını ve sağlayıcıya ait bağlantı bilgilerini tanımlamanızı sağlar. Kuika, harita sağlayıcısı olarak Google Maps ve Amap desteği sunar. İsterseniz son kullanıcıların uygulamada hangi harita sağlayıcısını kullanacağını kendilerinin seçmesine de izin verebilirsiniz.

Maps Ayarlarına Erişim

1. Kuika platformuna giriş yapın.
2. Apps ekranından çalışacağınız projeyi açın.
3. Üst menüden Config Manager modülüne tıklayın.

4. Var olan bir konfigürasyonu düzenlemek için listeden adına tıklayın veya Create a blank configuration kartıyla yeni bir konfigürasyon oluşturun.
5. Uygulamanızın platformuna göre ilgili sekmeye geçin:
   
   • Web uygulamaları için: Web sekmesine tıklayın, sağ paneldeki Support Web UI seçeneğinin aktif olduğundan emin olun ve sol menüde WEB APP başlığı altındaki Maps seçeneğini açın.
   • Android uygulamaları için: Android sekmesine tıklayın, sağ paneldeki Support Android UI seçeneğinin aktif olduğundan emin olun ve sol menüde SERVICES başlığı altındaki Maps seçeneğini açın.

Maps Ekranındaki Alanlar

• Let end users choose the map provider: Aktif edildiğinde son kullanıcılar uygulamada Google Maps ve Amap arasında seçim yapabilir. Kullanıcının seçimi, SetMapProvider ve GetMapProvider aksiyonlarıyla yönetilir (bkz. Son Kullanıcının Harita Sağlayıcısını Seçmesi).
• Default provider: Uygulamada varsayılan olarak kullanılacak harita sağlayıcısı (ör. Google Maps). Son kullanıcı henüz bir seçim yapmadıysa bu sağlayıcı kullanılır.
• Configuration (Google Maps): Google Maps için kayıtlı bir yapılandırmayı seçebileceğiniz veya Add New bağlantısıyla yenisini oluşturabileceğiniz alan.
• Configuration (Amap): Amap için kayıtlı bir yapılandırmayı seçebileceğiniz veya Add New bağlantısıyla yenisini oluşturabileceğiniz alan.

Let end users choose the map provider seçeneği aktifken bir Amap yapılandırması seçilmesi zorunludur. Amap yapılandırması seçilmezse kod üretimi (code generation) başarısız olur. Bu durumda sol menüde Maps seçeneğinin yanında uyarı işareti görüntülenir.

Google Maps Yapılandırması

1. Google Maps’e ait Configuration alanının altındaki Add New bağlantısına tıklayın.
2. Açılan Google Maps Setting penceresinde aşağıdaki alanları doldurun (tüm alanlar zorunludur):

• Name: Harita yapılandırması için tanımlayıcı bir isim.
• Api Key: Google Maps API anahtarınız. Anahtarı Google Cloud Console’da APIs & Services > Credentials sayfasından oluşturabilirsiniz. Web uygulamaları için Maps JavaScript API’nin, Android uygulamaları için Maps SDK for Android’in projenizde etkin olması gerekir.

3. Create butonuna tıklayın.

Amap Yapılandırması

1. Amap’e ait Configuration alanının altındaki Add New bağlantısına tıklayın.
2. Açılan Amap Setting penceresinde aşağıdaki alanları doldurun:

• Name (zorunlu): Amap yapılandırması için tanımlayıcı bir isim.
• Api Key (zorunlu): Amap Open Platform konsolunda oluşturduğunuz API anahtarı.
• Security JS Code (zorunlu): Api Key ile birlikte verilen güvenlik kodu. Amap JS API’nin çalışması için gereklidir.
• Web Service Key: Backend tarafındaki geocoding (adres ve koordinat dönüştürme) aksiyonlarında kullanılan REST anahtarı. Boş bırakılırsa Api Key kullanılır.
• World Map: Aktif edildiğinde Çin dışındaki bölgeler için harita katmanları ve etiketler uygulamanın dilinde gösterilir. Bu seçeneği kullanabilmek için Amap anahtarınızda World Map yetkisinin tanımlı olması gerekir.

3. Create butonuna tıklayın.

Ayarları Kaydedin

1. Default provider alanından varsayılan harita sağlayıcısını seçin.
2. Configuration açılır menülerinden oluşturduğunuz yapılandırmaları seçin.
3. Sağ üst köşedeki Save butonuna tıklayarak değişiklikleri kaydedin. (Mevcut bir konfigürasyonda bu buton Update olarak görünür.)

Son Kullanıcının Harita Sağlayıcısını Seçmesi

Let end users choose the map provider seçeneği aktif edildiğinde, son kullanıcıların harita sağlayıcısını uygulama içinden değiştirebilmesi için Kuika’nın sunduğu iki aksiyonu kullanabilirsiniz:

• SetMapProvider: Son kullanıcının hangi harita sağlayıcısını (Google Maps veya Amap) kullanacağını belirler. Kullanıcı tercihini değiştirdiğinde bu aksiyon çağrılarak seçim kaydedilir.
• GetMapProvider: Son kullanıcı için ayarlanmış olan harita sağlayıcısını getirir. Bu bilgi, ekranda kullanıcının mevcut tercihini göstermek veya uygulama akışını seçilen sağlayıcıya göre düzenlemek için kullanılabilir.