Industrial Container Code Recognition (CCR)

The Reality of Terminal Gate OCR

Capturing container codes at active terminal gates presents extreme physical challenges. Cameras are often mounted high (CCR perspectives), resulting in 180-degree inverted text. Combined with harsh outdoor sunlight, deep structural shadows on corrugated metal, and multi-lane sequential checkpoints, standard OCR fails to maintain high throughput. For a deeper dive into overcoming these environmental hurdles, see our core Container OCR capabilities.

StructOCR: Built for the Yard and Gate

Engineered strictly as a high-performance REST API to ensure seamless integration into any language without heavy SDK dependencies, this endpoint is powered by our Logistics Container OCR engine. It features complete rotation invariance—automatically reading upside-down text from top-down cranes without pre-processing. The engine applies strict ISO 6346 validation to verify the owner code and calculate the check digit, guaranteeing data integrity before it reaches your Terminal Operating System (TOS).

Core Industry Applications

Integration & AI Prompts

Call the endpoint directly via HTTP. The API flexibly accepts standard image URLs, direct multipart file uploads, or Base64-encoded strings to minimize network latency on edge networks.

import requests
import base64

# Prepare Base64 Image from local CCTV capture
with open("ccr_lane22_capture.jpg", "rb") as image_file:
    base64_image = base64.b64encode(image_file.read()).decode('utf-8')

url = "https://api.structocr.com/v1/container"
headers = {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "img": base64_image
}

try:
    print("Scanning Gate Capture...")
    response = requests.post(url, headers=headers, json=payload)
    result = response.json()

    if result.get('success'):
        data = result['data']['parsed']
        print("✅ Container Code Extracted!")
        print(f"Full Number:  {data.get('owner_code')}{data.get('category')}{data.get('serial_number')}-{data.get('check_digit')}")
        print(f"Valid ISO:    {data.get('is_valid')}")
        print(f"Confidence:   {result['data'].get('confidence')}")
    else:
        print(f"❌ Extraction Failed: {result.get('error')} - {result.get('message')}")

except Exception as e:
    print(f"An error occurred: {e}")

{
  "success": true,
  "data": {
    "container_number": "ZCSU8921655",
    "is_valid": true,
    "confidence": "High",
    "parsed": {
      "owner_code": "ZCS",
      "category": "U",
      "serial_number": "892165",
      "check_digit": "5"
    }
  }
}