Get level vehicle info · v1.1 · POST Fill a vehicle picker, step by step

BeMap name: Get level vehicle info · v1.1 · POST

POST/vehicle/1.1/getlevelvehicleinfo

The same step-by-step choices, with the criteria sent in a JSON body.

The whole description

In BeMap's words

Returns the list of available vehicle info for the specified level.

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

levelenumrequired
Level of researched information.
9 accepted values
NAME
VARIANT
YEAR
BATTERY_NAME
MOTOR_TYPE
CHARGE_POWER_DC
CHARGE_POWER_AC
CHARGE_POWER_AC1
CHARGE_POWER_AC3
geoserverstring
Geoserver name.
brandIdstring
EV vehicle brand ID.
namestring
Vehicle model name.
variantstring
Vehicle model variant name.
yearstring
Year of release and end of series in format yyyy or yyyy-yyyy.
batteryNamestring
Battery name.
batteryCapacitystringdeprecated
Battery capacity.
motorTypeenum
Define the type of motor (engine), is an electric or PHEV motor.
3 accepted values
EV Electric Vehicle.
HEV Hybrid Electric Vehicle.
PHEV Plug-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.

Response

200, schema string[].

Response fields

An array of string.

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

Get level vehicle info · v1.1

curl -X POST 'https://bemap.benomad.com/bgis/service/vehicle/1.1/getlevelvehicleinfo' \ -u 'YOUR_ACCOUNT:YOUR_API_KEY' \ --fail-with-body \ -H 'Content-Type: application/json' \ -d '{ "level": "BATTERY_NAME", "brandId": "5e903acb9548987051674126", "name": "Zoe" }'

Write the code that calls the BeMap API operation "Get level vehicle info · v1.1 · POST": POST https://bemap.benomad.com/bgis/service/vehicle/1.1/getlevelvehicleinfo - Authenticate with HTTP Basic: the BeMap account as the user name, the API key as the password. Do not follow redirects: a 302 means the credentials were not sent. - Send JSON (Content-Type: application/json) of type `LevelVehicleInfoRequest`; it requires `level`. - Use only the fields the reference lists: BeMap ignores an unknown field name without an error, so a misspelt field configures nothing. - A 400 with "Access Denied" means the account lacks the Vehicle or EV smart routing option; a 401, a wrong account or key. Reference, with every field and what each value means: https://benomad.com/dev/doc/bemap-api/api/electric-mobility/vehicle-getlevelvehicleinfo-v1-1-post.md

`NAME`
`VARIANT`
`YEAR`
`BATTERY_NAME`
`MOTOR_TYPE`
`CHARGE_POWER_DC`
`CHARGE_POWER_AC`
`CHARGE_POWER_AC1`
`CHARGE_POWER_AC3`

`EV`	Electric Vehicle.
`HEV`	Hybrid Electric Vehicle.
`PHEV`	Plug-in Hybrid Electric Vehicle (with electric plug).