izmir-open-data-js 1.0.0 → 1.1.0

package/README.md

@@ -14,6 +14,7 @@
 * 📊 **Geniş Veri Yelpazesi:** Eczanelerden ulaşım ağlarına kadar birçok veriye erişim.
 * 🔄 **Modern Yapı:** `async/await` desteği ile temiz ve okunabilir kod.
 * 🏗️ **Esnek:** Hem Node.js hem de modern tarayıcı ortamlarında kullanılabilir.
+* 📦 **CKAN Desteği:** Açık veri portalının CKAN API'si üzerinden detaylı veri setlerine erişim.
 
 ---
 
@@ -51,6 +52,37 @@ async function verileriGetir() {
 verileriGetir();
 ```
 
+### Örnek: ESHOT Hat ve Durak Bilgileri (CKAN)
+
+```javascript
+import { IzmirAPI } from 'izmir-open-data-js';
+
+const api = new IzmirAPI();
+
+async function eshotVerileri() {
+  // Tüm ESHOT hatlarını çek
+  const hatlar = await api.eshot.getHatlar();
+  console.log(`Toplam ${hatlar.total} hat bulundu`);
+  
+  // İlk 10 hattı göster
+  hatlar.records.slice(0, 10).forEach(hat => {
+    console.log(`Hat ${hat.HAT_NO}: ${hat.HAT_ADI}`);
+  });
+
+  // Tüm durakları çek (sayfalama ile)
+  const duraklar = await api.eshot.getDuraklar(100, 0);
+  console.log(`Toplam ${duraklar.total} durak mevcut`);
+
+  // Otopark ücretlerini çek
+  const ucretler = await api.otopark.getUcretler();
+  ucretler.records.forEach(otopark => {
+    console.log(`${otopark["Otopark / Fiyat"]}: ${otopark["0-2 saat"]} TL (0-2 saat)`);
+  });
+}
+
+eshotVerileri();
+```
+
 ---
 
 ## 📋 Tüm Endpoint'ler
@@ -102,6 +134,11 @@ verileriGetir();
 | `getDuragaYaklasanOtobusList(durakId)` | Bir durağa yaklaşan otobüsleri listeler |
 | `getHattinYaklasanOtobusleri(hatId, durakId)` | Bir hattın durağa yaklaşan otobüslerini listeler |
 | `getHatOtobusKonumlari(hatId)` | Hatta ait otobüslerin anlık konum bilgilerini döner |
+| `getHatlar(limit, offset)` | ESHOT hat bilgilerini döner (CKAN) |
+| `getHareketSaatleri(limit, offset)` | Otobüs hareket saatlerini döner (CKAN) |
+| `getDuraklar(limit, offset)` | Tüm ESHOT duraklarını listeler (CKAN) |
+| `getHatGuzergahlari(limit, offset)` | Hat güzergah koordinatlarını döner (CKAN) |
+| `getBaglantiTipleri(limit, offset)` | Diğer ulaşım araçları ile bağlantı tiplerini döner (CKAN) |
 
 ### 🚲 Ulaşım - BİSİM (`api.bisim`)
 
@@ -155,6 +192,7 @@ verileriGetir();
 | Metot | Açıklama |
 | :--- | :--- |
 | `getList()` | Otoparkların doluluk ve konum bilgilerini döner |
+| `getUcretler(limit, offset)` | İzelman otopark ücretlerini döner (CKAN) |
 
 ### 🚕 Taksi (`api.taksi`)
 

package/dist/client.d.ts

@@ -1,5 +1,20 @@
 export declare class IzmirClient {
     private readonly baseUrl;
-    constructor(baseUrl?: string);
+    private readonly ckanBaseUrl;
+    private fetchJsonp;
+    constructor(baseUrl?: string, ckanBaseUrl?: string);
     get(path: string): Promise<any>;
+    /**
+     * CKAN API'den veri çeker.
+     * Tarayıcıda JSONP, Node.js'de normal fetch kullanır.
+     */
+    getCKAN<T = any>(action: string, params?: Record<string, string | number>): Promise<T>;
+    /**
+     * JSONP ile CKAN API çağrısı (tarayıcı için)
+     */
+    private getCKANWithJsonp;
+    /**
+     * Normal fetch ile CKAN API çağrısı (Node.js için)
+     */
+    private getCKANWithFetch;
 }

package/dist/client.js

@@ -1,6 +1,10 @@
+// Node.js ortamında window yoktur, tarayıcıda JSONP kullanılır
+const isBrowser = typeof window !== 'undefined';
 export class IzmirClient {
-    constructor(baseUrl = "https://openapi.izmir.bel.tr/api/") {
+    constructor(baseUrl = "https://openapi.izmir.bel.tr/api/", ckanBaseUrl = "https://acikveri.bizizmir.com/api/3/action/") {
+        this.fetchJsonp = null;
         this.baseUrl = baseUrl;
+        this.ckanBaseUrl = ckanBaseUrl;
     }
     async get(path) {
         const res = await fetch(this.baseUrl + path);
@@ -9,4 +13,74 @@ export class IzmirClient {
         }
         return res.json();
     }
+    /**
+     * CKAN API'den veri çeker.
+     * Tarayıcıda JSONP, Node.js'de normal fetch kullanır.
+     */
+    async getCKAN(action, params = {}) {
+        const queryParams = new URLSearchParams();
+        for (const [key, value] of Object.entries(params)) {
+            queryParams.append(key, String(value));
+        }
+        const url = `${this.ckanBaseUrl}${action}?${queryParams.toString()}`;
+        if (isBrowser) {
+            return this.getCKANWithJsonp(url);
+        }
+        else {
+            return this.getCKANWithFetch(url);
+        }
+    }
+    /**
+     * JSONP ile CKAN API çağrısı (tarayıcı için)
+     */
+    async getCKANWithJsonp(url) {
+        try {
+            // Lazy load fetch-jsonp
+            if (!this.fetchJsonp) {
+                const module = await import('fetch-jsonp');
+                this.fetchJsonp = module.default;
+            }
+            const response = await this.fetchJsonp(url, {
+                jsonpCallback: 'callback',
+                timeout: 10000,
+            });
+            const data = await response.json();
+            if (data.success) {
+                return data.result;
+            }
+            else {
+                throw new Error(data.error?.message || "API verisi alınamadı");
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`JSONP Hatası: ${error.message}`);
+            }
+            throw new Error("Bilinmeyen JSONP hatası");
+        }
+    }
+    /**
+     * Normal fetch ile CKAN API çağrısı (Node.js için)
+     */
+    async getCKANWithFetch(url) {
+        try {
+            const res = await fetch(url);
+            if (!res.ok) {
+                throw new Error(`CKAN API response error: ${res.status}`);
+            }
+            const data = await res.json();
+            if (data.success) {
+                return data.result;
+            }
+            else {
+                throw new Error(data.error?.message || "API verisi alınamadı");
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`CKAN Hatası: ${error.message}`);
+            }
+            throw new Error("Bilinmeyen CKAN hatası");
+        }
+    }
 }

package/dist/endpoints/eshot.d.ts

@@ -2,6 +2,67 @@ import { IzmirClient } from "../client";
 import { DefaultOnemliYer, OnemliYerWrapper } from "../common/types/onemliYer";
 export interface EshotDurak extends DefaultOnemliYer {
 }
+/**
+ * ESHOT hat bilgisi (CKAN datasından)
+ */
+export interface EshotHat {
+    _id: number;
+    HAT_NO: number;
+    HAT_ADI: string;
+    GUZERGAH_ACIKLAMA: string;
+    ACIKLAMA: string;
+    HAT_BASLANGIC: string;
+    HAT_BITIS: string;
+}
+/**
+ * ESHOT otobüs hareket saati bilgisi (CKAN datasından)
+ */
+export interface EshotHareketSaati {
+    _id: number;
+    HAT_NO: number;
+    TARIFE_ID: number;
+    GIDIS_SAATI: string;
+    DONUS_SAATI: string;
+    SIRA: number;
+    GIDIS_ENGELLI_DESTEGI: string;
+    DONUS_ENGELLI_DESTEGI: string;
+    BISIKLETLI_GIDIS: string;
+    BISIKLETLI_DONUS: string;
+    GIDIS_ELEKTRIKLI_OTOBUS: string;
+    DONUS_ELEKTRIKLI_OTOBUS: string;
+}
+/**
+ * ESHOT otobüs durağı bilgisi (CKAN datasından)
+ */
+export interface EshotDurakCKAN {
+    _id: number;
+    DURAK_ID: number;
+    DURAK_ADI: string;
+    ENLEM: number;
+    BOYLAM: number;
+    DURAKTAN_GECEN_HATLAR: string;
+}
+/**
+ * ESHOT hat güzergah noktası bilgisi (CKAN datasından)
+ */
+export interface EshotHatGuzergah {
+    _id: number;
+    HAT_NO: number;
+    /** Güzergah yönü: 1 = Gidiş, 2 = Dönüş */
+    YON: number;
+    BOYLAM: number;
+    ENLEM: number;
+}
+/**
+ * ESHOT bağlantı tipi bilgisi (CKAN datasından)
+ * Otobüs hatlarının diğer ulaşım araçları ile bağlantı tipleri
+ */
+export interface EshotBaglantiTipi {
+    _id: number;
+    BAGLANTI_TIP_ID: number;
+    /** Bağlantı tipi adı (METRO, IZBAN, VAPUR, TRAMVAY, vb.) */
+    BAGLANTI_TIPI: string;
+}
 /**
  * Durağa yaklaşan otobüs bilgisi
  */
@@ -23,7 +84,64 @@ export interface HatOtobusKonumlariResponse {
     HataMesaj: string;
     HatOtobusKonumlari: YaklasanOtobus[];
 }
+/**
+ * CKAN datastore_search response tipi
+ */
+export interface CKANDatastoreResponse<T> {
+    include_total: boolean;
+    resource_id: string;
+    fields: {
+        type: string;
+        id: string;
+    }[];
+    records_format: string;
+    records: T[];
+    limit: number;
+    total: number;
+}
 export declare function eshot(client: IzmirClient): {
+    /**
+     * ESHOT hatlarının listesini içeren web servisi (CKAN).
+     *
+     * Kaynak: https://acikveri.bizizmir.com/dataset/eshot-hat-bilgileri
+     * @param limit Döndürülecek kayıt sayısı (varsayılan: 100)
+     * @param offset Atlanacak kayıt sayısı (sayfalama için)
+     */
+    getHatlar(limit?: number, offset?: number): Promise<CKANDatastoreResponse<EshotHat>>;
+    /**
+     * ESHOT otobüs hareket saatlerini içeren web servisi (CKAN).
+     *
+     * Kaynak: https://acikveri.bizizmir.com/dataset/eshot-otobus-hareket-saatleri
+     * @param limit Döndürülecek kayıt sayısı (varsayılan: 100)
+     * @param offset Atlanacak kayıt sayısı (sayfalama için)
+     */
+    getHareketSaatleri(limit?: number, offset?: number): Promise<CKANDatastoreResponse<EshotHareketSaati>>;
+    /**
+     * ESHOT otobüs duraklarının listesini içeren web servisi (CKAN).
+     *
+     * Kaynak: https://acikveri.bizizmir.com/dataset/eshot-duraklari
+     * @param limit Döndürülecek kayıt sayısı (varsayılan: 100)
+     * @param offset Atlanacak kayıt sayısı (sayfalama için)
+     */
+    getDuraklar(limit?: number, offset?: number): Promise<CKANDatastoreResponse<EshotDurakCKAN>>;
+    /**
+     * ESHOT hat güzergahlarını içeren web servisi (CKAN).
+     * Her hat için gidiş (YON=1) ve dönüş (YON=2) koordinat noktalarını içerir.
+     *
+     * Kaynak: https://acikveri.bizizmir.com/dataset/eshot-hat-guzergahlari
+     * @param limit Döndürülecek kayıt sayısı (varsayılan: 100)
+     * @param offset Atlanacak kayıt sayısı (sayfalama için)
+     */
+    getHatGuzergahlari(limit?: number, offset?: number): Promise<CKANDatastoreResponse<EshotHatGuzergah>>;
+    /**
+     * Otobüs hatlarının diğer ulaşım araçları ile bağlantı tiplerini içeren web servisi (CKAN).
+     * Metro, İzban, Vapur, Tramvay gibi bağlantı tiplerini listeler.
+     *
+     * Kaynak: https://acikveri.bizizmir.com/dataset/otobus-hatlarinin-diger-ulasim-araclari-ile-baglanti-tipleri
+     * @param limit Döndürülecek kayıt sayısı (varsayılan: 100)
+     * @param offset Atlanacak kayıt sayısı (sayfalama için)
+     */
+    getBaglantiTipleri(limit?: number, offset?: number): Promise<CKANDatastoreResponse<EshotBaglantiTipi>>;
     /**
      * ESHOT duraklarının konum, isim ve diğer bilgilerini içeren web servisi.
      *

package/dist/endpoints/eshot.js

@@ -1,5 +1,77 @@
 export function eshot(client) {
     return {
+        /**
+         * ESHOT hatlarının listesini içeren web servisi (CKAN).
+         *
+         * Kaynak: https://acikveri.bizizmir.com/dataset/eshot-hat-bilgileri
+         * @param limit Döndürülecek kayıt sayısı (varsayılan: 100)
+         * @param offset Atlanacak kayıt sayısı (sayfalama için)
+         */
+        getHatlar(limit = 100, offset = 0) {
+            return client.getCKAN('datastore_search', {
+                resource_id: 'bd6c84f8-49ba-4cf4-81f8-81a0fbb5caa3',
+                limit,
+                offset
+            });
+        },
+        /**
+         * ESHOT otobüs hareket saatlerini içeren web servisi (CKAN).
+         *
+         * Kaynak: https://acikveri.bizizmir.com/dataset/eshot-otobus-hareket-saatleri
+         * @param limit Döndürülecek kayıt sayısı (varsayılan: 100)
+         * @param offset Atlanacak kayıt sayısı (sayfalama için)
+         */
+        getHareketSaatleri(limit = 100, offset = 0) {
+            return client.getCKAN('datastore_search', {
+                resource_id: 'c6fa6046-f755-47d7-b69e-db6bb06a8b5a',
+                limit,
+                offset
+            });
+        },
+        /**
+         * ESHOT otobüs duraklarının listesini içeren web servisi (CKAN).
+         *
+         * Kaynak: https://acikveri.bizizmir.com/dataset/eshot-duraklari
+         * @param limit Döndürülecek kayıt sayısı (varsayılan: 100)
+         * @param offset Atlanacak kayıt sayısı (sayfalama için)
+         */
+        getDuraklar(limit = 100, offset = 0) {
+            return client.getCKAN('datastore_search', {
+                resource_id: '0c791266-a2e4-4f14-82b8-9a9b102fbf94',
+                limit,
+                offset
+            });
+        },
+        /**
+         * ESHOT hat güzergahlarını içeren web servisi (CKAN).
+         * Her hat için gidiş (YON=1) ve dönüş (YON=2) koordinat noktalarını içerir.
+         *
+         * Kaynak: https://acikveri.bizizmir.com/dataset/eshot-hat-guzergahlari
+         * @param limit Döndürülecek kayıt sayısı (varsayılan: 100)
+         * @param offset Atlanacak kayıt sayısı (sayfalama için)
+         */
+        getHatGuzergahlari(limit = 100, offset = 0) {
+            return client.getCKAN('datastore_search', {
+                resource_id: '543f2249-c734-48e4-8739-72efbbfc843c',
+                limit,
+                offset
+            });
+        },
+        /**
+         * Otobüs hatlarının diğer ulaşım araçları ile bağlantı tiplerini içeren web servisi (CKAN).
+         * Metro, İzban, Vapur, Tramvay gibi bağlantı tiplerini listeler.
+         *
+         * Kaynak: https://acikveri.bizizmir.com/dataset/otobus-hatlarinin-diger-ulasim-araclari-ile-baglanti-tipleri
+         * @param limit Döndürülecek kayıt sayısı (varsayılan: 100)
+         * @param offset Atlanacak kayıt sayısı (sayfalama için)
+         */
+        getBaglantiTipleri(limit = 100, offset = 0) {
+            return client.getCKAN('datastore_search', {
+                resource_id: 'c228da75-adfd-422a-a480-2a4c7ffa7586',
+                limit,
+                offset
+            });
+        },
         /**
          * ESHOT duraklarının konum, isim ve diğer bilgilerini içeren web servisi.
          *

package/dist/endpoints/otopark.d.ts

@@ -1,4 +1,5 @@
 import { IzmirClient } from "../client";
+import { CKANDatastoreResponse } from "./eshot";
 export interface OtoparkBilgisi {
     ufid: string;
     name: string;
@@ -44,6 +45,58 @@ export interface OtoparkBilgisi {
         cctv: boolean;
     };
 }
+/**
+ * İzelman otopark ücret bilgisi (CKAN datasından)
+ */
+export interface OtoparkUcreti {
+    _id: number;
+    /** Otopark adı */
+    "Otopark / Fiyat": string;
+    /** 0-1 saat ücreti */
+    "0-1 Saat": number | null;
+    /** 0-2 saat ücreti */
+    "0-2 saat": number | null;
+    /** 2-4 saat ücreti */
+    "2-4 saat": number | null;
+    /** 4-6 saat ücreti */
+    "4-6 saat": number | null;
+    /** 0-3 saat ücreti */
+    "0-3 saat": string | null;
+    /** 0-6 saat ücreti */
+    "0-6 saat": number | null;
+    /** 3-6 saat ücreti */
+    "3-6 saat": string | null;
+    /** 6-12 saat ücreti */
+    "6-12 saat": number | null;
+    /** 1-12 saat ücreti */
+    "1-12 saat": number | null;
+    /** 0-12 saat ücreti */
+    "0-12 saat": number | null;
+    /** 12-24 saat ücreti */
+    "12-24 saat": number | null;
+    /** 0-24 saat ücreti */
+    "0-24 saat": number | null;
+    /** 0-12 saat motosiklet ücreti */
+    "0-12 Saat(Motosiklet )": number | null;
+    /** 12-24 saat motosiklet ücreti */
+    "12-24 Saat(Motosiklet )": number | null;
+    /** 0-24 saat motosiklet ücreti */
+    "0-24 Saat(Motosiklet )": number | null;
+    /** Kayıp bilet ücreti */
+    "Kayıp Bilet": number | null;
+    /** Aylık abone ücreti */
+    "Aylık Abone Ücreti": number | null;
+    /** Aylık alan abonelik ücreti */
+    "Aylık Alan Abonelik Ücreti": number | null;
+    /** Motosiklet aylık abone ücreti */
+    "Motosiklet Aylık Abone Ücreti": number | null;
+    /** 0-12 saat engelli aracı ücreti */
+    "0-12 Saat(Engelli Aracı )": number | null;
+    /** 12-24 saat engelli aracı ücreti */
+    "12-24 Saat(Engelli Aracı )": number | null;
+    /** 0-24 saat engelli aracı ücreti */
+    "0-24 Saat(Engelli Aracı )": number | null;
+}
 export declare function otopark(client: IzmirClient): {
     /**
      * Otoparkların konumu, dolu-boş adetleri, çalışma saatleri bilgilerini içeren web servisi.
@@ -51,4 +104,13 @@ export declare function otopark(client: IzmirClient): {
      * Kaynak: https://acikveri.bizizmir.com/dataset/otopark-doluluk-ve-lokasyon-bilgileri
      */
     getList(): Promise<OtoparkBilgisi[]>;
+    /**
+     * İzelman otopark ücretlerini içeren web servisi (CKAN).
+     * Her otopark için farklı saat dilimleri ve araç tiplerinin ücret bilgilerini içerir.
+     *
+     * Kaynak: https://acikveri.bizizmir.com/dataset/izelman-otopark-ucretleri
+     * @param limit Döndürülecek kayıt sayısı (varsayılan: 100)
+     * @param offset Atlanacak kayıt sayısı (sayfalama için)
+     */
+    getUcretler(limit?: number, offset?: number): Promise<CKANDatastoreResponse<OtoparkUcreti>>;
 };

package/dist/endpoints/otopark.js

@@ -7,6 +7,21 @@ export function otopark(client) {
          */
         getList() {
             return client.get("izum/otoparklar");
+        },
+        /**
+         * İzelman otopark ücretlerini içeren web servisi (CKAN).
+         * Her otopark için farklı saat dilimleri ve araç tiplerinin ücret bilgilerini içerir.
+         *
+         * Kaynak: https://acikveri.bizizmir.com/dataset/izelman-otopark-ucretleri
+         * @param limit Döndürülecek kayıt sayısı (varsayılan: 100)
+         * @param offset Atlanacak kayıt sayısı (sayfalama için)
+         */
+        getUcretler(limit = 100, offset = 0) {
+            return client.getCKAN('datastore_search', {
+                resource_id: 'b45d2e9f-f258-476e-a12d-d0ff62471ee0',
+                limit,
+                offset
+            });
         }
     };
 }

package/dist/index.d.ts

@@ -40,6 +40,11 @@ export declare class IzmirAPI {
         getGunlukHavaKalitesiOlcumleri(tarih: Date): Promise<import("./endpoints/iklim").HavaKalitesiOlcum[]>;
     };
     eshot: {
+        getHatlar(limit?: number, offset?: number): Promise<import("./endpoints/eshot").CKANDatastoreResponse<import("./endpoints/eshot").EshotHat>>;
+        getHareketSaatleri(limit?: number, offset?: number): Promise<import("./endpoints/eshot").CKANDatastoreResponse<import("./endpoints/eshot").EshotHareketSaati>>;
+        getDuraklar(limit?: number, offset?: number): Promise<import("./endpoints/eshot").CKANDatastoreResponse<import("./endpoints/eshot").EshotDurakCKAN>>;
+        getHatGuzergahlari(limit?: number, offset?: number): Promise<import("./endpoints/eshot").CKANDatastoreResponse<import("./endpoints/eshot").EshotHatGuzergah>>;
+        getBaglantiTipleri(limit?: number, offset?: number): Promise<import("./endpoints/eshot").CKANDatastoreResponse<import("./endpoints/eshot").EshotBaglantiTipi>>;
         getYakinDurakList(enlem: number, boylam: number): Promise<import("./common/types/onemliYer.js").OnemliYerWrapper<import("./endpoints/eshot").EshotDurak>>;
         getDuragaYaklasanOtobusList(durakId: number): Promise<import("./endpoints/eshot").YaklasanOtobus[]>;
         getHattinYaklasanOtobusleri(hatId: number, durakId: number): Promise<import("./endpoints/eshot").YaklasanOtobus[]>;
@@ -64,6 +69,7 @@ export declare class IzmirAPI {
     };
     otopark: {
         getList(): Promise<import("./endpoints/otopark").OtoparkBilgisi[]>;
+        getUcretler(limit?: number, offset?: number): Promise<import("./endpoints/eshot").CKANDatastoreResponse<import("./endpoints/otopark").OtoparkUcreti>>;
     };
     hizmet: {
         getHizmetNoktaList(): Promise<import("./common/types/onemliYer.js").OnemliYerWrapper<import("./endpoints/hizmet").HizmetNoktasi>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "izmir-open-data-js",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Izmir Open Data API wrapper - İzmir Büyükşehir Belediyesi Açık Veri API'leri için TypeScript/JavaScript kütüphanesi",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -13,7 +13,9 @@
     "typescript",
     "eshot",
     "izban",
-    "metro"
+    "metro",
+    "ckan",
+    "otopark"
   ],
   "author": "Ata",
   "license": "MIT",
@@ -30,6 +32,7 @@
     "dist"
   ],
   "devDependencies": {
+    "@types/fetch-jsonp": "^1.0.0",
     "@types/node": "^25.4.0",
     "@vitest/coverage-v8": "^3.2.4",
     "@vitest/expect": "^4.0.18",
@@ -45,5 +48,8 @@
     "test:live": "LIVE_API_TESTS=1 vitest run tests/integration/",
     "test:all": "LIVE_API_TESTS=1 vitest run",
     "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "fetch-jsonp": "^1.4.0"
   }
 }