# gem install multipart-post
require 'net/http/post/multipart'

url = URI.parse('https://api.platerecognizer.com/v1/plate-reader/')
path = '/path/to/car.jpg'
File.open(path) do |jpg|
  req = Net::HTTP::Post::Multipart.new url.path,
    "upload" => UploadIO.new(jpg, "image/jpeg", path)
  req['Authorization'] = 'Token my-token******'
  res = Net::HTTP.start(url.host, url.port, use_ssl: true) do |http|
    http.request(req)
  end
end

<?php
// CREATE FILE READY TO UPLOAD WITH CURL
$file = realpath('example.jpg');
if (function_exists('curl_file_create')) { // php 5.5+
  $cFile = curl_file_create($file);
} else {
  $cFile = '@' . realpath($file);
}

//ADD PARAMETER IN REQUEST LIKE regions
$data = array(
    'upload' => $cFile,
    'regions' => 'us-ca' // Optional
);

// Prepare new cURL resource
$ch = curl_init('https://api.platerecognizer.com/v1/plate-reader/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLINFO_HEADER_OUT, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_2TLS);

// Set HTTP Header for POST request
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "Authorization: Token my-token******"  //API KEY
    )
);

// Submit the POST request and close cURL session handle
$result = curl_exec($ch);
print_r($result);exit;
curl_close($ch);
?>

# pip install requests
import requests
from pprint import pprint
regions = ['mx', 'us-ca'] # Change to your country
with open('/path/to/car.jpg', 'rb') as fp:
    response = requests.post(
        'https://api.platerecognizer.com/v1/plate-reader/',
        data=dict(regions=regions),  # Optional
        files=dict(upload=fp),
        headers={'Authorization': 'Token my-token******'})
pprint(response.json())

# Calling with a custom engine configuration
import json
with open('/path/to/car.jpg', 'rb') as fp:
    response = requests.post(
        'https://api.platerecognizer.com/v1/plate-reader/',
        data=dict(regions=['us-ca'], config=json.dumps(dict(region="strict"))),  # Optional
        files=dict(upload=fp),
        headers={'Authorization': 'Token my-token******'})

# Calling the API with 2 regions (Mexico and California).
curl -F 'upload=@/path/to/car.jpg' \
  -F regions=mx \
  -F regions=us-ca \
  -H 'Authorization: Token my-token******' \
  https://api.platerecognizer.com/v1/plate-reader/

# Calling the API with a custom engine configuration and region California.
curl -F 'upload=@/path/to/car.jpg' \
  -F regions=us-ca -F config='{"region":"strict"}' \
  -H 'Authorization: Token my-token******' \
  https://api.platerecognizer.com/v1/plate-reader/

// Using Node-RED?
// Check https://github.com/parkpow/node-red-contrib-plate-recognizer

const fetch = require('node-fetch');
const FormData = require('form-data');
const fs = require('fs');

let image_path = '/path/to/car.jpg'
let body = new FormData();
body.append('upload', fs.createReadStream(image_path));
// Or body.append('upload', base64Image);
body.append('regions', 'us-ca'); // Change to your country
fetch("https://api.platerecognizer.com/v1/plate-reader/", {
        method: 'POST',
        headers: {
            "Authorization": "Token my-token******"
        },
        body: body
    }).then(res => res.json())
    .then(json => console.log(json))
    .catch((err) => {
        console.log(err);
    });

// Complete Example:

// https://github.com/marcbelmont/deep-license-plate-recognition/tree/master/csharp/PlateRecognizer

// Function calling the API:

// https://github.com/marcbelmont/deep-license-plate-recognition/blob/master/csharp/PlateRecognizer/PlateReader.cs#L23

// Complete Example:

// https://github.com/marcbelmont/deep-license-plate-recognition/tree/master/java/PlateRecognizer

// Function calling the API:

// https://github.com/marcbelmont/deep-license-plate-recognition/blob/master/java/PlateRecognizer/src/main/java/com/mycompany/numberplate/recognize.java#L17    

// Complete Android App Example:

// https://github.com/parkpow/alpr-anpr-android/

// Complete Example (Windows or Linux):

// https://github.com/marcbelmont/deep-license-plate-recognition/tree/master/java/PlateRecognizer

// Function calling the API:

// https://github.com/marcbelmont/deep-license-plate-recognition/blob/master/cpp/linux/numberPlate.cpp#L25
// https://github.com/marcbelmont/deep-license-plate-recognition/blob/master/cpp/windows/ConsoleApplication2/ConsoleApplication2.cpp#L29

{
    "processing_time": 288.758,
    "results": [
        {
            "box": {
                "xmin": 143,
                "ymin": 481,
                "xmax": 282,
                "ymax": 575
            },
            "plate": "nhk552",
            "region": {
                "code": "gb",
                "score": 0.747
            },
            "vehicle": {
                "score": 0.798,
                "type": "Sedan",
                "box": {
                    "xmin": 67,
                    "ymin": 113,
                    "xmax": 908,
                    "ymax": 653
                }
            },
            "score": 0.904,
            "candidates": [
                {
                    "score": 0.904,
                    "plate": "nhk552"
                }
            ],
            "dscore": 0.99,
            // Make Model, Orientation and Color are only available if you set mmc=true
            "model_make": [
                {
                    "make": "Riley",
                    "model": "RMF",
                    "score": 0.306
                }
            ],
            "color": [
                {
                    "color": "black",
                    "score": 0.937
                }
            ],
            "orientation": [
                {
                    "orientation": "Front",
                    "score": 0.937
                }
            ]
        }
    ],
    "filename": "1617_7M83K_car.jpg",
    "version": 1,
    "camera_id": null,
    "timestamp": "2020-10-12T16:17:27.574008Z"
}

# Calling the API with just the image
curl -F 'upload=@/path/to/car.jpg' \
  http://localhost:8080/v1/plate-reader/

# Calling with API with optional parameters config and mmc
# The region is set to Mexico and California
curl -F 'upload=@/path/to/car.jpg' \
  -F regions=mx \
  -F regions=us-ca \
  -F mmc=true \
  -F config='{"mode":"fast"}' \
  http://localhost:8080/v1/plate-reader/

{
  "usage":{
    "max_calls":1000,
    "calls":44
  },
  "results":[
    // Same as cloud API example above.
  ],
  "camera_id": "null",
  "timestamp": "2020-01-16 17:00:00",
  "filename":"car.jpg"
}

{
    "version": "1.3.8",
    "license_key": "XXX",
    "webhooks": []
}

{
  "hook": {
    "target": "http://localhost:8081/",
    "id": 2,
    "event": "image.done"
  },
  "data": {
    "processing_time": 0.186,
    "timestamp": "2019-08-31T14:22:06.983Z",
    "results": [
      {
        "box": {
          "xmin": 563,
          "ymin": 530,
          "ymax": 579,
          "xmax": 702
        },
        "plate": "765410",
        "score": 0.9131534678711563,
        "dscore": 0.4084282568529709
      },
      {
        "box": {
          "xmin": 563,
          "ymin": 530,
          "ymax": 579,
          "xmax": 702
        },
        "plate": "830265",
        "score": 0.7700640306685624,
        "dscore": 0.8493143507578083
      }
    ],
    "filename": "14_22_test.jpeg",
    "version": 1,
    "camera_id": null
  }
}

[
    {
        "camera_id": "camera-1",
        "filename": "09-53-36.169692.jpg",
        "timestamp": "2021-07-31T13:53:36.169692Z",
        "timestamp_local": "2021-07-31 09:53:36.169692-04:00",
        "results": [
            {
                "plate": {
                    "type": "Plate",
                    "score": 0.888,
                    "box": {
                        "xmin": 49,
                        "ymin": 455,
                        "xmax": 116,
                        "ymax": 491
                    },
                    "props": {
                        "plate": [
                            {
                                "value": "hdb167a",
                                "score": 0.908
                            }
                        ],
                        "region": [
                            {
                                "value": "us-pa",
                                "score": 0.079
                            }
                        ]
                    }
                },
                "vehicle": {
                    "type": "Sedan",
                    "score": 0.688,
                    "box": {
                        "xmin": 1,
                        "ymin": 171,
                        "xmax": 290,
                        "ymax": 548
                    },
                    "props": {
                        "make_model": [
                            {
                                "make": "Chrysler",
                                "model": "200",
                                "score": 0.037
                            },
                            {
                                "make": "Chrysler",
                                "model": "Pacifica (minivan)",
                                "score": 0.024
                            },
                            {
                                "make": "Chrysler",
                                "model": "Pacifica",
                                "score": 0.021
                            }
                        ],
                        "orientation": [
                            {
                                "value": "Front",
                                "score": 0.925
                            },
                            {
                                "value": "Rear",
                                "score": 0.041
                            },
                            {
                                "value": "Unknown",
                                "score": 0.034
                            }
                        ],
                        "color": [
                            {
                                "value": "white",
                                "score": 0.887
                            },
                            {
                                "value": "silver",
                                "score": 0.027
                            },
                            {
                                "value": "black",
                                "score": 0.014
                            }
                        ]
                    }
                },
                "direction": 345,
                "source_url": "/user-data/video.mp4",
                "position_sec": 11.14
            }
        ]
    }
]

curl -H 'Authorization: Token my-token******' \
  https://api.platerecognizer.com/v1/statistics/

{
  "usage": {
    "month": 1,
    "calls": 128,
    "year": 2019,
    "resets_on": "2019-01-14T00:00:00Z"
  },
  "total_calls": 2500
}