HARİTA

HARİTA (MAP), SCADA ekran tasarımına doğrudan bir harita alanı eklemek için kullanılan görsel bir kullanıcı kontrolüdür. Kaynak kodundaki yapı incelendiğinde harita isteğinin; kontrolün boyutu, merkez koordinatları, harita türü, belirli harita öğelerinin görünümü, görünürlük durumları, yakınlaştırma, ayrıntı, parlaklık ve doygunluk bilgileri birleştirilerek oluşturulduğu görülmektedir.

Bu nedenle MAP kontrolü, klasik bir veri göstergesinden farklıdır. Bir ibre, LED, çubuk veya sayısal değer üretmek yerine coğrafi bir görüntüyü SCADA sayfasının görsel bileşeni olarak sunar. Haritanın merkezinin değiştirilmesi ve görsel ayrıntıların yeniden yapılandırılması özellikler üzerinden yapılabilir.

Verilen ProcessEkstraParamVals kodu, MAP kontrolünün özellikleri ile harita isteği arasındaki ilişkiyi açık biçimde göstermektedir. Kontrol boyutu, merkez koordinatları, harita türü ve stil/görünürlük parametreleri sırayla MAPCOMMANDCALLSTR içerisine eklenir.

Son aşamada kaynak kodu GETBINGMAP() metodunu çağırmaktadır. Bu metodun gövdesi paylaşılmış kod parçasında bulunmadığından, görüntünün indirilmesi veya görüntülenmesi sırasında kullanılan alt mekanizmanın ayrıntıları bu sayfada varsayılmamıştır.

Kontrol Boyutu → Merkez → Harita Türü → Öğeler → Görünürlük → Zoom → Scale → Parlaklık → Doygunluk → GETBINGMAP()

Kaynak kodunda harita adresinin sorgu bölümü MAPCOMMANDCALLSTR değişkeni içerisinde adım adım oluşturulur. Başlangıçta kontrolün gerçek genişlik ve yüksekliği kullanılarak görüntü boyutu belirlenir. Daha sonra merkez, harita türü, öğe stilleri, görünürlük ayarları ve görüntü parametreleri eklenir.

String mapstr = "http://maps.BINGapis.com/maps/api/staticmap?"
             + MAPCOMMANDCALLSTR
             + "&sensor=false";

Bu yapıdan görülebileceği üzere MAP kontrolü, harita görüntüsünü statik bir harita isteği üzerinden alacak şekilde tasarlanmıştır. URL'nin sorgu parametreleri kontrol özelliklerinden üretildiği için aynı MAP kontrolü farklı koordinat ve görünüm ayarlarıyla yeniden kullanılabilir.

Haritanın hangi coğrafi noktayı merkez alacağını Enlem ve Boylam özellikleri belirler. Kaynak kodunda bu iki değer doğrudan center parametresine dönüştürülmektedir.

MapType, haritanın temel görsel türünü belirleyen özelliktir. Kaynak kodundaki varsayılan değer Roadmap olarak tanımlanmıştır. Kaynakta GNHaritaTuru türünün tüm seçenekleri paylaşılmadığı için burada yalnızca doğrulanabilen varsayılan değer açıklanmaktadır.

Harita türü, diğer görsel özelliklerle birlikte değerlendirilmelidir. Yol ağırlıklı bir görünüm ile daha görsel/uydu tabanlı bir görünümün operatör ekranındaki bilgi yoğunluğu farklı olabilir.

MAP kontrolünün dikkat çekici özelliklerinden biri, haritanın farklı öğelerini ayrı ayrı ele alabilmesidir. Kaynak kodunda yol, peyzaj, yönetim, POI, transit ve su olmak üzere altı öğe için hem öğe stili hem de görünürlük parametresi oluşturulmaktadır.

Bu özellikler, kaynak kodunda style=feature:... biçimindeki sorgu parçalarına dönüştürülmektedir. Böylece harita görüntüsünün farklı bileşenlerinin hangi görsel öğe üzerinde etkili olacağı belirlenebilir.

Harita öğelerinin görünür olup olmaması, MAP kontrolünde ayrı özelliklerle yönetilir. Kaynak koddaki varsayılanlar incelendiğinde yol, peyzaj, yönetim, POI ve transit için Off; su için ise On değeri kullanılmıştır.

Haritanın temel konum ve öğe ayarlarının yanında dört önemli görüntüleme parametresi daha vardır: Harita Yakınlaştırma Faktörü, Harita Ayrıntı Faktörü, Harita Parlaklığı ve Harita Doygunluğu. Kaynak kodunda bu değerlerin tamamı doğrudan harita isteğine eklenmektedir.

Kaynak kodunda harita görüntüsünün boyutu sabit bir değer olarak verilmek yerine MyWebBrowser.Width ve MyWebBrowser.Height üzerinden oluşturulmaktadır. Böylece harita isteğinin size parametresi kontrolün ekrandaki gerçek boyutuna göre hazırlanır.

UpdateInterval ise kontrolün güncelleme zamanlamasında kullanılmaktadır. Kod, değeri tam sayıya dönüştürmeye çalışmakta; geçersiz durumda 1000 değerine dönmekte ve ayrıca sistemin izin verdiği minimum güncelleme aralığının altına inilmesini engellemektedir. Sonrasında zamanlayıcının aralığı bu değerle ayarlanmaktadır.

Verilen ProcessEkstraParamVals metodu yalnızca görsel özellikleri okumakla kalmaz; aynı zamanda MAP kontrolünün çalışma akışını da ortaya koymaktadır.

1. Eski sürüm parametreleri kontrol edilir ve gerekiyorsa güncellenir.
2. DecimalPoint eksikse varsayılan değer olarak 0 eklenir.
3. Parametre metni sözlüğe dönüştürülür ve kullanıcı kontrolü adı güncellenir.
4. Action Event bilgisi alınır.
5. Arka plan, ön plan ve yazı tipi özellikleri uygulanır.
6. Harita boyutu kontrolün genişlik ve yüksekliğinden alınır.
7. Merkez Latitude + Longitude ile belirlenir.
8. MapType eklenir.
9. Altı harita öğesi için stil bileşenleri eklenir.
10. Altı harita öğesi için görünürlük ayarları eklenir.
11. Yakınlaştırma, ayrıntı, parlaklık ve doygunluk parametreleri eklenir.
12. Güncelleme aralığı doğrulanır ve zamanlayıcıya uygulanır.
13. Yetki düzeyi ve grup bilgisi okunur.
14. GETBINGMAP() çağrılarak harita alınır.
15. Bağlı veri güncelleme ve parametre saklama işlemleri gerçekleştirilir.

MAP kontrolü, haritanın proses ekranının bir parçası olarak kullanılmasının anlamlı olduğu uygulamalarda değerlendirilebilir. Özellikle saha, tesis, istasyon, dağıtım noktası veya coğrafi konum bilgisinin operatör ekranında görsel olarak sunulması gereken tasarımlarda harita alanı oluşturmak için kullanılabilir.

MAP kontrolünün gücü, aynı temel kontrolün farklı ekran amaçlarına göre yeniden yapılandırılabilmesidir. Aşağıdaki örnekler kaynak koddaki özelliklerin nasıl birlikte düşünülebileceğini gösterir.

Kaynak kodunda kullanılan GNHaritaTuru, GNHaritaBilesen ve GNGorunurlukTuru tiplerinin tam seçenek listeleri bu paylaşımda yer almamaktadır. Bu nedenle kaynakta açıkça görülen değerler aşağıdaki gibi belgelenmiştir.

MAP kontrolünün kaynak kodunda tanımlanan temel özellikleri aşağıda birlikte görülmektedir. Varsayılan değerler doğrudan verilen C# tanımlarından alınmıştır; Türkçe karşılıklar güncel terminoloji sözlüğündeki eşleştirmeler esas alınarak verilmiştir.

Harita servisleri için güncel teknik dokümantasyon incelendiğinde statik harita yaklaşımının; merkez konumu, yakınlaştırma, görüntü türü, görüntü boyutu ve görsel stil gibi parametrelerle yapılandırılabildiği görülmektedir. Harita öğelerinin görünürlüğü ve stilinin ayrı kurallarla yönetilmesi de genel statik harita yaklaşımıyla uyumludur.

Verilen kaynak kodundaki adres http://maps.BINGapis.com/maps/api/staticmap? biçimindedir ve size, center, maptype, style, zoom, scale gibi parametreler üretmektedir. Güncel servis dokümantasyonu farklı endpoint ve API modelleri kullanabildiğinden, uygulamanın gerçek çalışma ortamındaki servis adresinin doğrulanması önemlidir.

• Statik Harita Teknik Dokümantasyonu

HARİTA (MAP), SCADA ekranlarına coğrafi bir görüntü alanı eklemek için tasarlanmış, görünümü özelliklerle ayrıntılı biçimde yapılandırılabilen bir kullanıcı kontrolüdür. Enlem ve Boylam ile merkez konumu belirlenirken; Harita Türü, harita öğeleri, görünürlük, yakınlaştırma, ayrıntı, parlaklık ve doygunluk ayarları görüntünün nasıl sunulacağını belirler.

Kaynak kodunun en önemli yönlerinden biri, bu özelliklerin tek tek kullanılmak yerine bir harita isteğinin parçaları olarak birleştirilmesidir. Böylece MAP, SCADA ekranının tasarımına göre merkez ve görsel ayrıntıları değiştirilebilen yapılandırılabilir bir harita alanı haline gelir.