Rest
选择器
为了优化网络延迟和渲染性能，Chargetrip 的 MVT 和 JSON 瓦片服务默认返回最小化的载荷。该默认载荷提供快速渲染地图瓦片所需的基本几何和聚合数据。
通过使用选择器，您可以只请求客户端应用所需的特定充电站数据属性，而不会产生不必要的载荷开销。
实现
要请求特定的充电站属性，请在瓦片请求 URL 中附加 station_properties[] 查询参数。对每个要包含的选择器重复该参数：
可用的选择器
选择器仅适用于充电站要素，聚合要素不受影响，并且始终返回 count 和 expansion_zoom。
count·integer· default- 聚合点内的充电站数量。数量为 1 表示充电站要素，数量大于 1 则表示聚合要素。
id·string· default- 充电站的 Chargetrip 唯一标识符。仅适用于 MVT 瓦片。
lng·float- 充电站的经度。仅适用于 MVT 瓦片。
lat·float- 充电站的纬度。仅适用于 MVT 瓦片。
operator_id·string- 充电站运营商的唯一 Chargetrip 标识符。如果运营商未知，则不会返回。
station_maximum_power·integer- 充电站可提供的最大充电功率（单位 kW）。此值是静态的，始终反映充电站的最高能力，不受连接器筛选影响。
connector_maximum_power·integer- 与
connectors[]筛选匹配的连接器可提供的最大充电功率（单位 kW）。如果未提供筛选，则考虑所有连接器，此时该值与station_maximum_power一致。 preferred_operator·boolean- 表示充电站的运营商是否为首选运营商。可以在 Chargetrip 的 Dashboard 中管理运营商偏好。
connector_minimum_energy_price·float·Beta 此字段处于 Beta 阶段，在稳定之前可能会发生变化。 - 充电站连接器中最低的能源价格。如果不可用则不返回。
connector_maximum_energy_price·float·Beta 此字段处于 Beta 阶段，在稳定之前可能会发生变化。 - 充电站连接器中最高的能源价格。如果不可用则不返回。
price_vat·float·Beta 此字段处于 Beta 阶段，在稳定之前可能会发生变化。 - 价格所适用的增值税。如果不可用则不返回。
price_valid_until·string·Beta 此字段处于 Beta 阶段，在稳定之前可能会发生变化。 - 价格的有效截止日期和时间。如果不可用则不返回。
price_original_currency·string·Beta 此字段处于 Beta 阶段，在稳定之前可能会发生变化。 - 价格最初定义时使用的货币，即转换为
currency之前的货币。如果不可用则不返回。 price_conversion_rate·float·Beta 此字段处于 Beta 阶段，在稳定之前可能会发生变化。 - 将价格从其原始货币转换为
currency所使用的汇率。如果不可用则不返回。 evses_blocked·integer- 被物理或电子方式阻断的 EVSE 数量。 如果提供了
connectors[]筛选，则只统计至少具有一种所选连接器类型的已阻断的 EVSE。 evses_planned·integer- 处于 planned 状态的 EVSE 数量。 如果提供了
connectors[]筛选，则只统计至少具有一种所选连接器类型的planned EVSE。 evses_available·integer- 处于 available 状态的 EVSE 数量。 如果提供了
connectors[]筛选，则只统计至少具有一种所选连接器类型的available EVSE。 evses_charging·integer- 当前被占用的 EVSE 数量。 如果提供了
connectors[]筛选，则只统计至少具有一种所选连接器类型的正在充电的 EVSE。 evses_unknown·integer- 实时状态当前未知的 EVSE 数量。 如果提供了
connectors[]筛选，则只统计至少具有一种所选连接器类型的状态未知的 EVSE。 evses_reserved·integer- 已为驾驶员预留的 EVSE 数量。 如果提供了
connectors[]筛选，则只统计至少具有一种所选连接器类型的已预留的 EVSE。 evses_out_of_order·integer- 被标记为故障的 EVSE 数量。 如果提供了
connectors[]筛选，则只统计至少具有一种所选连接器类型的故障的 EVSE。 evses_inoperative·integer- 暂时无法运行的 EVSE 数量。 如果提供了
connectors[]筛选，则只统计至少具有一种所选连接器类型的暂时无法运行的 EVSE。
示例
在 JSON 瓦片中请求充电站功率和运营商偏好
在 JSON 瓦片中，充电站要素始终保留必需的要素结构（type、geometry、id），而 properties 仅包含请求的选择器（默认的 count 属性因未被请求而被省略）。聚合要素不受选择器影响，仍会返回 count 和 expansion_zoom。
在 MVT 矢量瓦片中请求充电站 ID、功率和运营商偏好
在 MVT 瓦片中，只有明确请求的选择器才会被编码到充电站要素中（省略默认的 count 属性），而聚合要素不受选择器影响，始终保留 count 和 expansion_zoom。
将选择器与连接器筛选结合，获取实时 EVSE 状态
按特定连接器类型（例如 CCS / IEC_62196_T2_COMBO）筛选时，connector_maximum_power 和 evses_available 的数量仅反映与该连接器筛选匹配的 EVSE。
此内容是否有帮助？