Araç menzilini görselleştirin

İzoline, bir EV’nin üzerindeki enerjiyle belirli bir noktadan ulaşabileceği alanı gösterir. “Bu araç buradan ne kadar uzağa gidebilir” gibi basit bir soruyu yanıtlar ve yanıtı haritaya yerleştirebileceğiniz şekiller olarak çizer.

Tipik kullanımlar; bir şehrin çevresindeki menzil haritası, “şarj etmeden oraya ulaşabilir miyim?” kontrolü veya yalnızca bir aracın gerçekten ulaşabileceği istasyonları gösteren bir filtredir.

İzoline, referans olarak gerçek yol ağını kullanır. Hesaplama, aracın yolla ulaşabileceği en uzak noktaları bulur ve dış hat bu noktaları birbirine bağlar. Sonuç, yolları izleyen bir çizgi değil dolu bir alandır; bu nedenle ormanlar veya tarlalar gibi yollar arasındaki alanlar da içine dahil olabilir. Nehirler, dağlar, tek yönlü sistemler ve ağdaki boşluklar yine de dış hattı şekillendirir; çünkü yolların aracı ne kadar uzağa götürdüğünü onlar belirler.

Nasıl çalışır

Rotalar gibi izolineler de API genelinde kullanılan aynı eşzamansız kalıbı izleyerek eşzamansız hesaplanır. Bir izoline oluşturma ve alma ayrı adımlarda gerçekleşir.

1. Bir izoline oluşturunEn az bir vehicle_id ve bir origin ile createIsoline mutasyonunu çağırın. Mutasyon hemen bir izoline id değeri döndürür; bunu bir sonraki adımda kullanacaksınız. Batarya seviyesi veya hava durumu gibi isteğe bağlı girdiler bir izolini özelleştirin bölümünde ele alınmıştır.
2. Bir abonelik açınÖnceki adımdaki id değerini kullanarak isoline aboneliğine abone olun. İzoline hesaplanırken durum pending olur. Bunu kullanıcı arayüzünüzde bir yükleme durumunu yönetmek için kullanın.
3. Sonucu gösterinstatus değeri done veya error olarak sonuçlandığında, uygun kullanıcı arayüzünü gösterin. done durumundaki bir izoline, haritaya çizilecek polygons değerlerini içerir.
4. İstendiğinde yeniden alınTamamlanmış bir izoline, tüm ayrıntılarıyla saklanır. Daha sonra yeniden göstermek için, yeni bir abonelik açmak yerine aynı id ile isoline sorgusunu kullanın.

Poligonlar

Sonuç bir poligon listesidir. Birlikte, erişilebilir alanı başlangıç noktasına yakın yerden aracın sürebileceği en uzak noktaya kadar adımlar halinde tanımlarlar.

Kaç poligon alacağınızı seçmek için, en fazla 20 olmak üzere polygon_count kullanın.

• Daha az poligon, aracın erişimine dair basit ve kaba bir görünüm verir. Çizilmesi daha hızlı ve bir bakışta okunması daha kolaydır.
• Daha fazla poligon, başlangıç noktası ile maksimum menzil arasında daha ince adımlar verir; bu da bir gradyan veya daha ayrıntılı bir menzil haritası için kullanışlıdır.

Her poligonun birbirinden ayırt edilmesi için properties içinde bir index değeri vardır ve maximum_distance, başlangıç noktasından ulaşılabilecek en uzak noktaya olan mesafeyi verir.

İlk izolininizi oluşturun

Bir izoline oluşturmak için vehicle_id ve origin yeterlidir. Bu örnek ayrıca batarya seviyesini, poligon sayısını ve hava durumunu ayarlar; böylece ana seçeneklerin birbirine nasıl uyduğunu görebilirsiniz.

mutation CreateIsoline {  createIsoline(    input: {      vehicle_id: "607823b2c246f9001b97b1a2"      origin: {        type: Feature        geometry: { type: Point, coordinates: [4.895168, 52.370216] }      }      state_of_charge: { value: 80, type: percentage }      polygon_count: 5      weather: { type: winter }    }  )}

Mutasyon izoline id değerini döndürür. Hesaplamayı takip etmek ve sonucu almak için bunu isoline aboneliğine iletin:

subscription Isoline {  isoline(id: "65f1a2b3c4d5e6f7a8b9c0d1") {    id    status    maximum_distance    polygons {      properties {        index      }      geometry {        type        coordinates      }    }  }}

Bu istekte:

• state_of_charge aracı %80 bataryayla başlatır. Bu olmadan izoline, aracın tam kullanılabilir batarya kapasitesini kullanır.
• polygon_count, başlangıç noktasına yakın yerden maksimum menzile kadar beş poligon döndürür.
• weather, soğuk koşulları varsayan ve genellikle gerçek zamanlı hava durumu varsayılanından daha küçük bir erişilebilir alan veren winter ön ayarını kullanır.

Bir izolini özelleştirin

createIsoline, hesaplamaya ince ayar yapmak için çeşitli isteğe bağlı girdileri kabul eder. Her alanla ilgili daha fazla ayrıntıyı API referansında bulabilirsiniz.