Skip to content

Vehicle picture Get one picture of a vehicle

BeMap name: Vehicle picture

GET/vehicle/picture/1.0/getone

One picture of a vehicle model, from the angle you choose.

The whole description

In BeMap's words

Returns a picture of the vehicle.

Returns a picture of the vehicle.

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

Query parameters

vehicleUuidKeystringrequiredquery

pictureViewenumquery

6 accepted values

`FRONT`	Front View of the vehicle's picture.
`REAR`	Rear View of the vehicle's picture.
`SIDE`	Side View of the vehicle's picture.
`PERSPECTIVE`	Perspective View of the vehicle's picture.
`UP`	Up View of the vehicle's picture.
`NOT_SUPPORTED_VALUE`	Not supported value for this API version.

Response

200, schema base64 string.

Response fields

A plain value.

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

Vehicle picture

Request

curl -X GET 'https://bemap.benomad.com/bgis/service/vehicle/picture/1.0/getone?vehicleUuidKey=3043cf1b-e35f-447e-91d2-f4cd1a6dfa69&pictureView=PERSPECTIVE' \
  -u 'YOUR_ACCOUNT:YOUR_API_KEY' \
  --fail-with-body \
  -o image

const response = await fetch('https://bemap.benomad.com/bgis/service/vehicle/picture/1.0/getone?vehicleUuidKey=3043cf1b-e35f-447e-91d2-f4cd1a6dfa69&pictureView=PERSPECTIVE', {
  method: 'GET',
  headers: {
    Authorization: 'Basic ' + btoa('YOUR_ACCOUNT:YOUR_API_KEY'),
  },
  redirect: 'manual', // a missing credential answers 302: never follow it
});

if (response.type === 'opaqueredirect' || (response.status >= 300 && response.status < 400)) throw new Error('BeMap redirected to its login page: no credentials reached it');
if (!response.ok) throw new Error(`BeMap answered ${response.status}: ${await response.text()}`);
const image = await response.blob(); // of the type its Content-Type names

import requests

response = requests.get(
    "https://bemap.benomad.com/bgis/service/vehicle/picture/1.0/getone?vehicleUuidKey=3043cf1b-e35f-447e-91d2-f4cd1a6dfa69&pictureView=PERSPECTIVE",
    auth=("YOUR_ACCOUNT", "YOUR_API_KEY"),
    allow_redirects=False,  # a missing credential answers 302: never follow it
)
if response.is_redirect:
    raise RuntimeError("BeMap redirected to its login page: no credentials reached it")
if response.status_code != 200:
    raise RuntimeError(f"BeMap answered {response.status_code}: {response.text}")
with open("image", "wb") as f:  # of the type its Content-Type names
    f.write(response.content)

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.Base64;

String auth = Base64.getEncoder().encodeToString("YOUR_ACCOUNT:YOUR_API_KEY".getBytes(StandardCharsets.UTF_8));

HttpRequest request = HttpRequest.newBuilder(URI.create("https://bemap.benomad.com/bgis/service/vehicle/picture/1.0/getone?vehicleUuidKey=3043cf1b-e35f-447e-91d2-f4cd1a6dfa69&pictureView=PERSPECTIVE"))
    .header("Authorization", "Basic " + auth)
    .GET()
    .build();

// HttpClient never follows redirects by default: a 302 means a missing credential.
HttpResponse<byte[]> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofByteArray());
if (response.statusCode() / 100 == 3) throw new IllegalStateException("BeMap redirected to its login page: no credentials reached it");
if (response.statusCode() != 200) throw new IllegalStateException("BeMap answered " + response.statusCode() + ": " + new String(response.body(), StandardCharsets.UTF_8));
Files.write(Path.of("image"), response.body()); // of the type its Content-Type names

<?php
$ch = curl_init('https://bemap.benomad.com/bgis/service/vehicle/picture/1.0/getone?vehicleUuidKey=3043cf1b-e35f-447e-91d2-f4cd1a6dfa69&pictureView=PERSPECTIVE');
curl_setopt_array($ch, [
    CURLOPT_USERPWD => 'YOUR_ACCOUNT:YOUR_API_KEY',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_FOLLOWLOCATION => false, // a missing credential answers 302: never follow it
]);
$response = curl_exec($ch);
if ($response === false) throw new RuntimeException(curl_error($ch));
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($status >= 300 && $status < 400) throw new RuntimeException('BeMap redirected to its login page: no credentials reached it');
if ($status !== 200) throw new RuntimeException("BeMap answered $status: $response");

file_put_contents('image', $response); // of the type its Content-Type names

using System.Net;
using System.Net.Http.Headers;
using System.Text;

// AllowAutoRedirect = false: a missing credential answers 302, never follow it.
var client = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });
var token = Convert.ToBase64String(Encoding.UTF8.GetBytes("YOUR_ACCOUNT:YOUR_API_KEY"));
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", token);

var response = await client.GetAsync("https://bemap.benomad.com/bgis/service/vehicle/picture/1.0/getone?vehicleUuidKey=3043cf1b-e35f-447e-91d2-f4cd1a6dfa69&pictureView=PERSPECTIVE");
if ((int)response.StatusCode / 100 == 3) throw new HttpRequestException("BeMap redirected to its login page: no credentials reached it");
if (response.StatusCode != HttpStatusCode.OK) throw new HttpRequestException($"BeMap answered {(int)response.StatusCode}: {await response.Content.ReadAsStringAsync()}");
File.WriteAllBytes("image", await response.Content.ReadAsByteArrayAsync()); // of the type its Content-Type names

Build with AI

Write the code that calls the BeMap API operation "Vehicle picture": GET https://bemap.benomad.com/bgis/service/vehicle/picture/1.0/getone

- 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.
- Query parameters: `vehicleUuidKey` (required), `pictureView`.
- 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 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-picture-getone.md

With the BeMap MCP server, your assistant also checks each request against the specification before sending it.

Try it