EVChargingTariff

public struct EVChargingTariff : Hashable

Tariffs provide detailed pricing information for charging electric vehicles at a specific location. Each tariff describes how costs are calculated based on various factors such as energy consumed, time spent charging, and session duration. Tariffs are typically associated with specific connectors or connector groups, and are only included in the response when relevant data is available and requested. Note: This is a beta release of this feature, so there could be a few bugs and unexpected behaviors. Related APIs may change for new releases without a deprecation process.

  • Name of the tariff. The name is not mandatory for ad-hoc tariffs, but may exist.

    Declaration

    Swift

    public var name: String?

  • Indicates the pricing model.

    Declaration

    Swift

    public var type: EVChargingTariffType

  • Name of the partner providing the tariff, either the charge point operator or eMSP.

    Declaration

    Swift

    public var partner: String

  • A unique ID representing the partner. The same id is used also in other parts of the API and other related HERE APIs.

    Declaration

    Swift

    public var partnerID: String

  • The currency in which the prices are given, represented by the ISO 4217 standard currency code (e.g., EUR, DKK).

    Declaration

    Swift

    public var currency: String

  • Elements composing the tariff. Each element can have multiple components. When multiple elements are present, the associated condition helps the client to select the element that matches the charging session. If no condition matches, the element without any condition applies.

    Please note that tariff elements or conditions requiring access to vehicle APIs are not present in this API. The provided elements can only be used to derive a price estimate, which in most cases is reasonably close to the final price.

    Declaration

    Swift

    public var elements: [EVChargingTariffElement]

  • Creates a new instance.

    • Parameters

      • name: Name of the tariff. The name is not mandatory for ad-hoc tariffs, but may exist.
      • type: Indicates the pricing model.
      • partner: Name of the partner providing the tariff, either the charge point operator or eMSP.
      • partnerID: A unique ID representing the partner. The same id is used also in other parts of the API and other related HERE APIs.
      • currency: The currency in which the prices are given, represented by the ISO 4217 standard currency code (e.g., EUR, DKK).
      • elements: Elements composing the tariff. Each element can have multiple components. When multiple elements are present, the associated condition helps the client to select the element that matches the charging session. If no condition matches, the element without any condition applies.

      Please note that tariff elements or conditions requiring access to vehicle APIs are not present in this API. The provided elements can only be used to derive a price estimate, which in most cases is reasonably close to the final price.

    Declaration

    Swift

    public init(name: String? = nil, type: EVChargingTariffType = EVChargingTariffType.adHoc, partner: String = "", partnerID: String = "", currency: String = "", elements: [EVChargingTariffElement] = [])