Rota ve maliyet, tek istekte.
Türkiye karayolları için rota, mesafe, süre ve maliyet hesaplayan REST API. Bir başlangıç ve bitiş noktası verirsiniz; kilometreyi, tahmini süreyi, gişe ve yakıt maliyetini tek cevapta alırsınız.
https://route.seferiai.comHızlı başlangıç
GET /health anahtar gerektirmez.POST /route/generate ile rota ve maliyet.İlk isteğiniz
curl -X POST https://route.seferiai.com/route/generate \ -H "Authorization: Bearer ERISIM_ANAHTARINIZ" \ -H "Content-Type: application/json" \ -d '{ "vehicleTypeId": 5, "from": { "lat": "41.0082", "lng": "28.9784" }, "to": { "lat": "40.1885", "lng": "29.0610" }, "routeType": "fast", "isToll": 1 }'
const res = await fetch("https://route.seferiai.com/route/generate", { method: "POST", headers: { Authorization: "Bearer ERISIM_ANAHTARINIZ", "Content-Type": "application/json", }, body: JSON.stringify({ vehicleTypeId: 5, from: { lat: "41.0082", lng: "28.9784" }, to: { lat: "40.1885", lng: "29.0610" }, routeType: "fast", isToll: 1, }), }); const { data } = await res.json(); console.log(data.distance, data.totalCost);
import requests res = requests.post( "https://route.seferiai.com/route/generate", headers={"Authorization": "Bearer ERISIM_ANAHTARINIZ"}, json={ "vehicleTypeId": 5, "from": {"lat": "41.0082", "lng": "28.9784"}, "to": {"lat": "40.1885", "lng": "29.0610"}, "routeType": "fast", "isToll": 1, }, ) data = res.json()["data"] print(data["distance"], data["totalCost"])
Kimlik doğrulama
Her istekte erişim anahtarınızı Authorization başlığında gönderin. Anahtarsız ya da geçersiz anahtarlı istekler 401 ile döner.
Authorization: Bearer ERISIM_ANAHTARINIZ
Rota oluştur
İki nokta arasında rota hesaplar; mesafe, süre ve maliyeti döndürür. Ara noktalar ve kaçınılacak bölgeler eklenebilir.
Parametreler
| Alan | Tür | Açıklama |
|---|---|---|
vehicleTypeId zorunlu | integer | Araç tipi. Liste için araç tipleri. |
from zorunlu | object | Başlangıç noktası: { "lat", "lng" } |
to zorunlu | object | Bitiş noktası: { "lat", "lng" } |
routeType zorunlu | string | "fast" en hızlı, "short" en kısa rota. |
waypoints isteğe bağlı | array | Sırayla uğranacak ara noktalar. |
avoidPoints isteğe bağlı | array | Rotanın geçmemesi gereken noktalar ya da bölgeler. |
isToll isteğe bağlı | 0 / 1 | Gişe ücretleri maliyete eklensin mi. |
isShip isteğe bağlı | 0 / 1 | Feribot geçişleri kullanılabilsin mi. |
isGlobal isteğe bağlı | boolean | Rota yurt dışına çıkıyorsa true gönderin. Otomatik algılanmaz. Varsayılan false. |
fuelRatio isteğe bağlı | number | Yakıt tüketimi (litre / 100 km). |
Örnek cevap
{
"status": true,
"data": {
"distance": 354.82, // km
"totalTime": 18540, // saniye
"totalCost": 2150.65, // TL
"routeId": "route_abc123",
"costs": { "fuel": 1850.65, "toll": 300.00, "total": 2150.65 }
}
}Rota detayı
Daha önce oluşturulan bir rotanın tüm ayrıntılarını döndürür: noktalar, bölümler, gişe noktaları ve maliyet kırılımı.
| Alan | Tür | Açıklama |
|---|---|---|
routeId zorunlu | string | Rota oluştururken dönen kimlik. |
Araç tipleri
Rota oluştururken kullanabileceğiniz araç tiplerini ve kimliklerini listeler.
| ID | Araç |
|---|---|
| 1 | Otomobil |
| 2 | Minibüs |
| 3 | Otobüs |
| 4 | Hafif ticari |
| 5 | Kamyon / TIR |
Rota geçmişi
Aynı güzergâh için hesaplanmış tüm sürümleri ve şu an kullanılan (aktif) sürümü döndürür.
| Alan | Tür | Açıklama |
|---|---|---|
routeKey zorunlu | string | Güzergâhın anahtarı. |
Aktif sürümü değiştir
Bir güzergâhın geçmişteki sürümlerinden birini aktif yapar. Sonraki istekler bu sürümü kullanır.
{ "routeKey": "rou_123456", "routeId": 1233 }Kullanımım
Anahtarınızla yapılan isteklerin özeti: rota sayısı, toplam mesafe ve maliyet, gün gün dağılım.
| Alan | Tür | Açıklama |
|---|---|---|
period isteğe bağlı | integer | Kaç günlük veri (1–365). Varsayılan 7. |
groupBy isteğe bağlı | string | hour, day ya da month. Varsayılan day. |
Genel istatistik yönetici
Tüm anahtarların toplam kullanımı. Yalnızca yönetici anahtarıyla erişilir. period parametresi yukarıdakiyle aynıdır.
Sağlık kontrolü anahtar gerekmez
Servisin ve bağlı bileşenlerinin çalışıp çalışmadığını döndürür. İzleme araçları için uygundur.
Hatalar
Hatalı isteklerde status: false ve açıklayıcı bir mesaj döner.
| Kod | Anlamı |
|---|---|
401 | Anahtar eksik ya da geçersiz. |
400 | Parametreler eksik ya da hatalı biçimde. |
500 | Sunucu tarafında beklenmeyen bir hata. Kısa bir süre sonra tekrar deneyin. |