Filtreler

Filtreler, uygulamaların Tile Service API tarafından döndürülen şarj istasyonlarını daraltmasına olanak tanır. Eşleşmeyen sonuçları yalnızca gizlemenin ötesinde, bazı filtreler yanıtın bağlama uygun olmasını sağlamak için istasyon verilerini de dönüştürür.

Filtreler verileri nasıl etkiler

Bir istek filtre içerdiğinde Tile servisi iki ayrı işlem gerçekleştirir:

1. Eşleşmeyen istasyonların dışarıda bırakılmasıBelirtilen filtreleme ölçütlerini karşılamayan her istasyon yanıttan tamamen çıkarılır. Bu işlem, istasyon düzeyi filtreler veya EVSE düzeyi filtreler kullanıldığında gerçekleşir.
2. Veri dönüşümüBelirli filtreleme parametreleri sağlandığında Tile Service, istasyonun bazı dinamik özelliklerini yeniden hesaplar. Bu işlem, EVSE düzeyi filtreler kullanıldığında gerçekleşir.

Uygulama

Filtre parametreleri, Tile Service uç noktalarından herhangi birine (MVT, JSON veya Count) sorgu dizesi olarak istek URL’sine eklenebilir. Hiçbir filtre uygulanmazsa mevcut tüm şarj istasyonları döndürülür ve veri dönüşümü yapılmaz.

https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?{filter_1}&{filter_2}&{filter_n}

Düzeyler

Filtreler iki düzeyde bulunabilir: EVSE düzeyi veya istasyon düzeyi. Her birinin etkisi ve sonuçları aşağıda açıklandığı gibidir.

İstasyon düzeyi

İstasyonun genel niteliklerini değerlendiren filtreler. Bu filtreler yalnızca dışarıda bırakma işlevi görür: eşleşmeyen istasyonları dışarıda bırakır ancak döndürülen veri alanlarını asla değiştirmez.

amenities · enum · Show example urlhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?amenities[]=HOTEL

Yalnızca belirtilen olanakları sunan istasyonları dahil eden filtre.

Olası değerler

HOTELSHOPPINGBATHROOMSUPERMARKETPLAYGROUNDPHARMACYMUSEUMCOFFEEPARKRESTAURANT

preferred_operators · boolean · Show example urlhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?preferred_operators=true

Yalnızca tercih edilen olarak yapılandırılmış operatörler tarafından işletilen istasyonları dahil eden filtre. Tercih edilen operatörler, panodaki proje ayarlarından belirlenebilir.

Olası değerler

truefalse

hide_excluded_operators · boolean · Show example urlhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?hide_excluded_operators=true

Hariç tutulan olarak yapılandırılmış operatörler tarafından işletilen istasyonları dışarıda bırakan filtre. Hariç tutulan operatörler, panodaki proje ayarlarından belirlenebilir.

Olası değerler

truefalse

operator_ids · string · Show example urlhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?operator_ids[]=631834841e604d2273ffb2b5&operator_ids[]=64e6979d49ed0ae2316ec052

Yalnızca belirli operatör ID’leri tarafından işletilen istasyonları dahil eden filtre. Operatör ID’lerinden oluşan bir dizi kabul eder.

truck_dedicated · boolean · Örnek URL’yi gösterhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?truck_dedicated=true

Yalnızca kamyon şarjına ayrılmış veya öncelikli olarak kamyon şarjı için tasarlanmış istasyonları dahil eden filtre. Yalnızca Eco-Movement istasyon veritabanı kullanılıyorsa geçerlidir; aksi halde yok sayılır.

Olası değerler

truefalse

vehicle_types · enum · Örnek URL’yi gösterhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?vehicle_types[]=VAN&vehicle_types[]=RIGID

Yalnızca belirtilen OCPI araç tiplerini destekleyen istasyonları dahil eden filtre. Varsayılan olarak tüm araç tipleri dahildir. Yalnızca Eco-Movement istasyon veritabanı kullanılıyorsa geçerlidir; aksi halde yok sayılır.

Olası değerler

VANRIGIDTRUCK_WITH_TRAILER

EVSE düzeyi

İstasyonun belirli şarj yeteneklerini değerlendiren filtreler. Bu filtreler hem dışarıda bırakma hem de dönüşüm işlemi yapar: eşleşmeyen istasyonlar dışarıda bırakılır, eşleşen istasyonların dinamik alanları ise yeniden hesaplanır.

minimum_power · integer · Show example urlhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_power=50

Yalnızca en az bir konnektörü belirtilen güç değerini (kW cinsinden) karşılayan veya aşan istasyonları dahil eden filtre. 0’dan büyük bir tam sayı kabul eder.

maximum_power · integer · Show example urlhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_power=150

Yalnızca herhangi bir konnektörün maksimum şarj gücü belirtilen güç değerini (kW cinsinden) aşmayan istasyonları dahil eden filtre. 0’dan büyük bir tam sayı kabul eder.

minimum_energy_price · number · betaBeta Bu filtre beta aşamasındadır ve kararlı hale gelmeden önce değişebilir. · Örnek URL’yi gösterhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_energy_price=0.2&currency=EUR

Yalnızca uyumlu konektörlerinden en az birinin etkin fiyatı belirtilen değerden büyük veya ona eşit olan istasyonları dahil eden filtre; değerlendirme currency ile belirlenen para biriminde yapılır. Bkz. istasyon fiyatlandırması. Yalnızca Eco-Movement istasyon veritabanı kullanılıyorsa geçerlidir; aksi halde yok sayılır.

maximum_energy_price · number · betaBeta Bu filtre beta aşamasındadır ve kararlı hale gelmeden önce değişebilir. · Örnek URL’yi gösterhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_energy_price=0.5&currency=EUR

Yalnızca uyumlu konektörlerinden en az birinin etkin fiyatı belirtilen değerden küçük veya ona eşit olan istasyonları dahil eden filtre; değerlendirme currency ile belirlenen para biriminde yapılır. Bkz. istasyon fiyatlandırması. Yalnızca Eco-Movement istasyon veritabanı kullanılıyorsa geçerlidir; aksi halde yok sayılır.

connectors · enum · Show example urlhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=CHADEMO

Yalnızca belirtilen konnektör türlerine sahip EVSE’leri bulunan istasyonları dahil eden filtre. Herhangi bir OCPI 2.2.1 konnektör değerini içeren bir dizi dizesi kabul eder.

Olası değerler

CHADEMODOMESTIC_ADOMESTIC_BDOMESTIC_CDOMESTIC_DDOMESTIC_EDOMESTIC_FDOMESTIC_GDOMESTIC_HDOMESTIC_IDOMESTIC_JDOMESTIC_KDOMESTIC_LDOMESTIC_MDOMESTIC_NDOMESTIC_OIEC_60309_2_single_16IEC_60309_2_three_16IEC_60309_2_three_32IEC_60309_2_three_64IEC_62196_T1IEC_62196_T1_COMBOIEC_62196_T2IEC_62196_T2_COMBOIEC_62196_T3AIEC_62196_T3CPANTOGRAPH_BOTTOM_UPPANTOGRAPH_TOP_DOWNTESLA_RTESLA_SGB_TCHAOJINEMA_5_20NEMA_6_30NEMA_6_50NEMA_10_30NEMA_10_50NEMA_14_30NEMA_14_50

evse_statuses · enum · Show example urlhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?evse_statuses[]=AVAILABLE&evse_statuses[]=CHARGING

Yalnızca belirtilen durumlara sahip EVSE’leri bulunan istasyonları dahil eden filtre.

Olası değerler

BLOCKEDPLANNEDAVAILABLECHARGINGUNKNOWNRESERVEDOUT_OF_ORDERINOPERATIVE

Para birimi dönüşümü

currency sorgu parametresi, Tile Service uç noktalarının tamamında (tile.json, tile.mvt ve count) desteklenir. Döndürülen ve filtrelemede kullanılan enerji fiyatlarının para birimini belirler.

• currency belirtilmezse connector_minimum_energy_price ve connector_maximum_energy_price EUR cinsinden döndürülür.
• currency, USD, GBP, DKK veya EUR gibi geçerli bir ISO 4217 para birimi kodu olduğunda:
  • connector_minimum_energy_price ve connector_maximum_energy_price içinde döndürülen değerler, sunucuda geçerli dönüşüm oranı kullanılarak kaynak para biriminden istenen para birimine dönüştürülür.
  • minimum_energy_price ve maximum_energy_price filtreleri, istenen para birimindeki veya currency belirtilmemişse EUR cinsindeki dönüştürülmüş fiyatlara göre değerlendirilir.
• Özgün para birimi istenen para birimiyle aynıysa price_conversion_rate değeri 1.0 olarak döndürülür.
• currency geçerli bir ISO 4217 para birimi kodu değilse karo servisi şu ayrıntılarla bir hata döndürür:
  • Durum: 400 Bad Request
  • Kod: TILE_INVALID_PARAMETER_VALUE
  • Mesaj: Invalid parameter 'currency': found string {invalid currency} but expected one of {supported currencies}.

https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_energy_price=0.5&currency=USD

Örnekler

Davranışı göstermek için aşağıda filtreleme ve veri dönüşümüne ilişkin örnekler verilmiştir.

Filtre örnekleri

Filtreler iki düzeyde bulunabilir: EVSE düzeyi veya istasyon düzeyi. Her birinin etkisi ve sonuçları aşağıda açıklandığı gibidir.

https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=IEC_62196_T1_COMBO&connectors[]=CHADEMO

https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_power=120&evse_statuses[]=AVAILABLE&connectors[]=IEC_62196_T1_COMBO

Veri dönüşümü örnekleri

EVSE düzeyi filtreler uygulandığında bazı çıktılar yeniden hesaplanır. Bu alanlar, kullanıcının arama ölçütleriyle eşleşmeyen konnektörleri yok saymak üzere “dönüştürülür”. Bu “dinamik” çıktı alanları connector_maximum_power, connector_minimum_energy_price, connector_maximum_energy_price ve evses_* alanlarıdır.

https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=IEC_62196_T1_COMBO&connectors[]=CHADEMO

{  "id": "station_a",  // Static: Remains 150 kW (This represents the station maximum power across all connectors)  "station_maximum_power": 150,  // Dynamic: Adjusted to 100 kW (Max power of the CHADEMO connector)  "connector_maximum_power": 100,  // Dynamic: Counts the 1 CHADEMO chargers  "evses_out_of_order": 0,  // Dynamic: 0, because the charging Type 1 plugs are filtered out  "evses_available": 1}

https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_energy_price=0.40

{  "connector_maximum_power": 50,  "evses_available": 2,  // Dynamic: lowest price of the matching connectors, not of the entire station  "connector_minimum_energy_price": 0.25,  // Dynamic: highest price of the matching connectors, not of the entire station  "connector_maximum_energy_price": 0.35}

https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=CCS

{  "connector_maximum_power": 150,  "evses_available": 2,  // Dynamic: lowest price of the CCS connectors  "connector_minimum_energy_price": 0.35,  // Dynamic: highest price of the CCS connectors  "connector_maximum_energy_price": 0.65}

https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=CCS&maximum_energy_price=0.30

https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_power=100&maximum_energy_price=0.40