GELİŞTİRİCİ REHBERİ

Entegrasyon Rehberi

M4 platformunu mevcut sistemlerinize bağlamak için adım adım rehber. Protokol bağımsız mimarisi sayesinde çoğu entegrasyon standart araçlarla tamamlanabilir.

MQTT 5.0REST v1CANBUS J1939GTFS-RTWebSocket

Genel Bakış

M4 entegrasyon mimarisi dört temel yoldan veri kabul eder:

MQTT — Araç ve IoT Cihazları

Araç GPS/OBD üniteleri ve saha sensörleri için önerilen protokol. Düşük bant genişliği, yüksek güvenilirlik.

REST API — Sistem Entegrasyonları

Sefer planlaması, personel sistemi veya üçüncü parti veri kaynakları için.

GTFS-RT — Toplu Taşıma Akışı

Mevcut GTFS altyapınız varsa gerçek zamanlı akışı doğrudan M4'e bağlayın.

Webhook — Olay Bildirimleri

M4'ten dış sistemlere olay bildirimi göndermek için.

Gereksinimler

M4 API anahtarı (yönetici panelinden alın)
MQTT Broker adres ve port bilgisi (size özel atanır)
TLS sertifikası (araç donanımları için)

MQTT Entegrasyonu

MQTT 5.0 veya 3.1.1 desteklenmektedir. TLS zorunludur; port 8883 kullanılır.

Bağlantı Bilgileri

host:     mqtt.mseries.ai
port:     8883 (TLS)
username: YOUR_CLIENT_ID
password: YOUR_API_KEY

Topic Yapısı

// Araç konum verisi
m4/{fleet_id}/vehicles/{vehicle_id}/location

// Araç telemetri (hız, yakıt, motor)
m4/{fleet_id}/vehicles/{vehicle_id}/telemetry

// Cihaz durumu
m4/{fleet_id}/devices/{device_id}/status

Payload Örneği

{
  "vehicle_id": "VH-3241",
  "ts":         1745478862,
  "lat":        41.00823,
  "lon":        39.72684,
  "speed":      42.3,
  "heading":    195,
  "fuel_pct":   72
}

REST API Entegrasyonu

Sefer planı, personel veya dış sistem verilerini POST ile M4'e gönderin. Detaylı endpoint listesi için API Dokümantasyonu'na bakın.

GTFS-RT Entegrasyonu

Mevcut GTFS-RT feed URL'nizi M4'e tanımlayın; platform otomatik olarak çeker ve normalize eder.

// Konfigürasyon paneli → Veri Kaynakları → GTFS-RT Ekle
feed_url:      "https://transit.example.gov/gtfs-rt"
poll_interval: 15 // saniye
"api_key":     "..." // gerekiyorsa

CANBUS / J1939 Entegrasyonu

Araç donanımı kurulumu saha ekibi veya yetkili teknisyen tarafından yapılmalıdır.

Araç ünitesi M4 Edge Gateway yazılımını çalıştırır. Gateway, ham CAN frame'leri alır, M4 veri formatına dönüştürür ve MQTT üzerinden gönderir.

Akıllı Durak ve VMS Entegrasyonu

Saha cihazları için REST veya MQTT desteklenmektedir. Cihaz envanter kaydı Field modülü üzerinden yapılır. Ayrıntılı kılavuz için destek ekibimizle iletişime geçin.

Entegrasyon sürecinde teknik destek için: [email protected]