Releases: par274/depremler-api
1.0.2
Depremler API Versiyon 1.0.2
Güncellemeler
- Templater sınıfı composer ile dahil edildi. simple-templater
Kurulum ve diğer talimatlar için readme.md dosyasını okuyun.
Depremler API (1.0.1)
Depremler API Versiyon 1.0.1
Güncellemeler
- Google Maps linki eklendi.
Kurulum ve diğer talimatlar için readme.md dosyasını okuyun.
Depremler API (1.0)
Depremler API
Son depremleri anlık olarak çeker ve tablo, Json veya Xml formatlarında okunabilir. Projelerinizde API olarak kullanılabilir.
Kurulum
Gerekenler
- Composer
- PHP 7.4+
Dosyaları indirin.
cd src
composer update
Kullanım
Kodlarınızı eğer bu kütüphane içinde yazacaksanız, app.php dosyasındaki RenderPlatformDirect() fonksiyonu içine yazmalısınız.
<?php
/**
* Gelen veri Json veya XML olabilir.
* Api.php dosyasını inceleyin $output verisi Array olarak gelmekte.
* index.php?json, index.php?xml şeklinde GET ile de çekebilirsiniz.
* Native API olarakta kullanabilirsiniz.
*/
foreach ($data['data'] as $item)
{
echo $item['date']['humanreadable']; //Okunabilen tarih damgası. 11 Ocak Çarşamba 2023, 00:51 gibi.
echo $item['date']['date']; //Tarih.
echo $item['date']['time']; //Saat.
echo $item['geo']['full']; // Enlem, boylam.
echo $item['geo']['latitude']; //Enlem.
echo $item['geo']['longitude']; //Boylam.
echo $item['depth']; //Derinlik (km).
echo $item['ml']; //Şiddeti.
echo $item['location']['full']; //Tam bölge adı.
echo $item['location']['city']; //Şehir.
echo $item['location']['state']; //Bölge/Eyalet.
echo $item['accuracy']; //Doğruluk. İlksel veya revize belirtir.
}
?>
Örnekler
Bunun için direkt Index çalıştırabilirsiniz veya src/View/view.table.php dosyasına göz atabilirsiniz. Bütün örnekler ve tablo tasarımı bu dosyadadır.
Json çıktısı:
{
"status": "ok",
"data": [
{
"date": {
"humanreadable": "11 Ocak Çarşamba 2023, 03:58",
"date": "11-01-2023",
"time": "03:58"
},
"geo": {
"full": "39.3653, 26.2570",
"latitude": "39.3653",
"longitude": "26.2570"
},
"depth": "4.7",
"ml": "2.7",
"location": {
"full": "Midilli Adasi (ege Denizi)",
"city": "Midilli Adasi",
"state": "Ege Denizi"
},
"accuracy": "İlksel"
}
]
}
XML çıktısı
<?xml version="1.0" encoding="utf-8"?>
<response>
<status>ok</status>
<data>
<date>
<humanreadable>11 Ocak Çarşamba 2023, 03:58</humanreadable>
<date>11-01-2023</date>
<time>03:58</time>
</date>
<geo>
<full>39.3653, 26.2570</full>
<latitude>39.3653</latitude>
<longitude>26.2570</longitude>
</geo>
<depth>4.7</depth>
<ml>2.7</ml>
<location>
<full>Midilli Adasi (ege Denizi)</full>
<city>Midilli Adasi</city>
<state>Ege Denizi</state>
</location>
<accuracy>İlksel</accuracy>
</data>
</response>
Hata çıktıları
Hata çıktıları cevaplardaki status dizisinde belirtilir ve cevabın tipi URL sorgusuna göre döner. URL'de xml varsa xml, değilse json dönecektir.
{
"status": "fail-response-error",
"message": "The connection to the site could not be established."
}
<response>
<status>fail-response-error</status>
<message>
The connection to the site could not be established.
</message>
</response>
fail-response-error
The connection to the site could not be established.
Altyapı
Projede Par2 adını verdiğim bir uygulama çatısının basit bir hali kullanılmıştır. Proje içinde özel template sınıfları var. Genel olarak Symfony komponentleri kullanılmıştır.
Kullanılan komponentler
- Guzzle/Guzzle
- Symfony/Serializer
- Symfony/DomCrawler
- Nesbot/Carbon
- Bootstrap 4 & DataTables & jQuery
Lisans
Bu kütüphanenin lisansı MIT(MIT License)'dir. Satışı yapılamaz ancak kullanabilirsiniz.
Daha fazla bilgi için bu dosyaya göz atabilirsiniz.