Name: Live Traffic Camera Images API | Real-time Road Monitoring
Brand: coolapps.mobi
SKU: api-coolapps.mobi-traffic-images
Availability: InStock
Author: API Market

Yong Jason

# Live Traffic CCTV Camera Images

## Overview
The Live Traffic CCTV Camera Images API provides real-time access to live traffic camera feeds from various geographical regions. It allows developers to integrate up-to-the-minute traffic visuals into their applications, offering dynamic insights into road conditions. These images are captured by video cameras strategically placed along major transportation arteries such as highways, freeways, motorways, expressways, and arterial roads, designed to observe vehicular traffic.

## Features
*   **Global Coverage:** Access traffic camera data from multiple regions and countries.
*   **Real-time Imagery:** Retrieve live images directly from CCTV traffic cameras.
*   **Location-Based Retrieval:** Pinpoint cameras by source region and specific camera identifiers.
*   **Structured Data:** Get detailed information about camera locations, including latitude and longitude.
*   **High Performance:** Optimized for quick retrieval of up-to-date traffic information.

## Use Cases
*   **Transportation Logistics:** Provide real-time road conditions for logistics companies to optimize delivery routes, avoid congestion, and improve fleet management efficiency.
*   **Navigation & Mapping Applications:** Enhance navigation apps with live visual feeds, allowing users to see current traffic situations, road closures, or weather impacts before and during their commute.
*   **Urban Planning & Smart Cities:** Aid city planners and traffic engineers in monitoring traffic flow, identifying congestion hotspots, and assessing the effectiveness of traffic management strategies in real-time.
*   **Emergency Services & Public Safety:** Equip emergency responders with immediate visual context of incident locations, enabling quicker assessments and more effective deployment of resources.
*   **Automotive Industry & Autonomous Vehicles:** Support the development and testing of advanced driver-assistance systems (ADAS) and autonomous driving solutions by providing critical real-world environmental data from road networks.

## API Documentation

### Base URL
All API requests should be made to: `https://prod.api.market/api/v1/coolapps.mobi/traffic-images`

### Authentication
Authentication is handled via API key. Include your API key in the request header:
```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Endpoints

#### 1. List available CCTV regions
This endpoint allows you to discover all geographical regions for which live traffic CCTV camera data is available.

*   **Endpoint:** `GET /api/v1/coolapps.mobi/traffic-images/get_available_regions`
*   **Summary:** List available CCTV regions
*   **Description:** Retrieves a list of regions, each with a source identifier, label, and country.
*   **Authentication:** Requires `x-api-market-key` header.

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/coolapps.mobi/traffic-images/get_available_regions" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK):**

```json
{
  "florida": {
    "label": "Florida",
    "country": "United States"
  },
  "ontario": {
    "label": "Ontario",
    "country": "Canada"
  }
}
```

#### 2. Get CCTV source data
Retrieve detailed camera information for a specific geographical region, including camera IDs, locations, and coordinates.

*   **Endpoint:** `GET /api/v1/coolapps.mobi/traffic-images/get_source/{source}`
*   **Summary:** Get CCTV source data
*   **Description:** Retrieve the camera image properties for a specific region source.
*   **Parameters:**
    *   `source` (path): The identifier for the region (e.g., `florida`, `ontario`). Refer to the `get_available_regions` endpoint for valid source identifiers.
*   **Authentication:** Requires `x-api-market-key` header.

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/coolapps.mobi/traffic-images/get_source/florida" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK):**

```json
[
  {
    "id": 614,
    "location": "I-4 @ MM 60.6 EB",
    "latitude": 28.292213,
    "longitude": -81.580975,
    "cameras": [
      {
        "source": "florida",
        "camera_image_id": "614",
        "description": "0040_I-4_EB_MM_60.6"
      }
    ]
  },
  {
    "id": 615,
    "location": "I-4 @ MM 60.6 WB",
    "latitude": 28.292213,
    "longitude": -81.580975,
    "cameras": [
      {
        "source": "florida",
        "camera_image_id": "615",
        "description": "0041_I-4_WB_MM_60.6"
      }
    ]
  }
]
```

**Example Error Response (400 Bad Request - Invalid Source):**

```json
{
  "error": "Invalid source",
  "source": "../private"
}
```

**Example Error Response (404 Not Found - Source Not Found):**

```json
{
  "error": "Source not found",
  "source": "unknown"
}
```

#### 3. Get CCTV camera image
Retrieve the live image from a specific traffic camera. The response will be the raw image binary data (JPEG, PNG, or WebP).

*   **Endpoint:** `GET /api/v1/coolapps.mobi/traffic-images/get_camera_image/{source}/{camera_image_id}`
*   **Summary:** Get CCTV camera image
*   **Description:** Retrieve the live camera image for a specific source and camera image identifier.
*   **Parameters:**
    *   `source` (path): The identifier for the region (e.g., `florida`).
    *   `camera_image_id` (path): The unique identifier for the specific camera image within the source (e.g., `614`).
*   **Authentication:** Requires `x-api-market-key` header.

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/coolapps.mobi/traffic-images/get_camera_image/florida/614" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY" \
     -o "traffic_image_614.jpg" # Saves the output directly to a file
```

**Example Response (200 OK):**
The response will be binary image data (e.g., `image/jpeg`, `image/png`, or `image/webp`). The `curl` example above saves this directly to a file.

**Example Error Response (404 Not Found - Camera Not Found):**

```json
{
  "error": "Unknown CCTV source",
  "source": "unknown"
}
```

**Example Error Response (502 Bad Gateway - Upstream Image Error):**

```json
{
  "error": "Unable to fetch image",
  "detail": "upstream request failed"
}
```

## Status Codes
*   **200 OK:** Request successful. The API successfully processed the request and returned the expected data.
*   **201 Created:** (Not typically used by this API, as it's a read-only API). Resource successfully created.
*   **400 Bad Request:** Invalid input parameters or malformed request. Check the request body, path parameters, or query parameters for correctness.
*   **401 Unauthorized:** Missing or invalid API key. Ensure `x-api-market-key` header is present and contains a valid key.
*   **403 Forbidden:** Valid API key but insufficient permissions for the requested action.
*   **404 Not Found:** The requested resource was not found. This could be an incorrect endpoint path, a source identifier that doesn't exist, or a camera ID that is not found within a source.
*   **429 Too Many Requests:** Rate limit exceeded. You have sent too many requests in a given amount of time. Implement back-off and retry strategies.
*   **500 Internal Server Error:** A generic server-side error occurred. This indicates an unexpected issue on the API's side. If this persists, please contact support.
*   **503 Service Unavailable:** The service is temporarily unavailable, possibly due to maintenance or overload. Retry the request after a short delay.



## cURL

```bash
# cURL example for synchronous API calls

# 1. Get available regions
echo "--- Getting Available Regions ---"
curl -X GET "https://prod.api.market/api/v1/coolapps.mobi/traffic-images/get_available_regions" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"

echo ""

# 2. Get source data for 'florida'
echo "--- Getting Source Data for Florida ---"
curl -X GET "https://prod.api.market/api/v1/coolapps.mobi/traffic-images/get_source/florida" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"

echo ""

# 3. Get a specific camera image (e.g., source: florida, camera_image_id: 614)
# This will save the image directly to 'traffic_image_florida_614.jpg'
echo "--- Getting Camera Image for Florida/614 ---"
curl -X GET "https://prod.api.market/api/v1/coolapps.mobi/traffic-images/get_camera_image/florida/614" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY" \
     -o "traffic_image_florida_614.jpg"

echo "Image traffic_image_florida_614.jpg downloaded."
```


## FAQ

**Q: What kind of images does this API provide?**

A: This API provides live, real-time still images captured by CCTV cameras observing vehicular traffic on major roads like highways, freeways, and arterial roads.

**Q: How often are the camera images updated?**

A: The images are live, but the refresh rate can depend on the upstream camera source. The API's `Cache-Control` header for image responses typically indicates a short `max-age` (e.g., 30 seconds), meaning the image data could be refreshed by the API as frequently as every 30 seconds.

**Q: Are there any geographical restrictions on camera availability?**

A: The API provides cameras from various regions and countries. You can use the `/get_available_regions` endpoint to see the list of supported regions.

**Q: Can I request historical traffic images?**

A: No, this API is designed for live, real-time traffic camera images only. It does not provide access to historical data.

**Q: What if a camera goes offline or an image isn't available?**

A: If an upstream camera service fails to provide an image, the API will return a `502 Bad Gateway` error with a specific error message (e.g., `Unable to fetch image`). If the camera or source itself cannot be found, a `404 Not Found` error will be returned.

**Q: How do I get more API units or higher rate limits?**

A: Pricing tiers are based on usage volume. If you anticipate high usage or need custom rate limits, please contact us via the provided support channels.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.

Get live traffic CCTV camera images in real-time. Monitor road conditions, identify congestion, and plan routes with up-to-date visual information from major hi

Live Traffic Camera Images API | Real-time Road Monitoring

Free