BeMapAPI
BeMap 4.1.0

EV vehicles (POST) List vehicle models for trip planning

Deprecated

BeMap name: EV vehicles (POST)

POST/evsmartrouting/vehiclemodels/list/1.0

Part of Electric vehicle databaseBeMap's service page

The same list, with its criteria sent in a JSON body. BeMap marks it deprecated and points to the vehicle search instead.

The whole description

In BeMap's words

Returns the list of available vehicles. Deprecated. Use the vehicle/1.0/findvehicles API.

Returns the list of available vehicles. Deprecated. Use the vehicle/1.0/findvehicles API.

Requires the EV smart routing option. Allow to compute a trip for a electric vehicle. Not enabled on your account? Ask your BeNomad contact.

Request body

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

  • vehiclestring

    Vehicle id (uuid key).

  • brandIdstring

    EV vehicle brand ID.

  • namestring

    Vehicle model name.

  • batteryNamestring

    Battery name.

  • batteryCapacitystringdeprecated

    Battery capacity.

  • yearstring

    Year of release and end of series in format yyyy or yyyy-yyyy.

  • motorTypeenum

    Define the type of motor (engine), is an electric or PHEV motor.

    3 accepted values
    EVElectric Vehicle.
    HEVHybrid Electric Vehicle.
    PHEVPlug-in Hybrid Electric Vehicle (with electric plug).
  • chargerPowerDCnumber (double)

    DC Power in kW of vehicle charger.

  • chargerPowerACnumber (double)

    AC Power in kW of vehicle charger.

  • enableDatasheetboolean

    Enable the returned datasheet of vehicle. See field encDatasheet.

  • coordinateCoordinate

    WGS84 coordinate. Used to filter vehicle data such as available connectors in this country.

    Coordinate fields
    • lonnumber (double)required

      Longitude in degrees decimal (WGS84).

      Also accepted as longitude.

    • latnumber (double)required

      Latitude in degrees decimal (WGS84).

      Also accepted as latitude.

  • countryCodestring

    ISO-3 country code. Used to filter vehicle data such as available connectors in this country.

Response

200, schema VehicleModelsResponse.

Response fields
  • vehiclesVehicleInfo[]

    A list of vehicle information.

    VehicleInfo fields
    • keystring

      Key of vehicle, used to select the vehicle to perform the routing calculation.

    • brandIdstring

      Brand ID of vehicle, can be used for display.

    • brandNamestring

      Brand name of vehicle, can be used for display.

    • titlestringdeprecated

      Title of vehicle, can be used for display.

    • namestring

      Name of vehicle, can be used for display.

    • yearstring

      Year of release and end of series in format yyyy or yyyy-yyyy.

    • variantstring

      Variant or sub name of vehicle.

    • motorTypeenum

      Motor type of vehicle.

      4 accepted values
      EVElectric Vehicle.
      HEVHybrid Electric Vehicle.
      PHEVPlug-in Hybrid Electric Vehicle (with electric plug).
      NOT_SUPPORTED_VALUENot supported value for this API version.
    • batteryNamestring

      The commercial name or power of vehicle battery.

    • connectorTypesinteger (int32)[]

      List of default connector types defined by the server vehicle profile.

    • encDatasheetstring

      Base64 encoded and encrypted JSON that contains the vehicle datasheet.

    • chargerPowerAcSinglePhasenumber (double)

      Maximum charge power (in kW) in AC 1 phase current type.

    • chargerPowerAcThreePhasesnumber (double)

      Maximum charge power (in kW) in AC 3 phases current type.

    • chargerPowerDCnumber (double)

      Maximum charge power (in kW) in DC current type.

Errors

  • 400 Bad Request, EvSmartRoutingErrorResponse
  • 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