Ana içeriğe atla
Mutation
Kullanım dışı

Yeni rota

Geçiş rehberi

Rota oluşturma

Ş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
newRoutecreateRoute

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.

Mutasyon değişiklikleri

createRoute üzerindeki input argümanı yeniden düzenlenmiş ve basitleştirilmiştir.

routeRequest

Kök düzeyinde aşağıdaki alanlar kaldırılmıştır. Operatörle ilgili alanlar artık operatör tercihleri kapsamındadır, olanakla ilgili alanlar ise kendi özel olanak sorgusuna taşınmıştır.

AlanTaşındığı yer
operatorIdsKaldırıldı
amenitiesKaldırıldı
amenity_preferencesKaldırıldı
operatorRequiredKaldırıldı
operatorPreferKaldırıldı

EV

EV düzeyinde, üst düzey alanların çoğu özel bir vehicle nesnesine taşınmıştır.

AlanTaşındığı yer
ev.idvehicle.id
batteryvehicle
climatevehicle
heat_pumpvehicle
plugsvehicle.charging.connectors
safeRiskMarginvehicle.charging.risk_margin
chargeModevehicle.charging.mode
bmsConsumptionKaldırıldı

Araç yükü

Araç yükü özellikleri artık tek bir yerde ayarlanmaz. Bunlar artık her origin ve via noktası için ayrı ayrı belirtilir ve bölüm başına yolcu ve kargo ağırlığı üzerinde daha ayrıntılı kontrol sağlar. Her konumda properties.vehicle altında yer alırlar ve alan adları şu şekilde değişir:

AlanTaşındığı yer
occupantsDeğişmedi
cargototal_cargo_weight

Telemetri

Aşağıdaki telemetri verileri kök düzeyinden vehicle nesnesine taşınmıştır.

AlanTaşındığı yer
headingvehicle
motor_rpmvehicle
odometervehicle
outside_temperaturevehicle
tire_pressurevehicle
vehicle_speedvehicle

Öne çıkan değişiklikler

input argümanındaki birkaç alan artık yeni ve daha yapılandırılmış şekillere sahiptir. Bunlar aşağıda daha ayrıntılı olarak ele alınmıştır.

Operatör tercihleri

Operatör tercihleri üç seviyeye indirilmiştir: high, medium ve low. Her giriş; sıralanmış, hariç tutulmuş veya kaçınılmış olsun, countries alanı aracılığıyla belirli ülkelere göre kapsamlandırılabilir. Belirtilmezse tüm ülkeler dikkate alınır.

Operatör tercihleri
graphql
input: {  operators: {    ranking: {      type: preferred      levels: {        high: [          {            id: "op1"            countries: [NL]          }        ]        low: [          {            id: "op3"          }        ]      }    }  }}

Toplam yolcu ağırlığı

Yeni bir total_occupant_weight alanı, varsayılan yolcu ağırlığını yeni birim nesnesiyle ifade ederek geçersiz kılmanıza olanak tanır.

Toplam yolcu ağırlığı
graphql
input: {  origin: {    properties: {      vehicle: {        occupants: 3        total_occupant_weight: {          value: 160          type: kilogram          source: manual        }      }    }  }}

Eski newRoute mutasyonunu kullanarak yeni bir rota oluşturun. Yeniden düzenlenmiş bir şema ve ülkeye göre operatör tercihleriyle şarj duraklarını, enerji tüketimini ve sürüş süresini hesaplayan createRoute mutasyonuna geçiş yaparken kullanılabilir durumda kalır.

Parametreler

input· RequestInput

Alanlar

ID· ID· In favor of createRoute.

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.

consumption_exceeded
Provided consumption value for $LOCATION is not valid. The value must be between 0 and $MAXVALUE kwh, or the equivalent in another unit, for this vehicle.
empty_array_not_allowed
Array $NAME should have at least one value.
error_forbidden_message
You are forbidden to execute this operation.
invalid_coordinates
Coordinates provided for $LOCATION are not valid.
invalid_unit
Provided unit type $TYPE for $LOCATION is not valid.
invalid_value
Provided value $VALUE for $LOCATION is not valid. Expected value of type $EXPECTEDTYPE.
negative_value_not_allowed
Negative value for $LOCATION is not allowed.
occupants_above_allowed
Provided number of occupants for $LOCATION is not valid. The value must be less than or equal to $OCCUPANTSCOUNT for this vehicle.
occupants_below_allowed
Provided number of occupants for $LOCATION is not valid. The value must be at least 1.
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.
operator_both_excluded_and_ranking
Operator $OPERATORID is both in the ranking and excluded lists.
operator_duplicated_in_exclude
Operator $OPERATORID is multiple times in the exclude lists.
operator_duplicated_in_ranking
Operator $OPERATORID is multiple times in the ranking lists.
operator_invalid_ranking
Operator ranking must be between 1 and 10.
operator_not_found
No operator was found with the $OPERATORID ID.
operator_ranking_none_given
The route operator type was set to $ROUTEOPTYPE, but no ranking was provided. Please add an operator to your client or route request.
rate_limit_exceeded
Rate limit exceeded.
route_battery_capacity_above_allowed
The provided battery capacity is too high. The value must be less than or equal to $MAX kwh or the equivalent in another unit.
route_battery_capacity_below_allowed
The provided battery capacity is too small. The value must be greater than or equal to $MIN kwh or the equivalent in another unit.
route_cargo_below_allowed
Provided amount of cargo weight is not valid. The value cannot be negative.
route_consumption_invalid_worst
Provided consumption value for $NAME is not valid. The worst value must be greater than or equal to best value.
route_consumption_total_exceeded
Provided consumption values are not valid. The total must be between 0 and $MAXVALUE for this vehicle.
route_destination_station_and_external_station_not_matching
The destination station for the route requested was not matched with the external station.
route_destination_station_invalid_speed
The provided destination station $STATIONID cannot be used as charging stop. The station does not support DC charging (> 43kW).
route_destination_station_not_found
The destination station for the route requested was not found with the provided ID.
route_destination_station_out_of_service
The provided destination station $STATIONID cannot be used as charging stop. All compatible connectors at this station are out of service.
route_duplicate_amenities
Amenities $DUPLICATEDAMENITIES are duplicated.
route_final_soc_exceeding_battery_capacity
The provided final state of charge is too high. The value must be less than or equal to 80% of the vehicle battery capacity.
route_invalid_amenities
Amenities $INVALIDAMENITIES are not valid. Allowed: $ALLOWEDAMENITIES.
route_invalid_destination_coordinates
The destination coordinates provided are not valid.
route_invalid_origin_coordinates
The origin coordinates provided are not valid.
route_invalid_scheduled_charge_stop_duration
The scheduled charge stop duration is invalid. The value must be between 900 and 86400 seconds.
route_invalid_scheduled_charge_stop_max_distance_from_station
The scheduled charge stop max_distance_from_station is invalid. The value must be between 0 and 1000 meters.
route_invalid_via_coordinates
The via coordinates provided are not valid.
route_max_number_of_passengers_exceeded
Provided number of passengers is not valid. The value must be between 1 and $PASSENGERCOUNT for this vehicle.
route_min_power_below_allowed
The provided minimum power is too small. The value must be greater than 0.
route_origin_station_and_external_station_not_matching
The origin station for the route requested was not matched with the external station.
route_origin_station_not_found
The origin station for the route requested was not found with the provided ID.
route_radius_above_allowed
The radius value is above allowed, the maximum value is 5000 meters.
route_radius_below_allowed
The radius value is below allowed, the minimum value is 500 meters.
route_station_invalid_charger
The provided via station $STATIONID cannot be used as charging stop. The charger standard of the vehicle is not supported.
route_station_invalid_min_power
The minimum power requested is higher than the station could support.
route_station_invalid_speed
The provided via station $STATIONID cannot be used as charging stop. The station does not support DC charging (> 43kW).
route_station_out_of_service
The provided via station $STATIONID cannot be used as charging stop. All compatible connectors at this station are out of service.
route_via_cargo_below_allowed
Provided amount of cargo is not valid. The value must be greater than 0.
route_via_station_and_external_station_not_matching
The via station for the route requested was not matched with the external station.
route_via_station_not_found
The station ID used as a via for the requested route was not found.
soc_exceeding_battery_capacity
The provided state of charge for $LOCATION is too high. The value must be less than or equal to the vehicle battery capacity.
station_destination_coordinates_not_matching
Coordinates [$DESTINATIONCOORDINATES] of destination don't match with station coordinates [$STATIONCOORDINATES].
station_origin_coordinates_not_matching
Coordinates [$ORIGINCOORDINATES] of origin don't match with station coordinates [$STATIONCOORDINATES].
station_via_coordinates_not_matching
Coordinates [$VIACOORDINATES] of via don't match with station coordinates [$STATIONCOORDINATES].
tire_pressure_below_allowed
Provided tire pressure is not valid. The value must be at least 1.
vehicle_freemium_not_allowed
You do not have access to this vehicle. Please upgrade to access this vehicle.
vehicle_type_not_allowed
Vehicle of type $TYPE is not allowed for this operation.
zero_or_negative_value_not_allowed
Zero or negative value for $LOCATION is not allowed.

Bu içerik yardımcı oldu mu?

Geliştiriciler

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.