Ana içeriğe atla

Geliştiriciler

Pano
Pano
Subscription
Kullanım dışı

Rota ID'ye göre güncellendi

Geçiş rehberi

Rota ayrıntıları

Şu tarihten önce geçiş yapın: 2027 1. Çeyrek

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

İşlemler

EskiYeni
routegetRoute
routeUpdatedByIdroute

Genel şema değişiklikleri

  • Açık tür tanımları: 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 ve value, type ile 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 ve ev, telemetry ile routeRequest girdileri 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, birkaç açık yeniden adlandırmayla birlikte kendi adlarını koruyarak recommended altına taşını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

Bölüm düzeyinde menzil alanları rotayla aynı yeniden adlandırmayı izler; yolcu ve yük 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ı eklenir.

Öne çıkan değişiklikler

Yanıt ayrıca rota kesimleri için yeni, daha yapılandırılmış bir biçim sunar. Aşağıda daha ayrıntılı olarak ele alınmıştır.

Kesimler

Adımların yerini, her kesim için başlangıç ve varış ayrıntıları dahil daha ayrıntılı bilgi sağlayan kesimler (sections) almıştır.

Sections
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 routeUpdatedById aboneliğini kullanarak bir rotaya abone olun ve hesaplanırken gerçek zamanlı güncellemeler alın. Yeni entegrasyonlar bunun yerine route aboneliğini kullanmalıdır.

Parametreler

id· ID · zorunlu

Alanlar

telemetry· JSON
Route telemetry data.
status· RouteStatus
Route status.
RouteStatus enum değerleri
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 buradan.

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_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 ©

Çerezleri yönet

Yürürlük tarihi: 20 Mart 2024 · Güncelleme: 1 Eylül 2026

Çerez politikası

developers.chargetrip.com deneyiminizi iyileş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ında çerezlerin kullanımını kapsar. Ayrıca, hizmetlerinin bir parçası olarak çerez kullanabilecek, kullanabileceğimiz üçüncü taraf hizmetler hakkında temel bilgiler de sunuyoruz; ancak bunlar politikamızın kapsamında değildir.

Bizden hiç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 size 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 bilgi, 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ü bilgisini içerir.

Çerezler, belirli özellikleri etkinleştirmek (ör. oturum açma), site kullanımını izlemek (ör. analitik), 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 genellikle yalnızca o siteye ilişkin 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 genellikle yalnızca o siteye ilişkin 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 sizin için ve ilgi alanlarınız için daha uygun olduğunu belirlemede kullanılır. Web siteleri bunları hedefli reklam sunmak veya bir reklamı görme sayı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 sizin için ve ilgi alanlarınız için daha uygun olduğunu belirlemede kullanılır. Web siteleri bunları hedefli reklam sunmak veya bir reklamı görme sayı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ü

Hizmetlerinden yararlanmadan önce tüm üçüncü taraf sağlayıcılarımızın gizlilik politikalarını inceleyerek uygulamalarının bizimkilerle uyumlu olduğundan emin oluyoruz. Kullanıcılarımızın gizliliğinden ödün veren veya bunu ihlal eden üçüncü taraf hizmetlerini bile bile 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 analitik 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 bilgilendirecek şekilde güncelleyebilirsiniz.

Web sitelerinde birden fazla cihazdan gezinirseniz, ayarlarınızı her cihazda ayrı ayrı güncellemeniz gerekebilir.

Bazı çerezler bir web sitesinin deneyimini pek etkilemeden engellenebilse de, tüm çerezleri engellemek ziyaret ettiğiniz sitelerdeki belirli özelliklere ve içeriğe erişemeyeceğiniz anlamına gelebilir.

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