Ana içeriğe atla

Geliştiriciler

Pano
Pano
Rest

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ı gizlemenin ötesinde, bazı filtreler yanıtın bağlama uygun olması için istasyon verilerini de dönüştürür.

Filtreler verileri nasıl etkiler

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

  1. Eşleşmeyen istasyonların hariç tutulmasıBelirtilen filtreleme ölçütlerini karşılamayan tüm istasyonlar 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üştürmeBelirli filtreleme parametreleri verildiğinde 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ının herhangi birine (MVT, JSON veya Count) sorgu dizeleri olarak istek URL’sine eklenebilir. Hiçbir filtre uygulanmazsa mevcut tüm şarj istasyonları döndürülür ve hiçbir veri dönüştürmesi yapılmaz.

Tile / Filter / Example
bash
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çıklanmıştır.

İstasyon düzeyi

İstasyonun genel özelliklerini değerlendiren filtrelerdir. Bu filtreler yalnızca hariç tutma yapar: eşleşmeyen istasyonları dışarıda bırakır ancak döndürülen veri alanlarını asla değiştirmez.

amenities · enum · https://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 · https://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 dashboard’daki proje ayarlarından belirlenebilir.

Olası değerler

truefalse
hide_excluded_operators · boolean · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?hide_excluded_operators=true
Yalnızca hariç tutulan olarak yapılandırılmış operatörler tarafından işletilen istasyonları dışarıda bırakan filtre. Hariç tutulan operatörler dashboard’daki proje ayarlarından belirlenebilir.

Olası değerler

truefalse
operator_ids · string · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?operator_ids[]=631834841e604d2273ffb2b5&operator_ids[]=64e6979d49ed0ae2316ec052
Yalnızca belirli operatör kimlikleri tarafından işletilen istasyonları dahil eden filtre. Operatör kimliklerinden oluşan bir dizi kabul eder.
truck_dedicated · boolean · https://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 · https://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 filtrelerdir. Bu filtreler hariç tutma ve dönüştürme yapar: eşleşmeyen istasyonlar hariç tutulur ve eşleşen istasyonların dinamik alanları yeniden hesaplanır.

minimum_power · integer · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_power=50
Yalnızca en az bir konektörü belirtilen güç değerine (kW cinsinden) ulaşan veya bu değeri aşan istasyonları dahil eden filtre. 0’dan büyük bir tam sayı kabul eder.
maximum_power · integer · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_power=150
Yalnızca hiçbir konektörünü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 · Beta Bu filtre beta aşamasındadır ve kararlı hale gelmeden önce değişebilir. · https://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ı.
maximum_energy_price · number · Beta Bu filtre beta aşamasındadır ve kararlı hale gelmeden önce değişebilir. · https://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ı.
connectors · enum · https://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 dize dizisi 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 · https://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 endpoint’inde (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, sunucu tarafında 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 (currency belirtilmemişse EUR) dönüştürülmüş fiyatlara göre değerlendirilir.
  • Özgün para birimi istenen para birimiyle aynıysa price_conversion_rate 1.0 olarak döndürülür.
  • currency geçerli bir ISO 4217 para birimi kodu değilse tile hizmeti aşağıdaki 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}.
Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_energy_price=0.5&currency=USD

Örnekler

Davranışı göstermek için filtreleme ve veri dönüştürme örnekleri aşağıda 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çıklanmıştır.

Aynı filtre türü, farklı değerler
Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=IEC_62196_T1_COMBO&connectors[]=CHADEMO
İstasyonÖzelliklerEşleşme
A2x IEC_62196_T1_COMBO
1x CHAdeMO
1x TOILET
1x RESTAURANT		Eşleşme nedeni CHAdeMO şarj cihazı var
B1x IEC_62196_T1_COMBO
1x IEC_62196_T2_COMBO
1x RESTAURANT		Başlık Açıklama metni
C2x IEC_62196_T2_COMBO
1x TOILET		Başlık Açıklama metni
Birden fazla farklı filtre türü
Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_power=120&evse_statuses[]=AVAILABLE&connectors[]=IEC_62196_T1_COMBO
İstasyonÖzelliklerEşleşme
A2x IEC_62196_T1_COMBO
1x CHAdeMO
1x TOILET
1x RESTAURANT		Başlık Açıklama metni
B1x IEC_62196_T1_COMBO
1x IEC_62196_T2_COMBO
1x RESTAURANT		Başlık Açıklama metni
C2x IEC_62196_T2_COMBO
1x TOILET		Başlık Açıklama metni

Veri dönüştürme ö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 evse_status_* alanlarıdır.

Aynı filtre türü, farklı değerler İstek bir CHADEMO konnektör filtresi içerir. İstasyon bir CHADEMO konnektörüne sahip olduğu için dahil edilir, ancak dinamik alanlar Combo Type 1 şarj cihazlarını yok sayacak şekilde dönüştürülür.

Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=IEC_62196_T1_COMBO&connectors[]=CHADEMO
Response
json
{  "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  "evse_status_out_of_order": 0,  // Dynamic: 0, because the charging Type 1 plugs are filtered out  "evse_status_available": 1}

Fiyat filtreleri İstek, isteğe bağlı olarak diğer EVSE düzeyi filtrelerle birleştirilmiş bir maximum_energy_price filtresi içerir. Bir konektör yalnızca tüm filtreleri aynı anda karşılıyorsa eşleşir ve dinamik fiyat alanları yalnızca eşleşen konektörler için yeniden hesaplanır.

Temel istasyon A

  • EVSE 1: CCS • 150 kW • Müsait • 0,65 €
  • EVSE 2: CCS • 50 kW • Müsait • 0,35 €
  • EVSE 3: Tip 2 • 22 kW • Müsait • 0,25 €

Senaryo 1: yalnızca fiyat filtresi

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

Eşleşme: EVSE 2 ve 3 uygundur. EVSE 1 hariç tutulur.

Response
json
{  "connector_maximum_power": 50,  "evse_status_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}

Senaryo 2: yalnızca konektör filtresi

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

Eşleşme: EVSE 1 ve 2 uygundur.

Response
json
{  "connector_maximum_power": 150,  "evse_status_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}

Senaryo 3: fiyat ve konektör filtresi

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

Eşleşme:

  • connector == CCS AND price <= 0.30 olarak değerlendirilir.
  • CCS konektörleri (EVSE 1 ve 2) 0,65 € ve 0,35 € olduğundan fiyat filtresini karşılamaz.
  • Tip 2 konektörü (EVSE 3) fiyatı karşılar ancak konektör filtresini karşılamaz.

Sonuç: İstasyon hariç tutuldu (eşleşen 0 EVSE).

Senaryo 4: fiyat ve güç filtresi

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

Eşleşme:

  • Aynı EVSE üzerinde power >= 100 kW AND price <= 0.40 € olarak değerlendirilir.
  • 150 kW’lık konektör çok pahalıdır (0,65 €).
  • Daha ucuz konektörler (0,25 € ile 0,35 € arası) çok yavaştır (50 kW veya daha az).

Sonuç: İstasyon hariç tutuldu (eşleşen 0 EVSE).

Bu içerik yardımcı oldu mu?

Oluştur

Geliştiriciler

Güncellemeler

Kaynaklar

Yasal

İletişime geçin

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.