Duraklarla rota

Chargetrip Route API ile bir EV rotası hesaplarken, via kullanarak başlangıç ile varış noktası arasına ara duraklar ekleyebilirsiniz.

Duraklar, tercih edilen bir şarj istasyonunda şarj etmek, yolcu almak veya bir restoranda mola vermek gibi gerçek dünya seyahat senaryoları için rotayı özelleştirmenizi sağlar.

Durak türleri

Chargetrip iki tür ara durağı destekler:

Durak süresi

Her durağın süresini yapılandırabilirsiniz. Durağın türüne (şarj olan veya şarj olmayan) bağlı olarak stop_duration farklı konumlarda yapılandırılır ve farklı davranışlara sahiptir:

1. Şarj olmayan duraklarda

Durak süresi input.via.properties.location.stop_duration konumunda yapılandırılır. Bu süre tam durak süresini temsil eder ve aracın şarj veya sürüş süresini etkilemeden doğrudan toplam yolculuk süresine eklenir.

2. Şarj olan duraklarda

Durak süresi input.via.properties.station.stop_duration konumunda yapılandırılır. Bu değer minimum durak süresini temsil eder. Araç istasyonda en az bu süre boyunca kalır, ancak rota planlayıcı yapılandırılmış charge_mode değerine bağlı olarak durağı uzatabilir:

• ALWAYS_TO_MAX_CHARGE: Gerekirse yapılandırılmış maksimum SoC değerine ulaşmak için şarj süresini uzatır. İstenen stop_duration değeri maksimum SoC değerine ulaşmak için gereken süreyi aşarsa, kalan süre boşta bekleme olarak kaydedilir.

• OPTIMIZE_TRAVEL_TIME: Yalnızca toplam yolculuk süresini kısaltıyorsa (örneğin sonraki bir şarj durağını ortadan kaldırarak) kalış süresini stop_duration değerinin ötesine uzatır. Aksi halde tam olarak istenen süre kadar şarj eder. İstenen stop_duration değeri maksimum SoC değerine ulaşmak için gereken süreyi aşarsa, kalan süre boşta bekleme olarak kaydedilir.

Herhangi bir değer verilmezse, planlayıcı şarj süresini yalnızca rotanın charge_mode değerine göre optimize eder.

Mevcut bir rotaya istasyon ekleme

Yaygın bir senaryo, kullanıcının zaten duraklara sahip bir rota için şarj istasyonu seçmesidir, örneğin arayüzünüzde gösterilen alternatif bir istasyon. Kodsuz çözüm, bir istasyonu yeniden sıralama mantığı olmadan otomatik olarak via durağı olarak eklemek için bu yaklaşımı kullanır, böylece rota sorunsuz biçimde güncellenir.

via dizisinin sırası, durakların ziyaret edildiği sıradır. Sona eklenen bir istasyon, rotanın başına yakın olsa bile en son ziyaret edilir. İstasyonu doğru konuma eklemek için, istasyonun konumunu rotada zaten bulunan yol noktalarıyla karşılaştırın:

1. Yol noktalarını sırayla toplayın.

   Değiştirmek istediğiniz rotanın request_input alanından origin, mevcut her via durağını ve destination değerini alın. request_input içindeki her yol noktasının geometry değeri mevcuttur, yalnızca station_id ile oluşturulan duraklar da dahil.

2. Yol noktalarından geçen bir çizgi çizin.

   Yol noktalarını sırayla birleştirerek bir çizgi oluşturun. Bu çizginin iki yol noktası arasındaki her parçası bir segmenttir.

3. İstasyona en yakın segmenti bulun.

   Çizgi üzerinde istasyonun koordinatlarına en yakın noktayı bulmak için bir coğrafi konum kütüphanesi kullanın. Örneğin turf.js, bu noktayı içeren segmentin indeksini de döndüren nearestPointOnLine işlevini sunar. Bu indeks, segmentin başladığı yol noktasının indeksidir.

4. İstasyonu bu yol noktasından sonra ekleyin.

   Yol noktası listesi origin ile başlar, bu nedenle bu listedeki bir yol noktasının indeksi, via içine eklenecek yeni öğenin hemen ardından yer alması için gereken konuma karşılık gelir. 0 indeksi, istasyonun ilk durak olarak eklendiği anlamına gelir.

5. Varıştan sonra asla eklemeyin.

   En yakın nokta son segmentteyse indeks destination değerini gösterebilir. Buraya eklemek istasyonu rotanın sonundan sonraya yerleştirir. Bunun yerine önceki yol noktasını kullanın, böylece istasyon destination öncesindeki son durak olarak eklenir.

Dikkat edilmesi gerekenler

• Çizgi, yol noktalarını düz segmentlerle birleştirir ve rotanın yollarını takip etmez. Alternatif istasyonlar her zaman rotanın çevresindeki 5 ila 10 km’lik bir koridorda yer alır, bu nedenle rotadan fazla sapmazlar ve en yakın segment çoğunlukla doğrudur. Bu koridorun dışındaki istasyonlar için başka çözümler daha uygun olabilir.
• Rotanın request_input alanı esas kaynaktır. Yeni isteği bu alandan oluşturun ve vehicle ile charging ayarları gibi diğer tüm alanları değiştirmeden bırakın.

Örnekler

mutation CreateRouteWithWaypoint {  createRoute(    input: {      vehicle: {        id: "60b8d5a2f1c8e9001b9e2831"        charging: { mode: OPTIMIZE_TRAVEL_TIME }      }      origin: {        type: Point        coordinates: [4.9041, 52.3676]      }      destination: {        type: Point        coordinates: [6.9583, 50.9375]      }      via: [        {          geometry: {            type: Point            coordinates: [5.1214, 52.0907] # Utrecht          }          properties: {            location: {              name: "Utrecht Central"              stop_duration: 1800 # 30 minutes in seconds            }          }        }      ]    }  ) {    id    status  }}

mutation CreateRouteWithChargingVia {  createRoute(    input: {      vehicle: {        id: "60b8d5a2f1c8e9001b9e2831"        charging: { mode: OPTIMIZE_TRAVEL_TIME }      }      origin: {        type: Point        coordinates: [4.9041, 52.3676]      }      destination: {        type: Point        coordinates: [6.9583, 50.9375]      }      via: [        {          properties: {            station: {              station_id: "5e849ea2837bc43df65d19a2"              stop_duration: 1800            }          }        }      ]    }  ) {    id    status  }}

mutation CreateRouteWithChargingVia {  createRoute(    input: {      vehicle: {        id: "60b8d5a2f1c8e9001b9e2831"        charging: { mode: OPTIMIZE_TRAVEL_TIME }      }      origin: {        type: Point        coordinates: [4.9041, 52.3676]      }      destination: {        type: Point        coordinates: [6.9583, 50.9375]      }      via: [        {          properties: {            station: {              station_id: "5e849ea2837bc43df65d19a2"            }          }        }      ]    }  ) {    id    status  }}