Ana içeriğe atla

Geliştiriciler

Pano
Pano
Query
Kullanım dışı

Rota

Geçiş rehberi

Rota ayrıntıları

Şu tarihten önce geçiş yapın: 2027 Q1

Eski Rota hizmetinden en son sürüme geçin. Yeni hizmet; yeniden düzenlenmiş bir şema, ülke bazlı operatör tercihleri, daha hızlı rota hesaplama ve daha kolay sürdürülebilirlik sunar.

İşlemler

EskiYeni
routegetRoute
routeUpdatedByIdroute

Genel şema değişiklikleri

  • Açık tür tanımlama: daha önce esnek olan JSON alanları, yapıyı ve doğrulamayı iyileştirmek için artık şemada açıkça türlendirilmiştir.
  • Adlandırma kuralları: alanlar artık camelCase yerine snake_case kullanır.
  • Birim desteği: sayısal girdiler artık farklı birim türlerini destekler; bunlar value, type ve isteğe bağlı bir source (manual, telemetry veya default) içeren bir nesne olarak ifade edilir.

Sorgu ve abonelik değişiklikleri

Alan adlandırması ve gruplandırması gözden geçirilmiş, gereksiz alanlar kaldırılmıştır. Yanıt artık varsayılanlarla zenginleştirilmiş özgün girdiyi içerir; böylece gelecekteki rota yeniden hesaplamalarında yeniden kullanılabilir.

Üst düzey

Üst düzeyde alanların çoğu recommended altına taşınır; ev, telemetry ve routeRequest girdileri ise tek bir request_input nesnesinde birleştirilir.

AlanTaşındığı yer
routerecommended
alternativesKaldırıldı
evrequest_input
telemetryrequest_input
routeRequestrequest_input
appmeta.app_id
statusDeğişmedi

Rota

Rota düzeyinde alanların çoğu kendi adlarını koruyarak recommended altına taşınır; birkaç alan ise açıkça yeniden adlandırılır.

AlanTaşındığı yer
rangeStart*range_at_origin
rangeEnd*range_at_destination
chargesrecommended.charges
distancerecommended.distance
consumptionrecommended.consumption
chargeTimerecommended.durations.charging
polylinerecommended.polyline
pathPlotrecommended.path_plot
legsrecommended.legs
tagsrecommended.tags
instructionsKaldırıldı
amenityRankingKaldırıldı
stationsAlongRouterecommended.alternative_stations

Bölümler (legs)

Bölüm düzeyinde menzil alanları rotayla aynı yeniden adlandırmayı izler; yolcu ve kargo ayrıntıları ise her bölümün origin ve via konum özelliklerine taşınır.

AlanTaşındığı yer
rangeStart*range_at_origin
rangeEnd*range_at_destination
stepssections
stationIdrecommended.legs.station.station_id

Bölümlere ayrıca yeni bir range_after_charge alanı da eklenmiştir.

Öne çıkan değişiklikler

Yanıt ayrıca rota kesitleri için yeni ve daha yapılandırılmış bir şekil sunar. Bu aşağıda daha ayrıntılı olarak ele alınmıştır.

Kesitler

Adımlar (steps), her kesit için başlangıç ve varış ayrıntıları dahil daha ayrıntılı bilgi sağlayan kesitlerle (sections) değiştirilmiştir.

Kesitler
graphql
sections {  type  tags  polyline(decimals: five)  distance(unit: meter)  duration  consumption  origin {    id    type    properties {      occupants      total_occupant_weight      total_cargo_weight    }    geometry {      type      coordinates    }  }  destination {    id    type    properties {      occupants      total_occupant_weight      total_cargo_weight    }    geometry {      coordinates      type    }  }}

Eski route sorgusunu kullanarak daha önce hesaplanmış bir rotanın ayrıntılarını alın. Yeni entegrasyonlar bunun yerine getRoute sorgusunu kullanmalıdır.

Parametreler

id· ID· required

Alanlar

route· RouteAlternative
Recommended route.
alternatives· RouteAlternative
Available alternatives.
ev· RequestEv
EV specific data for a route request.
telemetry· JSON
Route telemetry data.
user· RequestUser· You will receive null values.
routeRequest· RequestRoute
Route request data.
app· RouteApp
Application who requested a route.
status· RouteStatus
Route status.
RouteStatus enum values
pending

Route is queued and pending processing. Temporary status.

processing

We are computing the route for your request. Temporary status.

done

We finished computing the route, with a result. Final status.

not_found

We finished computing the route, without any result. Final status.

error

An error occurred while computing the route. Final status.

Hatalar

Operations başarısız olabilir. Bunları doğru şekilde işlemek için aşağıdaki hata senaryolarını göz önünde bulundurun. Hatalar hakkında daha fazla here.

error_forbidden_message
You are forbidden to execute this operation.
operation_not_allowed
You are not allowed to execute this operation. Enable it for the current application in the dashboard or reach out to customer support.
rate_limit_exceeded
Rate limit exceeded.
route_not_found
No route was found with the provided ID.
route_polyline_invalid_decimals
Value for decimals number is not valid. Allowed values are 5 or 6.

Bu içerik yardımcı oldu mu?

Oluştur

Geliştiriciler

Güncellemeler

Kaynaklar

Yasal

İletişime geçin

Chargetrip ©

Durum bilinmiyor

Çerezleri yönetin

Yürürlük tarihi: 20 Mart 2024 · Güncellenme tarihi: 25 Ocak 2023

Çerez politikası

developers.chargetrip.com deneyiminizi geliştirmeye yardımcı olmak için çerezler kullanıyoruz. Bu çerez politikası gizlilik politikasının bir parçasıdır ve cihazınız ile sitemiz arasındaki çerez kullanımını kapsar. Ayrıca, kullanabileceğimiz ve hizmetlerinin bir parçası olarak çerez kullanabilecek üçüncü taraf hizmetler hakkında temel bilgiler de sunuyoruz; ancak bunlar politikamızın kapsamında değildir.

Bizden herhangi bir çerezi kabul etmek istemiyorsanız, tarayıcınıza developers.chargetrip.com sitesinden gelen çerezleri reddetmesini söylemelisiniz; ancak bu durumda istediğiniz bazı içerik ve hizmetleri sunamayabileceğimizi unutmayın.

Çerez onayı tercihlerinizi gözden geçirin

Çerez nedir

Çerez, bir web sitesinin siz ziyaret ettiğinizde cihazınızda sakladığı küçük bir veri parçasıdır. Genellikle web sitesinin kendisi hakkında bilgiler, siz geri döndüğünüzde sitenin web tarayıcınızı tanımasını sağlayan benzersiz bir tanımlayıcı, çerezin amacına hizmet eden ek veriler ve çerezin kendi ömrü bulunur.

Çerezler belirli özellikleri etkinleştirmek (ör. oturum açma), site kullanımını izlemek (ör. analizler), kullanıcı ayarlarınızı saklamak (ör. saat dilimi, bildirim tercihleri) ve içeriğinizi kişiselleştirmek (ör. reklam, dil) için kullanılır.

Ziyaret ettiğiniz web sitesi tarafından ayarlanan çerezlere normalde “birinci taraf çerezleri” denir ve bunlar genellikle yalnızca o sitedeki etkinliğinizi izler. Diğer siteler ve şirketler (yani üçüncü taraflar) tarafından ayarlanan çerezler, aynı üçüncü taraf hizmetini kullanan diğer web sitelerinde sizi izlemek için kullanılabilir.

Gerekli çerezler

Ziyaret ettiğiniz web sitesi tarafından ayarlanan çerezlere normalde “birinci taraf çerezleri” denir ve bunlar genellikle yalnızca o sitedeki etkinliğinizi izler. Diğer siteler ve şirketler (yani üçüncü taraflar) tarafından ayarlanan çerezler, aynı üçüncü taraf hizmetini kullanan diğer web sitelerinde sizi izlemek için kullanılabilir.

Performans çerezleri

Hedefleme / reklam çerezleri, hangi promosyon içeriğinin size ve ilgi alanlarınıza daha uygun ve alakalı olduğunu belirlemede kullanılır. Web siteleri bunları hedefli reklam sunmak veya bir reklamı kaç kez gördüğünüzü sınırlamak için kullanabilir. Bu, şirketlerin kampanyalarının etkinliğini ve size sunulan içeriğin kalitesini artırmasına yardımcı olur. Bu çerezler, ziyaret ettiğiniz web sitesi (birinci taraf) veya üçüncü taraf hizmetler tarafından ayarlanabilir. Üçüncü taraflarca ayarlanan hedefleme/reklam çerezleri, aynı üçüncü taraf hizmetini kullanan diğer web sitelerinde sizi izlemek için kullanılabilir. Sitemizde hedefleme/reklam çerezleri kullanıyoruz.

Pazarlama / reklam çerezleri

Hedefleme / reklam çerezleri, hangi promosyon içeriğinin size ve ilgi alanlarınıza daha uygun ve alakalı olduğunu belirlemede kullanılır. Web siteleri bunları hedefli reklam sunmak veya bir reklamı kaç kez gördüğünüzü sınırlamak için kullanabilir. Bu, şirketlerin kampanyalarının etkinliğini ve size sunulan içeriğin kalitesini artırmasına yardımcı olur. Bu çerezler, ziyaret ettiğiniz web sitesi (birinci taraf) veya üçüncü taraf hizmetler tarafından ayarlanabilir. Üçüncü taraflarca ayarlanan hedefleme/reklam çerezleri, aynı üçüncü taraf hizmetini kullanan diğer web sitelerinde sizi izlemek için kullanılabilir. Sitemizde hedefleme/reklam çerezleri kullanıyoruz.

Üçüncü taraf taahhüdü

Üçüncü taraf sağlayıcılarımızın hizmetlerini kullanmadan önce, uygulamalarının bizimkilerle uyumlu olduğundan emin olmak için tüm gizlilik politikalarını inceliyoruz. Kullanıcılarımızın gizliliğini tehlikeye atan veya ihlal eden üçüncü taraf hizmetleri bilerek asla dahil etmeyeceğiz.

Çerez
google-cookie-consent
Açıklama
Çerez tercihlerinizi, yani hangi kategorileri kabul ettiğinizi veya reddettiğinizi saklar; böylece her ziyarette seçiminize saygı gösterebilir ve yalnızca izin verdiğiniz analiz veya pazarlama araçlarını yükleyebiliriz.
Ömür
2 yıl

Çerezleri nasıl kontrol edebilir veya devre dışı bırakabilirsiniz

Bizden çerez kabul etmek istemiyorsanız, tarayıcınıza web sitemizden gelen çerezleri reddetmesini söyleyebilirsiniz. Çoğu tarayıcı varsayılan olarak çerezleri kabul edecek şekilde yapılandırılmıştır, ancak bu ayarları çerezleri tamamen reddedecek veya bir web sitesi çerez ayarlamaya çalıştığında sizi uyaracak şekilde güncelleyebilirsiniz.

Web sitelerine birden fazla cihazdan göz atıyorsanız, ayarlarınızı her bir cihazda ayrı ayrı güncellemeniz gerekebilir.

Bazı çerezler bir web sitesi deneyimini az etkileyerek engellenebilse de, tüm çerezleri engellemek ziyaret ettiğiniz sitelerdeki belirli özelliklere ve içeriğe erişememenize neden olabilir.

Bu Çerez Politikasını, örneğin kullandığımız çerezlerdeki değişiklikleri yansıtmak veya diğer operasyonel, yasal ya da düzenleyici nedenlerle zaman zaman güncelleyebiliriz. Çerez kullanımımız ve ilgili teknolojiler hakkında bilgi sahibi olmak için lütfen bu Çerez Politikasını yeniden ziyaret edin. Bu Çerez Politikasının en üstündeki tarih, en son ne zaman güncellendiğini gösterir.