Web API Dünyası — GeoLocation API

Web API Dünyası serisinin yeni yazısında GeoLocation API ile tanışacağız. Daha önce tanışmadıysanız, kendisinden kısaca bahsedeyim. Kullanıcının konum izni vermesi ve sağlanan bağlantının https olması koşuluyla konum bilgisine erişilmesini sağlayan bir arayüzdür.

Konum denildiğinde ilk önce aklımıza gelmesi gereken temel iki kavram olan latitude (enlem) ve longitude (boylam) biçiminde konum verilerine erişim sağlayabiliyoruz. Bu kavramlarla ilgili özet bilgilere buradan ulaşabilirsiniz.

GeoLocation API’sini kullanabilmek için navigator objesi içerisinde bulunan geolocation nesnesine ait olan getCurrentPosition fonksiyonunu kullanmamız gerekiyor.

Aşağıdaki örnekte görebileceğiniz gibi getCurrentPosition fonksiyonu üç parametre alıyor.

success : Location verisine sağlıklı bir şekilde ulaşıldığında yapılacak işlemler bu fonksiyon içerisinde tanımlanır. Veri olarak coords adında obje elde ederiz.

error : İsminden de anlaşılacağı gibi hata durumlarında yapılacak işlemleri de bu fonksiyon ile tanımlıyoruz.

config : getCurrentPosition fonksiyonu burada belirleyebildiğimiz bazı ayarlar ile konfigure edilebiliyor. Kısaca şu ayarlar bulunuyor:

maximumAge : Bu değer konum bilgisinin ön bellekte ne kadar tutulacağına karar vermemizi sağlıyor. Varsayılan olarak 0 değerine sahip ve bu sebeple maximumAge değerine herhangi bir atama yapmazsak konum bilgisi ön bellekte tutulmayacak ve gerçek zamanlı olarak konum bilgisine erişmemizi sağlayacaktır.

timeout : Bağlantı ve benzeri problemlerden dolayı bazen konum bilgisi hızlıca alınamayabilir. Bu durumda, sonsuza kadar deneme yapmaması adına timeout değeri kullanılarak bir kısıtlama yapılabilir. Milisaniye cinsinden verilen bu değerin varsayılanı infinity yani sonsuzdur.

enableHighAccuracy : Konum alınırken ki hata payını minimum hale getirmek için bu değeri true olarak kullanabilirsiniz. Varsayılan olarak false olan bu değer; true olduğunda mümkün olan en iyi konumu bulmaya çalışacaktır.

Bu küçük örneğimizde, GeoLocation API’nin görsel olarak bir çıktıya ulaşabilmesi için Google Maps’in sağlamış olduğu iframe’i kullandım. URL içerisinde verebildiğiniz lat ve long değerlerine ait konumu iframe içerisinde başarılı bir şekilde görüntüleyebiliyor.

Küçük bir güvenlik önlemi olarak ekstra uzaklaştırdım ve sol üstte bulunan adres alanını kaldırdım :)

Bu serideki amacım, aslında sadece tarayıcınızın sağladığı kaynaklarla bile bir çok farklı uygulama geliştirebilir olduğunuzu hatırlatmak ve küçük bir farkındalık yaratmaktır :)

Acaba tarayıcımızın kabiliyetlerini ne kadar biliyoruz?

Zaman ayırdığınız için teşekkürler…