API / Webservis

Denizdurumu API nedir?

Denizdurumu.com API uygulama/yazılım geliştiriciler için hazırlanmış olan bir web servisdir. Bu web servis sayesinde şehir ve denizlerimizde ki hava durumu bilgilerini rahatlıkla kendi uygulamanıza dahil edebilirsiniz. Denizdurumu webservisi bir çok yazılım platform uyumlu olacak şekilde dünya standartlarında kullanıma sunulmuştur. Bu servis denizdurumu.com ‘ un yüksek teknolojisi ile entegre olarak çalışmakta ve eş zamanlı güncellenmektedir.

Api anahtarı nedir?

Denizdurumu web servisini kullanmanız için gerekli olan anahtardır. Bu anahtar sizin kimliğiniz gibidir. Anahtar sayesinde denizdurumu webservisine bağlanıp verileri alabilirsiniz. Api anahtarı almak için tıklayın.

Güvenlik

Denizdurumu webservisini kullanmak için almış olduğunuz anahtarın güvenliği size aittir. Anahtar başvurusu sırasında bize vermiş olduğunuz bilgiler kesinlikle üçüncü kişilerle yada firmalarla paylaşmayacaktır.

Nasıl kullanılır?

Öncelikle başvuru sayfasından kendinize ait bir anahtar almanız gerekmektedir. Almış olduğunuz anahtar sayesinde webservise bağlanabilirsiniz. Denizdurumu webservisi GET metodu ile çalışmaktadır ve yapmış olduğunuz isteklerin sonuçları JSON formatında getirilir. Yapmış olduğunuz isteklere gelen sonuçlar UTF-8 formatındadır. Türkçe karakterler utf-8 ve json encoded yani ı => \u0131 olarak çevrilir. Aşşağıda anlatılan servis adresleri ve açıklamalı örnekler için anahtar değeri TEST olarak kullanılmıştır. Kendi uygulamanız için TEST yazılı olan kısmı kendi anahtarınız ile değiştirmeniz gerekmektedir.

1 - İstasyonların listesi

Bütün istasyonların isimleri, türleri ve istek için kullanılan anahtarların listesi. type: "CITY" olan istasyonlar şehirleri, type: "SEA" olan istasyonlarda deniz merkezlerini ifade etmektedir.

İstek şekli ve adres :

http://api.denizdurumu.com/stations/?apikey=TEST

Sonuç:

[
    {"name":"Adana","key":"C1","type":"CITY"},
    {"name":"Ad\u0131yaman","key":"C2","type":"CITY"},
    {"name":"Afyonkarahisar","key":"C3","type":"CITY"}
    ...
    {"name":"Fethiye","key":"S105","type":"SEA"},
    ...
]

2 - Şehirlerin hava durum bilgisi

Şehirlerin hava durumu için istasyon listesinde bulunan key değerini kullanıyoruz.

Örnek: Adana için hava durumu bilgisi alırken

İstek şekli ve adres : http://api.denizdurumu.com/city/C1/?apikey=TEST

Sonuç:

[ {
    "status":"Bulutlu",
    "date":"2010-06-28",
    "wind":{
                "speed":"19 km",
                "direction":"G\u00fcneybat\u0131dan"
           } ,
    "maxheat":"31",
    "minheat":"21",
    "maxhumidity":"91",
    "minhumidity":"46"
} ]

3 - Deniz merkezlerinde ki durum bilgisi

Deniz merkezlerinde ki durumular için istasyon listesinde bulunan key değerini kullanıyoruz. Deniz merkezleri için verilen üç (3) saatlik aralıklarla 8 parçada verilmektedir.

Örnek: Fethiye için deniz durumu bilgisi alırken

İstek şekli ve adres : http://api.denizdurumu.com/sea/S105/?apikey=TEST

Sonuç:

[
    {
        "cloud":"ACIK",
        "wind":{"speed":"6 knot","direction":"n"},
        "pressure":"953",
        "precipitation":"0.00",
        "status":"a\u00e7\u0131k",
        "datetime":"2010-06-28 02:00:00"
    },{
        "cloud":"AZ",
        "wind":{"speed":"6 knot","direction":"nne"},
        "pressure":"953",
        "precipitation":"0.00",
        "status":"a\u00e7\u0131k",
        "datetime":"2010-06-28 05:00:00"
    },{
        ...
        ...
    },{
        "cloud":"ACIK",
        "wind":{"speed":"6 knot","direction":"wsw"},
        "pressure":"955",
        "precipitation":"0.00",
        "status":"a\u00e7\u0131k",
        "datetime":"2010-06-28 23:00:00"
    }
]

4 - GPS bilgilerine göre sorulama

Denizdurumu webservisi GPS / Yer bulma teknolojisini desteklektedir. GPS cihazından yada cep telefonundan alınan enlem boylam bilgilerine göre bulunduğunuz konuma en yakın 5 yerin hava ve deniz durumu bilgilerini alabilirsiniz.

Örnek: GPS bilgisine göre kullanımı

İstek şekli ve adres : http://api.denizdurumu.com/geo/?apikey=TEST&lat=32.4011&lng=33.8761

Sonuç:


[   {
        "ID":"90",
        "TYPE":"SEA",
        "NAME":"Anamur",
        "LNG":"36",
        "LAT":"32.83",
        "distance":"2.16677327378754"
    },
    ...
    ...
    {
        "ID":"155",
        "TYPE":"SEA",
        "NAME":"Ta\u015fucu",
        "LNG":"36.29",
        "LAT":"33.94",
        "distance":"2.86271312219719"
    }
]

Denizdurumu API nedir?

Api anahtarı nedir?

Güvenlik

Nasıl kullanılır?

1 - İstasyonların listesi

2 - Şehirlerin hava durum bilgisi

3 - Deniz merkezlerinde ki durum bilgisi

4 - GPS bilgilerine göre sorulama

İçerik

Örnek uygulamalar