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.
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.

İ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ı
| Alan | Zorunlu | Anlamı |
|---|---|---|
device_id | Evet | Takip cihazının kendi tanımlayıcısı, örneğin IMEI numarası. En fazla 120 karakter. Bir makineye bağlanan budur. |
at | Evet | Takip 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. |
lat | Evet | Ondalık derece cinsinden enlem (WGS84), -90 ile 90 arası. |
lng | Evet | Ondalık derece cinsinden boylam, -180 ile 180 arası. |
accuracy_m | Hayır | Konumun metre cinsinden doğruluğu. |
speed_kph | Hayır | Saatte kilometre cinsinden hız. |
heading_deg | Hayır | Derece 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:
| Alan | Anlamı |
|---|---|
accepted | Saklanan konumlar |
duplicates | Daha önce alınmış (aynı cihaz, aynı an) ve yok sayılan konumlar |
unbound | Henüz bir makineye bağlanmamış cihazlardan gelen konumlar. Saklanırlar ve birinin bağlaması için GPS akışı sekmesinde görünürler. |
sightings | Bir makinenin konum geçmişine kayıt ekleyen konumlar |
moved | Mevcut Alt Lokasyonu değişen makineler |
rejected | Reddedilen 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ır | Değer |
|---|---|
| İstek başına konum | 1.000 |
| Anahtar başına istek | Dakikada 120 |
| Anahtar başına konum | Dakikada 5.000 |
| Makineye bağlanmadan konum bildiren cihaz | Akış başına 200 |
| Bir konumun gerçek zamandan ne kadar ileri tarihli olabileceği | 5 dakika |
Hatalar
| Yanıt | Anlamı |
|---|---|
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. |
422 | Gö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üyorsunuz | Ne yapmalısınız |
|---|---|
Her şey unbound olarak sayılıyor | Henüz kimse cihazları bağlamadı. Yöneticinizden her birini kendi makinesine bağlamasını isteyin. |
Konumlar kabul ediliyor ama sightings 0'da kalıyor | Makineler 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üyor | Anahtar yenilenmiş veya akış arşivlenmiş. Yöneticinizden güncel anahtarı isteyin. |
