The Best Python Library for Shipping Container OCR

from structocr import StructOCR
from structocr.exceptions import APIError, InvalidAPIKeyError

# Get 200 free credits:
# 👉 https://structocr.com/register
# Initialize with your API Key
client = StructOCR("YOUR_API_KEY_HERE")

def scan_shipping_container():
    # Note: Supports JPG, PNG, WebP (Max 4.5MB)
    # Target: Shipping Container Number (ISO 6346)
    image_path = "container_image.jpg"

    try:
        print(f"Scanning {image_path}...")
        
        # The SDK handles file upload and API communication
        result = client.scan_container(image_path)

        if result and result.get('success'):
            data = result['data']
            print("✅ Container Extraction Successful!")
            
            print(f"Container Number: {data.get('container_number')}")
            print(f"Is Valid (Check Digit): {data.get('is_valid')}")
            print(f"Confidence: {data.get('confidence')}")

            parsed_data = data.get('parsed', {})
            print(f"Owner Code: {parsed_data.get('owner_code')}")
            print(f"Category: {parsed_data.get('category')}")
            print(f"Serial Number: {parsed_data.get('serial_number')}")
            print(f"Check Digit: {parsed_data.get('check_digit')}")

            if data.get('is_valid'):
                print("\nContainer number check digit is valid.")
            else:
                print("\nContainer number check digit is invalid. Please verify.")

        else:
            print(f"❌ Extraction Failed: {result.get('error')}")

    except InvalidAPIKeyError as e:
        print(f"Error: Invalid API Key. {e}")
    except APIError as e:
        print(f"Error communicating with the API: {e}")
    except Exception as e:
        print(f"An unexpected error occurred: {e}")

if __name__ == "__main__":
    scan_shipping_container()