Promptever Fleet xAPI

v1.0 Dokümantasyon

Docs + Preview

Hızlı Başlangıç

Temel Kurallar

  • 1
    Her statement'ta https://promptever.com/xapi/fleet/v1 değerini context.contextActivities.category içine ekleyin.
  • 2
    object.definition.type alanına ilgili ActivityType IRI'sini (ör. Overspeed, Idle, Run) atayın.
  • 3
    Şablona göre zorunlu ve önerilen extension alanlarını doldurun.

Faydalı Kaynaklar

Tam profil dosyası:

fleet-xapi-profile.json dosyası
fleet-xapi-profile.md dosyası
fleet-xapi-profile.docx dosyası

xAPI Spesifikasyonu:

ADL xAPI Spesifikasyonu

Desteklenen Standartlar

FMS Standard

Fleet Management System Arayüz Standardı

  • • Araç CAN Bus verilerinin standardize edilmesi
  • • Telematics gateway protokolleri
  • • Fuel, mesafe ve motor verisi formatları
  • • Üçüncü taraf entegrasyon desteği

SAE J1939

Ağır Vasıta CAN Bus Protokolü

  • • Motor parametreleri ve diagnostik kodları
  • • Transmisyon ve şasi bilgileri
  • • Yakıt tüketimi ve emisyon verileri
  • • Araç durumu ve alarm mesajları

ISO 15638 (TARV)

Ticari Araç Telematics Uygulamaları

  • • Regülasyon uyumlu veri paylaşımı
  • • Çalışma süreleri ve dinlenme kayıtları
  • • Sürücü kimlik doğrulama
  • • Otoritelere raporlama framework'ü

ISO 39001

Karayolu Trafik Güvenliği Yönetim Sistemleri

  • • Trafik kazalarının azaltılması
  • • Sürücü davranış analizi
  • • Risk değerlendirme ve önleme
  • • Güvenlik performans göstergeleri

OBD-II

Araç Üstü Diagnostik Sistemi

  • • Emisyon kontrol sistemleri
  • • Motor performans parametreleri
  • • Arıza kod (DTC) standardizasyonu
  • • Gerçek zamanlı veri akışı

GDPR & ISO 27001

Veri Koruma ve Bilgi Güvenliği

  • • Kişisel veri işleme hakları
  • • Şifrelenmiş veri aktarımı
  • • Audit trail ve log yönetimi
  • • Privacy by design prensipleri

EN 16942 (eSafety)

Akıllı Ulaşım Sistemleri Güvenlik Verileri

  • • Acil durum veri setleri
  • • Üçüncü taraf servis sağlayıcıları
  • • eCall ve bCall sistemleri
  • • Otomatik kaza bildirim protokolleri

ISO 14906

Elektronik Ücret Toplama (Road Tolling)

  • • HGS/OGS entegrasyon protokolleri
  • • Otoyol geçiş kayıtları
  • • Ödeme ve faturalama sistemleri
  • • Çok taşıyıcılı uyumluluk

Smart Tachograph

Dijital Takograf Regülasyonu (EU 165/2014)

  • • Sürücü çalışma ve dinlenme süreleri
  • • GNSS konum kayıtları
  • • Uzaktan kontrol ve indirme
  • • Şirket kartı veri yönetimi

Statement Şablonları

Run Completed

Verb: completed · Type: run-lifecycle

Zorunlu:
context.parent context.category
Önerilen:
distance_km max_speed_kmh

Overspeed Ended

Verb: state-ended · Type: overspeed

Zorunlu:
duration_sec
Önerilen:
max_speed_kmh distance_km

Idle Ended

Verb: state-ended · Type: idle

Zorunlu:
duration_sec

Harsh Brake

Verb: experienced · Type: harsh-brake

Önerilen:
min_accel_mps2 start_speed_kmh

Overspeed Started

Verb: state-started · Type: overspeed

Zorunlu:
speed_limit_kmh segment_id
Önerilen:
speed_kmh

Idle Started

Verb: state-started · Type: idle

Zorunlu:
context.parent context.category

Unexpected Stop Ended

Verb: state-ended · Type: unexpected-stop

Zorunlu:
duration_sec

Run Started

Verb: initialized · Type: run-lifecycle

Zorunlu:
context.parent context.category

Run Aborted

Verb: terminated · Type: run-lifecycle

Zorunlu:
context.parent context.category

Unexpected Stop Started

Verb: state-started · Type: unexpected-stop

Zorunlu:
context.parent context.category

Expected Stop Arrived

Verb: occurred · Type: expected-stop

Zorunlu:
context.parent context.category

Expected Stop Departed

Verb: occurred · Type: expected-stop

Zorunlu:
context.parent context.category

Harsh Acceleration

Verb: experienced · Type: harsh-accel

Önerilen:
start_speed_kmh end_speed_kmh

Harsh Turn

Verb: experienced · Type: harsh-turn

Önerilen:
speed_kmh

Segment Entered

Verb: occurred · Type: segment

Zorunlu:
segment_id

Segment Exited

Verb: occurred · Type: segment

Zorunlu:
segment_id

Tüm Şablon Kuralları

Analitik Kullanım Senaryoları (Örnek xAPI Statement’ları)

Hiyerarşik Analiz (Geçmiş–Bugün–Gelecek)

KPI özetleri; organizasyon → plan → rota → run bağlamı.

{
  "id": "b6c2f7a8-0001-4000-9000-000000000001",
  "timestamp": "2025-09-24T09:00:00Z",
  "actor": { "objectType": "Group", "name": "ACME Logistics · TR-10-112 · Driver-123" },
  "verb": { "id": "https://promptever.com/xapi/fleet/v1/verbs/summarized" },
  "object": {
    "id": "https://promptever.com/xapi/fleet/v1/activities/daily-summary",
    "objectType": "Activity",
    "definition": { "type": "https://promptever.com/xapi/fleet/v1/activity-types/summary-event" }
  },
  "context": {
    "contextActivities": {
      "parent":   [{ "id": "https://promptever.com/xapi/fleet/v1/ops/plan/Q3_2025" }],
      "grouping": [
        { "id": "https://promptever.com/xapi/fleet/v1/org/ACME" },
        { "id": "https://promptever.com/xapi/fleet/v1/ops/route/R-784" },
        { "id": "https://promptever.com/xapi/fleet/v1/ops/run/1c540cd7" }
      ],
      "category": [{ "id": "https://promptever.com/xapi/fleet/v1" }]
    }
  },
  "result": {
    "extensions": {
      "https://promptever.com/xapi/fleet/v1/extensions/kpi/utilization_rate": 83.2,
      "https://promptever.com/xapi/fleet/v1/extensions/kpi/otd_rate": 95.4,
      "https://promptever.com/xapi/fleet/v1/extensions/kpi/incident_rate": 0.7
    }
  }
}

Eşleşme Optimizasyonu (Araç–Sürücü–Rota)

Eşleşmeye özgü verimlilik ve maliyet metrikleri.

{
  "id": "b6c2f7a8-0002-4000-9000-000000000002",
  "timestamp": "2025-09-24T09:02:00Z",
  "actor": { "objectType": "Group", "name": "ACME · TR-10-112 × Driver-123 @ R-784" },
  "verb": { "id": "https://promptever.com/xapi/fleet/v1/verbs/calculated" },
  "object": {
    "id": "https://promptever.com/xapi/fleet/v1/activities/match-eval",
    "objectType": "Activity",
    "definition": { "type": "https://promptever.com/xapi/fleet/v1/activity-types/summary-event" }
  },
  "context": {
    "contextActivities": {
      "parent":   [{ "id": "https://promptever.com/xapi/fleet/v1/ops/route/R-784" }],
      "grouping": [
        { "id": "https://promptever.com/xapi/fleet/v1/vehicle/TR-10-112" },
        { "id": "https://promptever.com/xapi/fleet/v1/driver/123" }
      ],
      "category": [{ "id": "https://promptever.com/xapi/fleet/v1" }]
    }
  },
  "result": {
    "extensions": {
      "https://promptever.com/xapi/fleet/v1/extensions/fuel/efficiency_score": 88,
      "https://promptever.com/xapi/fleet/v1/extensions/cost/cost_per_km": 0.72
    }
  }
}

Arıza & Bakım Tahmini

Yaklaşan servis ve bileşen sağlık göstergeleri.

{
  "id": "b6c2f7a8-0003-4000-9000-000000000003",
  "timestamp": "2025-09-24T09:05:00Z",
  "actor": { "objectType": "Agent", "name": "Predictor v2.1" },
  "verb": { "id": "https://promptever.com/xapi/fleet/v1/verbs/predicted" },
  "object": {
    "id": "https://promptever.com/xapi/fleet/v1/activities/maintenance-forecast",
    "objectType": "Activity",
    "definition": { "type": "https://promptever.com/xapi/fleet/v1/activity-types/maintenance-event" }
  },
  "context": {
    "contextActivities": {
      "parent":   [{ "id": "https://promptever.com/xapi/fleet/v1/vehicle/TR-10-112" }],
      "category": [{ "id": "https://promptever.com/xapi/fleet/v1" }]
    }
  },
  "result": {
    "extensions": {
      "https://promptever.com/xapi/fleet/v1/extensions/maintenance/next_service_km": 1800,
      "https://promptever.com/xapi/fleet/v1/extensions/engine/oil_temp": 108.4,
      "https://promptever.com/xapi/fleet/v1/extensions/maintenance/dtc_codes": { "pending": ["P0522"] }
    }
  }
}

Davranış Analizi (Ani Fren / Hız Aşımı)

Süre, hız ve konumla zenginleştirilmiş olay.

{
  "id": "b6c2f7a8-0004-4000-9000-000000000004",
  "timestamp": "2025-09-24T09:08:30Z",
  "actor": { "objectType": "Group", "name": "TR-10-112 · Driver-123" },
  "verb": { "id": "https://promptever.com/xapi/fleet/v1/verbs/state-ended" },
  "object": {
    "id": "https://promptever.com/xapi/fleet/v1/activities/overspeed",
    "objectType": "Activity",
    "definition": { "type": "https://promptever.com/xapi/fleet/v1/activity-types/overspeed" }
  },
  "context": {
    "contextActivities": {
      "parent": [{ "id": "https://promptever.com/xapi/fleet/v1/ops/run/1c540cd7" }],
      "category": [{ "id": "https://promptever.com/xapi/fleet/v1" }]
    },
    "extensions": {
      "https://promptever.com/xapi/fleet/v1/extensions/segment_id": "segment-19",
      "https://promptever.com/xapi/fleet/v1/extensions/telemetry/position": { "lat": 41.015, "lon": 29.012 },
      "https://promptever.com/xapi/fleet/v1/extensions/environment/traffic_density": "high"
    }
  },
  "result": {
    "extensions": {
      "https://promptever.com/xapi/fleet/v1/extensions/duration_sec": 22,
      "https://promptever.com/xapi/fleet/v1/extensions/max_speed_kmh": 104,
      "https://promptever.com/xapi/fleet/v1/extensions/distance_km": 0.91
    }
  }
}

Rota Değişikliği Etki Simülasyonu

Yeni rota için ETA, tüketim ve maliyet öngörüsü.

{
  "id": "b6c2f7a8-0005-4000-9000-000000000005",
  "timestamp": "2025-09-24T09:12:00Z",
  "actor": { "objectType": "Agent", "name": "Route Optimizer" },
  "verb": { "id": "https://promptever.com/xapi/fleet/v1/verbs/predicted" },
  "object": {
    "id": "https://promptever.com/xapi/fleet/v1/activities/route-change-AtoB",
    "objectType": "Activity",
    "definition": { "type": "https://promptever.com/xapi/fleet/v1/activity-types/summary-event" }
  },
  "context": {
    "contextActivities": {
      "parent":   [{ "id": "https://promptever.com/xapi/fleet/v1/ops/route/R-784" }],
      "category": [{ "id": "https://promptever.com/xapi/fleet/v1" }]
    }
  },
  "result": {
    "extensions": {
      "https://promptever.com/xapi/fleet/v1/extensions/operational/eta": "2025-09-24T14:05:00Z",
      "https://promptever.com/xapi/fleet/v1/extensions/fuel/consumption_l_100km": 21.3,
      "https://promptever.com/xapi/fleet/v1/extensions/cost/cost_per_km": 0.68
    }
  }
}

Sürücü Eğitimi & Etki Ölçümü

Eğitim sonrasında güvenlik skoru/olay oranı.

{
  "id": "b6c2f7a8-0006-4000-9000-000000000006",
  "timestamp": "2025-09-24T09:20:00Z",
  "actor": { "objectType": "Agent", "name": "CoachBot" },
  "verb": { "id": "https://promptever.com/xapi/fleet/v1/verbs/summarized" },
  "object": {
    "id": "https://promptever.com/xapi/fleet/v1/activities/driver-training-impact",
    "objectType": "Activity",
    "definition": { "type": "https://promptever.com/xapi/fleet/v1/activity-types/driver-event" }
  },
  "context": {
    "contextActivities": {
      "grouping": [
        { "id": "https://promptever.com/xapi/fleet/v1/driver/123" },
        { "id": "https://promptever.com/xapi/fleet/v1/org/ACME" }
      ],
      "category": [{ "id": "https://promptever.com/xapi/fleet/v1" }]
    }
  },
  "result": {
    "extensions": {
      "https://promptever.com/xapi/fleet/v1/extensions/driver/safety_score": 92,
      "https://promptever.com/xapi/fleet/v1/extensions/kpi/incident_rate": 0.3
    }
  }
}

Yatırım (Araç/Teknoloji) ROI Tahmini

Maliyet ve ROI hesaplaması (öngörü).

{
  "id": "b6c2f7a8-0007-4000-9000-000000000007",
  "timestamp": "2025-09-24T09:25:00Z",
  "actor": { "objectType": "Agent", "name": "FinanceModel v0.9" },
  "verb": { "id": "https://promptever.com/xapi/fleet/v1/verbs/calculated" },
  "object": {
    "id": "https://promptever.com/xapi/fleet/v1/activities/roi-estimate",
    "objectType": "Activity",
    "definition": { "type": "https://promptever.com/xapi/fleet/v1/activity-types/cost-event" }
  },
  "context": {
    "contextActivities": {
      "grouping": [{ "id": "https://promptever.com/xapi/fleet/v1/org/ACME" }],
      "category": [{ "id": "https://promptever.com/xapi/fleet/v1" }]
    }
  },
  "result": {
    "extensions": {
      "https://promptever.com/xapi/fleet/v1/extensions/kpi/roi": 18.6,
      "https://promptever.com/xapi/fleet/v1/extensions/cost/cost_per_km": 0.65,
      "https://promptever.com/xapi/fleet/v1/extensions/cost/maintenance_cost": 0.11
    }
  }
}

Stratejik Üçgen (Geçmiş–Bugün–Gelecek)

MTBF, kullanım ve güvenlik işaretleri.

{
  "id": "b6c2f7a8-0008-4000-9000-000000000008",
  "timestamp": "2025-09-24T09:30:00Z",
  "actor": { "objectType": "Group", "name": "Strategy Engine · Fleet Board" },
  "verb": { "id": "https://promptever.com/xapi/fleet/v1/verbs/summarized" },
  "object": {
    "id": "https://promptever.com/xapi/fleet/v1/activities/strategic-triangle",
    "objectType": "Activity",
    "definition": { "type": "https://promptever.com/xapi/fleet/v1/activity-types/summary-event" }
  },
  "context": {
    "contextActivities": {
      "grouping": [{ "id": "https://promptever.com/xapi/fleet/v1/org/ACME" }],
      "category": [{ "id": "https://promptever.com/xapi/fleet/v1" }]
    }
  },
  "result": {
    "extensions": {
      "https://promptever.com/xapi/fleet/v1/extensions/kpi/mtbf": 412.5,
      "https://promptever.com/xapi/fleet/v1/extensions/kpi/utilization_rate": 81.0,
      "https://promptever.com/xapi/fleet/v1/extensions/kpi/incident_rate": 0.5
    }
  }
}

Playground

JSON Doğrulayıcı ve Önizleme

Doğrulama Sonucu

Statement Önizlemesi

Self-Test

Gömülü Örneklerin Doğrulanması

Aşağıdaki örnek statement'lar otomatik olarak validator'dan geçirilir. Bu, profil kurallarının doğru çalıştığını kontrol etmek için basit bir test görevi görür.

Örnek Statement Algılanan Şablon Hatalar Uyarılar Durum