Charging time Estimate charging time

BeMap name: Charging time

Part of Charging time and cost · BeMap's service page

Request body

JSON, Content-Type: application/json. Schema ChargingTimeRequest.

• chargingPointPowernumber (double)required

  Nominal power of connector of the charging station (in kW).

• chargingCurrentTypeenumrequired

  Define the current type of charging point power.

  5 accepted values

  NA	Not available (NA).
  AC	Alternating current (AC), but the number of phases is not available.
  AC_SINGLE_PHASE	Alternating current (AC), single phase.
  AC_THREE_PHASES	Alternating current (AC), three phases.
  DC	Direct current (DC).

• geoserverstring

  Geoserver name.

• swidxinteger (int32)deprecated

  Switch index.

• vehiclestring

  Vehicle model (UUID key). Mandatory if energyVehicleFeature parameter is not set.

• energyVehicleFeatureRoutingEnergyVehicleFtr

  Energy vehicle feature for energy consumption estimation. Optional if vehicle parameter is defined.

  Also accepted as routingEnergyVehicleFeature.

  RoutingEnergyVehicleFtr fields

  • scxnumber (double)

    Product of vehicle's front area and aerodynamic coefficient (in m²).

  • crrnumber (double)

    Vehicle's tire rolling resistance coefficient (dimension-less, in interval ]0, 1[).

  • engineEfficiencynumber (double)

    Vehicle's efficiency coefficient between engine and gear (dimension-less, in interval ]0, 1[).

  • batCapacitynumber (double)

    Vehicle's capacity of the battery (in kWh, only if electric vehicle or hybrid re-chargeable, 0 otherwise).

  • energyLoadnumber (double)

    Vehicle's current energy load, state of charge (in kWh).

  • dryWeightinteger (int32)

    Vehicle's weight without any consumables or passengers (in kg).

  • payloadinteger (int32)

    Vehicle's extra load (consumables or passengers weight for example) (in kg).

  • auxConsumptioninteger (int32)

    Vehicle's instantaneous auxiliary equipments consumption (in W).

  • maxAccelnumber (double)

    Maximum acceleration (superior to 0.1, in m/s², based on vehicle's acceleration capacity and expected driving behavior).

  • maxDecelnumber (double)

    Maximum deceleration (inferior to -0.1, in m/s², based on vehicle's braking capacity and expected driving behavior).

  • extTempnumber (float)

    Outside temperature (in °C).

  • maxChargePowernumber (double)

    Maximum charge power AC single phase authorized by the vehicle (in kW).

  • maxChargePowerAc3number (double)

    Maximum charge power AC three phases authorized by the vehicle (in kW).

  • maxChargePowerDcnumber (double)

    Maximum charge power DC authorized by the vehicle (in kW).

  • regenerativeBrakingboolean

    Defines if the vehicle supports regenerative braking (default = true).

• optionsenum[]

  Options of charging time service.

  1 accepted value

  OPTIMUM_BATTERY_CHARGE

  Calculate the optimum charge level (in %) of the vehicle battery at the given charge point; Above this level, the power delivered by the charge point decreases, and the charge takes more time.

• temperatureinteger (int32)

  Temperature in Celsius. Mandatory if vehicle parameter is used. Optional if evf parameter is used. By Default 20.

• remainingBatteryLevelnumber (double)

  Remaining battery level in percent. Available value 0 to 100. By default 0. Mandatory if vehicle parameter is used. Optional if evf parameter is used.

• connectorTypestring

  Connector type ID, used to perform a power limitation based on those connector.

• chargingBatteryLevelnumber (double)

  Desired level of battery after charging (in percent, [1,100]), 100% for a full battery charge.

Response

200, schema ChargingTimeResponse.

Errors

• 400 Bad Request, ErrorResponse
• 302 No credentials were sent. Do not follow the redirect.
• 401 The account or the API key is wrong.

How to read each one: Errors.

Reference pages

• Charging time