BeMapAPI
BeMap 4.1.0

Find vehicles (POST) · v1.0 Search the electric vehicle database

Deprecated

BeMap name: Find vehicles (POST) · v1.0

POST/vehicle/1.0/findvehicles

Newer version: v1.1Part of Electric vehicle databaseBeMap's service page

BeMap marks this version deprecated: v1.1 replaces it.

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.

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, 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