Road Intelligence API

What is the Road Intelligence API?

From one API, access all available Map AI generated data.

• Street-level imagery

• Map Features like speed limit signs, turn restriction signs, and many more

Before starting, make sure you have generated your API keys via API Keys section on your Bee Maps account

API Playground

The API Playground lets you interactively explore and test Bee Maps’ Developer APIs without leaving your browser. You can authenticate, define query geometry, retrieve map features or imagery, and view the live API responses – all in one place.

This is ideal for developers who want to experiment with the API before integration.

---

Quick Start Guide

1. Login to your dashboard on Beemaps.com

2. From Bee Maps Dashboard, go to Developers → Playground

3. Click Get API Key

4. Enter coordinates (in [lon, lat] format) and a radius

5. Enable Retrieve Imagery or Retrieve Map Features as needed

6. Click Submit to see results in the response panel

---

Build your query

Authentication

• API Key → Click Get API Key to automatically generate a key.

  • You can regenerate or clear it anytime by selecting Clear API Key.

Geometry

• There are multiple ways to specify your query area.

  • Point

  • Line

  • Polygon

• You can view geometry examples by clicking Examples beside the Geometry title.

Note: The format for coordinates is longitude first, not latitude/longitude. Example: [-122.413, 37.786]

(1) Point

Specify your query area.

• Coordinates → Enter the center of the query area in [longitude, latitude] format.

• Radius → The radius of your query circle in meters.

  • Example: 100 will query all data within 100 meters of the center point.

(2) Line

• Coordinates → Enter the array of coordinates.

• Buffer → The area in meters around the line path that you want to query, 50 meters is a healthy buffer for most use cases.

(3) Polygon

• Coordinates → Enter the array of coordinate pairs for each point in the polygon.

Retrieve Map Features

Toggle this on to return map feature data such as:

• Stop signs

• Speed limits

• Fire hydrants

• Turn rules

• Highways

• Traffic lights

This is useful for developers interested in feature-level spatial intelligence rather than raw imagery.

Retrieve Imagery

Enable this to retrieve imagery data captured by Bee devices.

• Azimuth → Specify camera direction in degrees (0–360°).

  • Example: 90 for east-facing imagery.

• Tolerance → Enter the allowed directional variance in degrees.

  • Example: 10 will include frames within ±10° of your chosen azimuth.

• Minimum Week → Lets you filter by the most recent data week available.

API Request Preview

Displays the generated curl command for your query. This includes:

• API URL

• Authentication header

• Data type e.g. map features, imagery

• Geometry

Example API Request

curl -X POST 'https://beemaps.com/api/developer/map-data?apiKey=dce5a9af-73f7-4535-baa7-176f075f3c6f' \
-H 'Content-Type: application/json' \
--data '{
  "type": [
    "imagery",
    "mapFeatures"
  ],
  "geometry": {
    "type": "Point",
    "coordinates": [
      -122.39207881646443,
      37.78190506177117
    ],
    "radius": 250
  }
}'

API Response Format

Below is an example response format that includes both map features and imagery.

{
  "totalCreditsUsed": 30,
  "totalCreditsRemaining": -138430,
  "mapFeatureResults": {
    "type": "mapFeatures",
    "data": [
      {
        "id": "688f87fbb151a8600e3c0496",
        "status": "active",
        "properties": {
          "turnRules": "no_right_turn"
        },
        "position": {
          "lon": -122.40995306137654,
          "lat": 37.77042290263696,
          "azimuth": 319.7009206758463,
          "alt": -27.013788732394367,
          "size": {
            "width": 0.6542170893518451,
            "height": 0.7926537705707328,
            "units": "m"
          }
        },
        "observed": {
          "firstSeen": "2025-08-03T15:45:47.281Z",
          "lastSeen": "2025-08-03T15:45:47.281Z"
        },
        "confidence": 0.20957326668368817,
        "class": "turn-restriction-sign",
        "n_detections": 1,
        "url": "https://network-sandbox-processed-data.s3.us-west-2.amazonaws.com/68c89d9dc645f0a79608feaf/keyframes/98.jpg",
        "x": 0.6723372781065089,
        "y": 0.45068359375,
        "w": 0.02021696252465483,
        "h": 0.0419921875
      }
    ],
    "creditsUsed": 5
  },
  "imageryResults": {
    "type": "imagery",
    "data": [
      {
        "url": "https://network-sandbox-processed-data.s3.us-west-2.amazonaws.com/6917a40173e090b74632a03a/keyframes/82.jpg",
        "timestamp": "2025-11-14T19:45:33.853Z",
        "sequence": "6917