SolmexYardım Merkezi

Yardım MerkeziEntegrasyon Rehberleri

Herhangi bir takip cihazından GPS konumu gönderin

Takip cihazlarını Solmex'e bağlayan kişi için. Adres, anahtar, konum biçimi, aldığınız yanıt ve bir akışın uyması gereken sınırlar.

Dahil olduğu planlar: Talep üzerineGüncellendi

Solmex, basit bir web isteğiyle herhangi bir GPS takip cihazından makine konumlarını kabul eder. Bu sayfa bağlantıyı kuran kişi içindir: takip cihazı tedarikçiniz, BT ekibiniz veya konumları takip platformundan okuyup ileten kendi sunucunuzdaki küçük bir betik.

Anahtarı oluşturmak ve cihazları uygulamada makinelere bağlamak için GPS takip cihazlarını bağlayın makalesini izleyin. Takip cihazlarınız Wialon Hosting üzerindeyse bu sayfaya ihtiyacınız yoktur: bkz. Wialon bağlayın.

Başlamadan önce

  • Canlı Harita plana göre değil, şirket bazında açılır. Açık değilse akış, planınızın bunu içermediğini yanıtlar.
  • Ayarlar: Düzenle yetkisi olan bir yönetici, Ayarlar'ın GPS akışı sekmesinde bir akış oluşturur ve anahtarını size verir. Anahtar yalnızca bir kez gösterilir.
  • Makinelerin çalıştığı Lokasyonun bir harita planı olmalıdır; yoksa konumlar bir Alt Lokasyona yerleştirilemez. Bkz. Saha planı oluşturun.
Ayarlar'daki GPS akışı sekmesi; burada akış eklenir, anahtarı ve cihazları yönetilir

İstek

Şirketinizin Solmex adresine, ardından /api/telematics/positions gelecek şekilde bir HTTPS POST gönderin. Ayarlar'ın GPS akışı sekmesi şirketinizin tam adresini kopyalanmaya hazır olarak gösterir. yourcompany.getsolmex.com adresindeki bir şirket için bu şudur:

POST https://yourcompany.getsolmex.com/api/telematics/positions
Authorization: Bearer <the feed's key>
Content-Type: application/json

{"positions": [
  {"device_id": "860123456789012", "at": "2026-10-12T09:41:12Z", "lat": -6.1659, "lng": 39.2026, "accuracy_m": 8, "speed_kph": 12.5, "heading_deg": 270}
]}

Oturum açma ve oturum yoktur: Authorization başlığındaki anahtar kimlik bilgisinin tamamıdır. Onu kod depolarından ve kayıt dosyalarından uzak tutun.

Bir konumun alanları

AlanZorunluAnlamı
device_idEvetTakip cihazının kendi tanımlayıcısı, örneğin IMEI numarası. En fazla 120 karakter. Bir makineye bağlanan budur.
atEvetTakip cihazının konumu aldığı an; sizin gönderdiğiniz an değil. Saat dilimiyle ISO 8601, örneğin UTC için Z ile biten.
latEvetOndalık derece cinsinden enlem (WGS84), -90 ile 90 arası.
lngEvetOndalık derece cinsinden boylam, -180 ile 180 arası.
accuracy_mHayırKonumun metre cinsinden doğruluğu.
speed_kphHayırSaatte kilometre cinsinden hız.
heading_degHayırDerece cinsinden hareket yönü.

Konumları en fazla 1.000'lik gruplar hâlinde, 1 MB'ı geçmeyen bir gövdeyle gönderin.

Yanıt

Başarılı bir istek o grup için sayılar döndürür:

AlanAnlamı
acceptedSaklanan konumlar
duplicatesDaha önce alınmış (aynı cihaz, aynı an) ve yok sayılan konumlar
unboundHenüz bir makineye bağlanmamış cihazlardan gelen konumlar. Saklanırlar ve birinin bağlaması için GPS akışı sekmesinde görünürler.
sightingsBir makinenin konum geçmişine kayıt ekleyen konumlar
movedMevcut Alt Lokasyonu değişen makineler
rejectedReddedilen konumların listesi; her biri device_id ve bir reason ile

Aynı konumu iki kez göndermek güvenlidir: yinelenen olarak sayılır, asla iki kez saklanmaz. Bu yüzden bir istek başarısız olursa veya zaman aşımına uğrarsa grubu yeniden gönderin.

Solmex bir konumla ne yapar

Kabul edilen her konum 30 gün saklanır; makinenin günlük güzergâhını çizen budur. Bir konum, makinenin konum geçmişine yalnızca yeni bir şey söylediğinde kayıt olarak eklenir: makine Alt Lokasyon değiştirdiğinde veya son GPS kaydından bu yana bir saat geçtiğinde. Bir konum asla en yakın Alt Lokasyona taşınmaz. Bu kurallar GPS takip cihazlarını bağlayın makalesinde açıklanır.

Sınırlar

SınırDeğer
İstek başına konum1.000
Anahtar başına istekDakikada 120
Anahtar başına konumDakikada 5.000
Makineye bağlanmadan konum bildiren cihazAkış başına 200
Bir konumun gerçek zamandan ne kadar ileri tarihli olabileceği5 dakika

Hatalar

YanıtAnlamı
404 "Not found"Anahtar eksik, yanlış, arşivlenmiş veya yenilenmiş. Solmex her durumda aynı yanıtı verir.
429 "This feed is sending more positions than it may. Slow down, then retry."Anahtarınız dakikalık sınırını aştı. O istekten hiçbir şey saklanmadı.
429 "Too many requests. Try again shortly."Sunucunuzun adresinden çok fazla istek geldi. Bekleyin, sonra yeniden deneyin.
422Gövde yukarıdaki biçime uymuyor: zorunlu bir alan eksik, bir değerin türü yanlış veya 1.000'den fazla konum var.
402Şirketinizde Canlı Harita açık değil.

rejected içinde görebileceğiniz nedenler:

  • "A device id is required."
  • "That coordinate is not on the earth." Enlem ile boylamı karıştırmadığınızı veya sıfır göndermediğinizi kontrol edin.
  • "That fix is dated in the future." Gönderen bilgisayarın saati yanlış veya saat dilimi eksik.
  • Akışta makineye bağlanmamış 200 cihaz olduğunu söyleyen bir ileti. Daha fazlası bildirim yapabilmeden önce gerçek cihazları GPS akışı sekmesinde bağlayın.

Sorun giderme

Ne görüyorsunuzNe yapmalısınız
Her şey unbound olarak sayılıyorHenüz kimse cihazları bağlamadı. Yöneticinizden her birini kendi makinesine bağlamasını isteyin.
Konumlar kabul ediliyor ama sightings 0'da kalıyorMakineler yerinde durduğu sürece bu normaldir. Hareket ediyorlarsa Lokasyonun bir harita planı olduğunu ve Alt Lokasyonların alan olarak çizildiğini veya bir yarıçapı olduğunu kontrol edin.
Her istek 404 döndürüyorAnahtar yenilenmiş veya akış arşivlenmiş. Yöneticinizden güncel anahtarı isteyin.