KOCAELİ TİCARİ TAKSİ GÜVENLİK SİSTEMİNE UYUMLULUĞU SAĞLAYAN WEB SERVİSLERİ BİLGİ DÖKÜMANI

(1)

EK-1:

KOCAELİ TİCARİ TAKSİ GÜVENLİK SİSTEMİNE UYUMLULUĞU SAĞLAYAN WEB SERVİSLERİ BİLGİ DÖKÜMANI

1. AMAÇ

13.12.2016 tarihli ve 2016/271 sayılı UKOME kararı ile kurulması önerilen Ticari Taksi Güvenlik Sistemine uyum sağlamak isteyen Güvenlik Sistemi Servis Sağlayıcılarının geliştirmesi ve kullanması gereken web servislerinin tanıtımı için bilgi dokümanıdır.

2. TANIMLAR

Ticari Taksi Güvenlik Sistemi (TTGS): Ticari taksilere kurulması planlanan araç takip sistemi, panik butonu ve araç içi kamera siteminden oluşan güvenlik ve izleme sistemi.

Güvenlik Sistemi Servis Sağlayıcı (GSSS): Kocaeli Büyükşehir Belediyesi sınırları içinde faaliyette bulunan ticari taksilere kurulacak Ticari Taksi Güvenlik Sisteminin montaj, bakım ve hizmetini sağlayan kurum ya da işletmeler.

İdare: Kocaeli Büyükşehir Belediyesi.

Mobil Cihaz: Ticari taksiler üzerine monte edilecek olan araç konum bilgisi, aracın durumu, seyrine ilişkin bilgiler ile idarece oluşturulan iletişim protokolü kapsamında belirlenen diğer bilgilerin ilgili birimlere aktarılmasını sağlayan, araç takip sistemi, panik butonu ve araç içi kamera sisteminden oluşan cihaz.

3. GÜVENLİK UserInfo sınıfı:

Tüm web servis metotları UserInfo sınıfında parametre alır.

No Özellik adı Veri tipi Açıklama

1 UserName string Kullanıcı adı

2 Password string Şifre

ServiceMessage sınıfı:

Çağrılan tüm metotlar hata durumlarına karşı ServiceMessage sınıfında sonuç döndürür.

1 Status bool Başarılı, başarısız

2 Message string Mesaj (Hata, bilgilendirme, v.b.)

(2)

4. SINIFLAR Location sınıfı:

1 VehicleId string Araç plaka bilgisi, boşluksuz tümü büyük harf.

2 RecordDate datetime Kayıt tarihi

3 GpsDate datetime Gps Tarihi

4 GpsAccuracy double Gps doğruluk

5 Latitude double Enlem

6 Longitude double Boylam

7 Speed double Hız

8 Altitude double İrtifa

9 Odm double Odometre

10 Direction double Yön

11 Trademark string Marka: TTGS marka ismi.

12 Firm string Firma ismi: GSSS firma ismi.

13 Owner string Cihaz sahibi: araç takip cihazının üzerine kayıtlı olduğu kişi

14 Transporter string Cihaz sahibi: araç takip cihazının üzerine kayıtlı firma

Alarm sınıfı:

1 AlarmType string Alarm tipi

2 AlarmMessage string Alarm mesajı

AlarmResult sınıfı:

1 Alarm Alarm Alarm bilgileri

2 Location Location Konum bilgileri

(3)

5. GSSS FİRMALARININ GELİŞTİRMESİ GEREKEN WEB SERVİSLERİ 5.1. KBBDoesVehicleHaveSafetySystem(UserInfo User, String VehicleID )

Herhangi bir araçta uyumlu bir GSSS firması tarafından montajı ve sözleşmesi yapılmış bir araç güvenlik sisteminin olup olmadığını kontrol eder. Plakası verilen araç üzerinde takip sistemine kayıtlı bir mobil cihazın olup olmadığını sorgulayan yöntemin giriş/çıkış parametreleri aşağıdaki tabloda verilmiştir.

Giriş Parametreleri

No Parametre adı Veri tipi Açıklama

1 User UserInfo Kullanıcı bilgileri

Çıkış Parametreleri

No Veri tipi Açıklama

1 Bool (ThereIs) True: Sistemde kayıtlı False:Sistemde kayıtlı değil

2 string (VehicleId) Araç plaka bilgisi, boşluksuz tümü büyük harf.

3 bool (IsActive)

Araç takip cihazının sorunsuz çalışıp çalışmadığı, True: Sorunsuz çalışıyor

False: Çalışmıyor 4 datetime (StartDate) Sözleşme tarihi

5 string (Trademark) Marka: TTGS marka ismi.

6 string (Firm) Firma ismi: GSSS firma ismi.

7 string (Owner) Cihaz sahibi: araç takip cihazının üzerine kayıtlı olduğu kişi

8 string (Transporter) Cihaz sahibi: araç takip cihazının üzerine kayıtlı firma

9 ServiceMessage Servis bilgilendirme mesajı

(4)

5.2. KBBGetLastLocationOfVehicle (UserInfo User, String VehicleID )

Herhangi bir aracın en son bulunduğu konum bilgilerini getiren yöntemin giriş/çıkış parametreleri aşağıdaki tabloda verilmiştir.

1 Location Araç konum bilgileri

5.3. KBBGetLocationsOfVehicleByTimeInterval(UserInfo User, String VehicleID, Datetime Startdate, Datetime Enddate)

Plakası verilen aracın verilen iki tarih arasındaki konum bilgilerini liste halinde getiren yöntemin giriş/çıkış parametreleri aşağıdaki tabloda verilmiştir.

3 Startdate datetime Başlangıç tarihi

4 Enddate datetime Bitiş tarihi

1 List<Location> Araç konum bilgileri

(5)

5.4. KBBGetAlarmsOfVehicleByTimeInterval(UserInfo User, String VehicleID, Datetime Startdate, Datetime Enddate)

Plakası verilen aracın verilen iki tarih arasındaki alarm ve konum bilgilerini liste halinde getiren yöntemin giriş/çıkış parametreleri aşağıdaki tabloda verilmiştir.

2 VehicleId string Araç plaka bilgisi, boşluksuz tümü

büyük harf.

3 Startdate datetime Başlangıç tarihi

4 Enddate datetime Bitiş tarihi

1 List<AlarmResult> Araç konum ve alarm bilgileri 2 ServiceMessage Servis bilgilendirme mesajı

5.5. KBBGetAllVehicles(UserInfo User)

Kocaeli Ticari Taksi Güvenlik Sistemindeki tüm araçları liste halinde getiren yöntemin giriş/çıkış parametreleri aşağıdaki tabloda verilmiştir.

1 string – (VehicleId) Araç plaka bilgisi, boşluksuz tümü büyük harf.

2 string – (Trademark) TTGS marka ismi.

3 string – (Firm) Firma ismi: GSSS firma ismi.

4 string – (Owner) Cihaz sahibi: araç takip cihazının üzerine kayıtlı olduğu kişi

5 string – (Transporter) Cihaz sahibi: araç takip cihazının üzerine kayıtlı firma

(6)

6. GSSS FİRMALARININ KULLANMASI GEREKEN WEB SERVİSLERİ 6.1. KBBSaveAlarms(Location Location, Alarm Alarm)

Herhangi bir araç bir alarm verdiğinde verilen alarmla igili detayları vakit kaybetmeksizin İdare sunucularına gönderen yöntemin giriş/çıkış parametreleri aşağıdaki tabloda verilmiştir.

Kullanıcı bilgileri UserInfo türünde servisin başlık (header) kısmından alınacaktır.

1 Location Location Konum bilgileri

2 Alarm Alarm Alarm bilgileri

6.2. KBBSaveLocations(List<Location> Locations)

Tüm araçların günlük konum ve alarm bilgilerinin tümünü İdare sunucularına gönderen yöntemin giriş/çıkış parametreleri aşağıdaki tabloda verilmiştir.

Tüm GSSS firmaları her gün sonu saat 23:59’a kadar elindeki tüm araçların o güne ait konum ve alarm bilgilerini gün içinde bu web servisi aracılığıyla idare sunucularına göndermek zorundadır.

Kullanıcı bilgileri UserInfo türünde servisin başlık (header) kısmından alınacaktır.

1 Locations List<Location> Konum bilgileri Çıkış Parametreleri

6.3. Servis Adres Bilgileri:

Adres: Paylaşılacaktır.

Not: Kullanıcı bilgileri ayrıca paylaşılacaktır.