BeMapAPI
BeMap 4.1.0

Find vehicles (GET) · v1.1 Search the electric vehicle database

BeMap name: Find vehicles (GET) · v1.1

GET/vehicle/1.1/findvehicles

Part of Electric vehicle database4 tutorialsBeMap's service page

Electric vehicle models with their battery, their charging speed and their WLTP figures, so a driver can find their car.

The whole description

In BeMap's words

Returns the list of available vehicles.

Returns the list of available vehicles.

Requires the Vehicle or EV smart routing option. Allow to get the information of vehicle. Not enabled on your account? Ask your BeNomad contact.

Query parameters

  • vehiclestringquery
  • brandIdstringquery
  • namestringquery
  • variantstringquery
  • yearstringquery
  • batteryNamestringquery
  • batteryCapacitystringquery
  • motorTypeenumquery
    3 accepted values
    EVElectric Vehicle.
    HEVHybrid Electric Vehicle.
    PHEVPlug-in Hybrid Electric Vehicle (with electric plug).
  • chargerPowerDCnumber (double)query
  • chargerPowerACnumber (double)query
  • enableDatasheetbooleanquery
  • lonnumber (double)query
  • latnumber (double)query
  • countryCodestringquery

Response

200, schema VehicleModelsResponseV1Dot1.

Response fields
  • vehiclesVehicleInfoV1Dot1[]

    A list of vehicle information.

    VehicleInfoV1Dot1 fields
    • 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.
    • 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.

    • 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.

    • transportTypeenum

      Transport type.

      9 accepted values
      PEDESTRIANPedestrian.
      BICYCLEBicycle.
      MOTORCYCLEMotorcycle.
      CARPassenger car, tourist car.
      TAXITaxi.
      PUBLIC_BUSPublic bus.
      EMERGENCYEmergency vehicle.
      DELIVERY_TRUCKDelivery truck.
      TRUCKTruck.
    • heightinteger (int32)

      Height in cm.

    • widthinteger (int32)

      Width in cm.

    • lengthinteger (int32)

      Length in cm.

    • batteryNamestring

      The commercial name or power of vehicle battery.

    • 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.

    • maxWeightinteger (int32)

      Maximum weight in tenth of ton.

    • maxWeightPerAxleinteger (int32)

      Maximum weight per axle in tenth of ton.

    • connectorTypesinteger (int32)[]

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

    • plugAndAutoChargePlugAndAutoChargeFront

      Defines if the vehicle has the AutoCharge capability. AutoCharge is an EV charging technology that enables automatic authentication and initiation of a charging session by recognising a unique identifier from the EV. AutoCharge shares similarities with Plug and Charge (PnC) technology, but there are important distinctions between the two. PnC is a more comprehensive authentication standard, established by the ISO 15118 protocol.

      PlugAndAutoChargeFront fields
      • availablebooleanrequired

        Define if the vehicle has the capability of plug and aotomatic starting the charge. Ture if available.

      • iso15118boolean

        Plug & Charge: The ISO 15118 standard is supported. If Autocharge is OCPP version 2, the ISO 15118 and OCPP can be checked.

      • ocppboolean

        The OCPP standard is supported. The Autocharge use OCPP version 1. If Autocharge is OCPP version 2, the ISO 15118 and OCPP can be checked.

    • wltpVehicleWltp

      WLTP information of vehicle.

      VehicleWltp fields
      • urbanWltpnumber (double)

        The WLTP provided by the vehicle manufacturer for an urban cycle. Containing only the first two phases of the complete WLTP cycle.

      • completeWltpnumber (double)

        The WLTP provided by the vehicle manufacturer for a complete cycle. Containing all four phases of WLTP.

    • consumptionInWhPerKmnumber (float)

      Vehicle consumption in Wh/km.

    • encDatasheetstring

      Base64 encoded and encrypted JSON that contains the vehicle datasheet.

Errors

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

Tutorials

Reference pages