Seçiciler

Ağ gecikmesini ve oluşturma performansını optimize etmek için Chargetrip MVT ve JSON karo servisleri varsayılan olarak minimum bir yük döndürür. Bu varsayılan yük, harita karolarını hızlı oluşturmak için gereken temel geometri ve kümeleme verilerini sağlar.

Seçicileri kullanarak, gereksiz yük oluşturmadan istemci uygulamanızın ihtiyaç duyduğu belirli istasyon veri niteliklerini isteyebilirsiniz.

Uygulama

Belirli istasyon niteliklerini istemek için karo isteği URL’nize station_properties[] sorgu parametresini ekleyin. Dahil etmek istediğiniz her seçici için parametreyi tekrarlayın:

https://api.chargetrip.io/v2/station/...?station_properties[]={selector1}&station_properties[]={selector2}&station_properties[]={selector3}

Kullanılabilir seçiciler

Seçiciler yalnızca istasyon özelliklerine uygulanır; küme özellikleri etkilenmez ve her zaman count ve expansion_zoom döndürür.

count · integer · default

Bir kümedeki istasyon sayısı. 1 değeri bir istasyon özelliğini, 1’den büyük bir değer ise bir küme özelliğini gösterir.

id · string · default

İstasyonun benzersiz Chargetrip tanımlayıcısı. Yalnızca MVT karoları için geçerlidir.

lng · float

İstasyonun boylamı. Yalnızca MVT karoları için geçerlidir.

lat · float

İstasyonun enlemi. Yalnızca MVT karoları için geçerlidir.

operator_id · string

İstasyonun operatörünün benzersiz Chargetrip kimliği. Operatör bilinmiyorsa döndürülmez.

station_maximum_power · integer

İstasyonda bulunan maksimum şarj gücü (kW cinsinden). Bu değer statiktir ve konnektör filtrelerinden bağımsız olarak her zaman istasyonun en yüksek kapasitesini yansıtır.

connector_maximum_power · integer

connectors[] filtresiyle eşleşen konnektörlerden elde edilebilen maksimum şarj gücü (kW cinsinden). Filtre sağlanmazsa tüm konnektörler dikkate alınır ve değer station_maximum_power ile eşleşir.

preferred_operator · boolean

Bir istasyonun operatörünün tercih edilen operatör olup olmadığını belirtir. Operatör tercihleri Chargetrip panosunda yönetilebilir.

connector_minimum_energy_price · float · betaBeta Bu alan beta aşamasındadır ve kararlı hale gelmeden önce değişebilir.

İstasyonun konektörleri arasındaki en düşük enerji fiyatı. Mevcut değilse döndürülmez. Yalnızca Eco-Movement istasyon veritabanı kullanılıyorsa geçerlidir; aksi halde yok sayılır.

connector_maximum_energy_price · float · betaBeta Bu alan beta aşamasındadır ve kararlı hale gelmeden önce değişebilir.

İstasyonun konektörleri arasındaki en yüksek enerji fiyatı. Mevcut değilse döndürülmez. Yalnızca Eco-Movement istasyon veritabanı kullanılıyorsa geçerlidir; aksi halde yok sayılır.

price_vat · float · betaBeta Bu alan beta aşamasındadır ve kararlı hale gelmeden önce değişebilir.

Fiyata uygulanan KDV. Mevcut değilse döndürülmez. Yalnızca Eco-Movement istasyon veritabanı kullanılıyorsa geçerlidir; aksi halde yok sayılır.

price_valid_until · string · betaBeta Bu alan beta aşamasındadır ve kararlı hale gelmeden önce değişebilir.

Fiyatın geçerli olduğu son tarih ve saat. Mevcut değilse döndürülmez. Yalnızca Eco-Movement istasyon veritabanı kullanılıyorsa geçerlidir; aksi halde yok sayılır.

price_original_currency · string · betaBeta Bu alan beta aşamasındadır ve kararlı hale gelmeden önce değişebilir.

Fiyatın currency birimine dönüştürülmeden önce başlangıçta tanımlandığı para birimi. Mevcut değilse döndürülmez. Yalnızca Eco-Movement istasyon veritabanı kullanılıyorsa geçerlidir; aksi halde yok sayılır.

price_conversion_rate · float · betaBeta Bu alan beta aşamasındadır ve kararlı hale gelmeden önce değişebilir.

Fiyatın özgün para biriminden currency birimine dönüştürülmesinde kullanılan kur. Mevcut değilse döndürülmez. Yalnızca Eco-Movement istasyon veritabanı kullanılıyorsa geçerlidir; aksi halde yok sayılır.

evses_blocked · integer

Fiziksel veya elektronik olarak engellenmiş EVSE sayısı. Bir connectors[] filtresi verilirse yalnızca seçilen konnektör türlerinden en az birine sahip engellenmiş EVSE’leri sayar.

evses_planned · integer

Planlanmış durumdaki EVSE sayısı. Bir connectors[] filtresi verilirse yalnızca seçilen konnektör türlerinden en az birine sahip planlanmış EVSE’leri sayar.

evses_available · integer

Kullanılabilir durumdaki EVSE sayısı. Bir connectors[] filtresi verilirse yalnızca seçilen konnektör türlerinden en az birine sahip kullanılabilir EVSE’leri sayar.

evses_charging · integer

Şu anda dolu olan EVSE sayısı. Bir connectors[] filtresi verilirse yalnızca seçilen konnektör türlerinden en az birine sahip şarj olan EVSE’leri sayar.

evses_unknown · integer

Gerçek zamanlı durumu şu anda bilinmeyen EVSE sayısı. Bir connectors[] filtresi verilirse yalnızca seçilen konnektör türlerinden en az birine sahip durumu bilinmeyen EVSE’leri sayar.

evses_reserved · integer

Bir sürücü için rezerve edilmiş EVSE sayısı. Bir connectors[] filtresi verilirse yalnızca seçilen konnektör türlerinden en az birine sahip rezerve edilmiş EVSE’leri sayar.

evses_out_of_order · integer

Arızalı olarak işaretlenmiş EVSE sayısı. Bir connectors[] filtresi verilirse yalnızca seçilen konnektör türlerinden en az birine sahip arızalı EVSE’leri sayar.

evses_inoperative · integer

Geçici olarak çalışmayan EVSE sayısı. Bir connectors[] filtresi verilirse yalnızca seçilen konnektör türlerinden en az birine sahip geçici olarak çalışmayan EVSE’leri sayar.

Örnekler

https://api.chargetrip.io/v2/station/10/582/325/tile.json  ?station_properties[]=station_maximum_power  &station_properties[]=preferred_operator

{  "type": "FeatureCollection",  "features": [    // Station feature (count = 1)    {      "id": "5e5f3e8f8e0c1a0012345678",      "type": "Feature",      "geometry": {        "type": "Point",        "coordinates": [4.895168, 52.370216]      },      "properties": {        "station_maximum_power": 350,        "preferred_operator": true      }    },   // Cluster feature (unaffected by selectors)    {      "type": "Feature",      "geometry": {        "type": "Point",        "coordinates": [5.1214, 52.0907]      },      "properties": {        "count": 4,        "expansion_zoom": 14      }    }  ]}

https://api.chargetrip.io/v2/station/10/582/325/tile.mvt  ?station_properties[]=id  &station_properties[]=station_maximum_power  &station_properties[]=preferred_operator

// Station feature ('count' is omitted because it wasn't requested as a selector){  "id": "5e5f3e8f8e0c1a0012345678",  "preferred_operator": true,  "station_maximum_power": 350}// Cluster feature (unaffected by selectors){  "count": 4,  "expansion_zoom": 14}

https://api.chargetrip.io/v2/station/10/582/325/tile.json  ?connectors[]=IEC_62196_T2_COMBO  &station_properties[]=connector_maximum_power  &station_properties[]=evses_available

{  "type": "FeatureCollection",  "features": [    {      "id": "5e5f3e8f8e0c1a0012345678",      "type": "Feature",      "geometry": {        "type": "Point",        "coordinates": [4.895168, 52.370216]      },      "properties": {        "connector_maximum_power": 300,        "evses_available": 2      }    }  ]}