Detect number plate in an image

Detect Number Plate transformation allows the user to detect all car number plates in the image. It returns a set of coordinates which can then be used for multiple purposes.

This transformation supports png, jpeg, jpg, webp, cr2, nef, rw2, dng, orf, raw, heic, heif, avif, tiff and tif type of files.

The result of Detect Number Plate is a JSON value with multiple sets of 4 coordinate points, such as:

{
    "polygons": [
        [
            [1106, 4608],
            [3960, 4800],
            [3910, 6131],
            [1164, 4988]
        ],
        [
            [1476, 3678],
            [2960, 3807],
            [2940, 4131],
            [1464, 3983]
        ]
    ]
}

The above JSON response includes:

Two sets of coordinate points indicate two number plates on the image. Each set of coordinate points maps to a rectangle box that frames the number plate on the image. The coordinate points start from the top-left corner and proceed in a clockwise direction to create the box.
In the above example, there are two sets of coordinates, but there can be "n" sets of coordinates. If the response is empty, then there are no number plates.

note

Instead of getting the output in a traditional CDN URL, you will get the JSON output from the Context API, while the CDN URL will return the original image without any modifications.

Original Image
Detect Number Plate
Context API Response

https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/race_car.jpeg

<PixelBinImage
    url="https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/race_car.jpeg"
/>

import Pixelbin from "@pixelbin/core";

const obj = {
    cloudName: "dummy-cloudname",
    zone: "FIDrmb",
    version: "v2",
    transformations: [],
    filePath: "images/transformation/race_car.jpeg",
    baseUrl: "https://cdn.pixelbin.io",
};

const url = Pixelbin.default.utils.objToUrl(obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/race_car.jpeg

const Pixelbin = require("@pixelbin/admin");

const obj = {
    cloudName: "dummy-cloudname",
    zone: "FIDrmb",
    version: "v2",
    transformations: [],
    filePath: "images/transformation/race_car.jpeg",
    baseUrl: "https://cdn.pixelbin.io",
};

const url = Pixelbin.url.objToUrl(obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/race_car.jpeg

from pixelbin.utils.url import obj_to_url

obj = {
    "cloudName": "dummy-cloudname",
    "zone": "FIDrmb",
    "version": "v2",
    "transformations": [],
    "filePath": "images/transformation/race_car.jpeg",
    "baseUrl": "https://cdn.pixelbin.io",
}

url = obj_to_url(obj)

# url
# https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/race_car.jpeg

package main

import (
 "fmt"
 "github.com/pixelbin-dev/pixelbin-go/v2/sdk/utils/url"
)

func main() {
    obj := map[string]interface{}{
        "cloudName": "dummy-cloudname",
        "zoneSlug": "FIDrmb",
        "version": "v2",
        "transformations": []map[string]interface{}{
            
        },
        "filePath": "images/transformation/race_car.jpeg",
        "baseUrl": "https://cdn.pixelbin.io",
        "options": map[string]interface{}{},
    }

    urlstring, err := url.ObjToUrl(obj)

    if err != nil {
        fmt.Println(err)
    }
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/race_car.jpeg

import com.pixelbin.url.UrlObj
import com.pixelbin.Utils
import com.pixelbin.transformation.TransformationObj

fun main(){
    val obj = UrlObj(
        cloudName = "dummy-cloudname",
        zone = "FIDrmb",
        version = "v2",
        transformation = arrayListOf(
            
        ),
        filePath = "images/transformation/race_car.jpeg",
        baseUrl = "https://cdn.pixelbin.io"
    )

    val url = Utils.objToUrl(obj)
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/race_car.jpeg

using System;
using System.Collections.Generic;
using System.IO;
using Pixelbin.Utils;

namespace ExampleNamespace
{
    class ExampleClass
    {
        static void Main(string[] args)
        {
            UrlObj obj = new UrlObj(
                version: "v2",
                cloudName: "dummy-cloudname",
                filePath: "images/transformation/race_car.jpeg",
                zone: "FIDrmb",
                baseUrl: "https://cdn.pixelbin.io",
                transformations: new List<UrlTransformation>() {
                    
                }
            );

            string url = Url.ObjToUrl(obj);
        }
    }
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/race_car.jpeg

<?php
require 'vendor/autoload.php';
use Pixelbin\Utils\Url;

$obj = [
    "cloudName" => "dummy-cloudname",
    "zone" => "FIDrmb",
    "version" => "v2",
    "options" => [],
    "transformations" => [
        
    ],
    "filePath" => "images/transformation/race_car.jpeg",
    "baseUrl" => "https://cdn.pixelbin.io",
];

$url = Url::obj_to_url($obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/race_car.jpeg
?>

https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/numPlate.detect()/images/transformation/race_car.jpeg

<PixelBinImage
    url="https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/numPlate.detect()/images/transformation/race_car.jpeg"
/>

import Pixelbin from "@pixelbin/core";

const obj = {
    cloudName: "dummy-cloudname",
    zone: "FIDrmb",
    version: "v2",
    transformations: [{"name":"detect","plugin":"numPlate"}],
    filePath: "images/transformation/race_car.jpeg",
    baseUrl: "https://cdn.pixelbin.io",
};

const url = Pixelbin.default.utils.objToUrl(obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/numPlate.detect()/images/transformation/race_car.jpeg

const Pixelbin = require("@pixelbin/admin");

const obj = {
    cloudName: "dummy-cloudname",
    zone: "FIDrmb",
    version: "v2",
    transformations: [{"name":"detect","plugin":"numPlate"}],
    filePath: "images/transformation/race_car.jpeg",
    baseUrl: "https://cdn.pixelbin.io",
};

const url = Pixelbin.url.objToUrl(obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/numPlate.detect()/images/transformation/race_car.jpeg

from pixelbin.utils.url import obj_to_url

obj = {
    "cloudName": "dummy-cloudname",
    "zone": "FIDrmb",
    "version": "v2",
    "transformations": [{"name":"detect","plugin":"numPlate"}],
    "filePath": "images/transformation/race_car.jpeg",
    "baseUrl": "https://cdn.pixelbin.io",
}

url = obj_to_url(obj)

# url
# https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/numPlate.detect()/images/transformation/race_car.jpeg

package main

import (
 "fmt"
 "github.com/pixelbin-dev/pixelbin-go/v2/sdk/utils/url"
)

func main() {
    obj := map[string]interface{}{
        "cloudName": "dummy-cloudname",
        "zoneSlug": "FIDrmb",
        "version": "v2",
        "transformations": []map[string]interface{}{
            {"plugin": "numPlate", "name": "detect"},
        },
        "filePath": "images/transformation/race_car.jpeg",
        "baseUrl": "https://cdn.pixelbin.io",
        "options": map[string]interface{}{},
    }

    urlstring, err := url.ObjToUrl(obj)

    if err != nil {
        fmt.Println(err)
    }
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/numPlate.detect()/images/transformation/race_car.jpeg

import com.pixelbin.url.UrlObj
import com.pixelbin.Utils
import com.pixelbin.transformation.TransformationObj

fun main(){
    val obj = UrlObj(
        cloudName = "dummy-cloudname",
        zone = "FIDrmb",
        version = "v2",
        transformation = arrayListOf(
            TransformationObj( plugin = "numPlate", name = "detect", )
        ),
        filePath = "images/transformation/race_car.jpeg",
        baseUrl = "https://cdn.pixelbin.io"
    )

    val url = Utils.objToUrl(obj)
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/numPlate.detect()/images/transformation/race_car.jpeg

using System;
using System.Collections.Generic;
using System.IO;
using Pixelbin.Utils;

namespace ExampleNamespace
{
    class ExampleClass
    {
        static void Main(string[] args)
        {
            UrlObj obj = new UrlObj(
                version: "v2",
                cloudName: "dummy-cloudname",
                filePath: "images/transformation/race_car.jpeg",
                zone: "FIDrmb",
                baseUrl: "https://cdn.pixelbin.io",
                transformations: new List<UrlTransformation>() {
                    new UrlTransformation(plugin: "numPlate", name: "detect", )
                }
            );

            string url = Url.ObjToUrl(obj);
        }
    }
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/numPlate.detect()/images/transformation/race_car.jpeg

<?php
require 'vendor/autoload.php';
use Pixelbin\Utils\Url;

$obj = [
    "cloudName" => "dummy-cloudname",
    "zone" => "FIDrmb",
    "version" => "v2",
    "options" => [],
    "transformations" => [
        ["plugin" => "numPlate", "name" => "detect", ],
    ],
    "filePath" => "images/transformation/race_car.jpeg",
    "baseUrl" => "https://cdn.pixelbin.io",
];

$url = Url::obj_to_url($obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/numPlate.detect()/images/transformation/race_car.jpeg
?>

{
    "data": {
        "polygons": [
            [451, 290],
            [515, 288],
            [516, 309],
            [451, 312]
        ]
    }
}

The Context API Response tab consists of a JSON response that includes one set of coordinates, which indicates there is only one number plate on the image. The given set of coordinate points maps to a rectangle box that frames the number plate on the image. As shown in the below image, the coordinates of the number plate box's corners are calculated concerning the top-left corner of the image, which has (x, y) coordinates of (0, 0). The number plate box has the following (x, y) coordinates, and the coordinate points start from the top-left corner and proceed in a clockwise direction to create the box. As shown in the below image, the top-left is (451px, 290px), the top-right is (517px, 288px), the bottom-right is (451px, 312px), and the bottom-left is (518px, 309px).

Hide number plate

After knowing the exact coordinates of the number plate, you can use the wrap mode and polys parameter of PixelBin's merge transformation to hide or censor them.

Original Image
Detect number plate and hide

https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/race_car.jpeg

<PixelBinImage
    url="https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/race_car.jpeg"
/>

import Pixelbin from "@pixelbin/core";

const obj = {
    cloudName: "dummy-cloudname",
    zone: "FIDrmb",
    version: "v2",
    transformations: [],
    filePath: "images/transformation/race_car.jpeg",
    baseUrl: "https://cdn.pixelbin.io",
};

const url = Pixelbin.default.utils.objToUrl(obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/race_car.jpeg

const Pixelbin = require("@pixelbin/admin");

const obj = {
    cloudName: "dummy-cloudname",
    zone: "FIDrmb",
    version: "v2",
    transformations: [],
    filePath: "images/transformation/race_car.jpeg",
    baseUrl: "https://cdn.pixelbin.io",
};

const url = Pixelbin.url.objToUrl(obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/race_car.jpeg

from pixelbin.utils.url import obj_to_url

obj = {
    "cloudName": "dummy-cloudname",
    "zone": "FIDrmb",
    "version": "v2",
    "transformations": [],
    "filePath": "images/transformation/race_car.jpeg",
    "baseUrl": "https://cdn.pixelbin.io",
}

url = obj_to_url(obj)

# url
# https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/race_car.jpeg

package main

import (
 "fmt"
 "github.com/pixelbin-dev/pixelbin-go/v2/sdk/utils/url"
)

func main() {
    obj := map[string]interface{}{
        "cloudName": "dummy-cloudname",
        "zoneSlug": "FIDrmb",
        "version": "v2",
        "transformations": []map[string]interface{}{
            
        },
        "filePath": "images/transformation/race_car.jpeg",
        "baseUrl": "https://cdn.pixelbin.io",
        "options": map[string]interface{}{},
    }

    urlstring, err := url.ObjToUrl(obj)

    if err != nil {
        fmt.Println(err)
    }
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/race_car.jpeg

import com.pixelbin.url.UrlObj
import com.pixelbin.Utils
import com.pixelbin.transformation.TransformationObj

fun main(){
    val obj = UrlObj(
        cloudName = "dummy-cloudname",
        zone = "FIDrmb",
        version = "v2",
        transformation = arrayListOf(
            
        ),
        filePath = "images/transformation/race_car.jpeg",
        baseUrl = "https://cdn.pixelbin.io"
    )

    val url = Utils.objToUrl(obj)
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/race_car.jpeg

using System;
using System.Collections.Generic;
using System.IO;
using Pixelbin.Utils;

namespace ExampleNamespace
{
    class ExampleClass
    {
        static void Main(string[] args)
        {
            UrlObj obj = new UrlObj(
                version: "v2",
                cloudName: "dummy-cloudname",
                filePath: "images/transformation/race_car.jpeg",
                zone: "FIDrmb",
                baseUrl: "https://cdn.pixelbin.io",
                transformations: new List<UrlTransformation>() {
                    
                }
            );

            string url = Url.ObjToUrl(obj);
        }
    }
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/race_car.jpeg

<?php
require 'vendor/autoload.php';
use Pixelbin\Utils\Url;

$obj = [
    "cloudName" => "dummy-cloudname",
    "zone" => "FIDrmb",
    "version" => "v2",
    "options" => [],
    "transformations" => [
        
    ],
    "filePath" => "images/transformation/race_car.jpeg",
    "baseUrl" => "https://cdn.pixelbin.io",
];

$url = Url::obj_to_url($obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/race_car.jpeg
?>

https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/numPlate.detect()~t.merge(m:wrap,polys:$steps.0.data.polygons,bg:f2994a)/images/transformation/race_car.jpeg

<PixelBinImage
    url="https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/numPlate.detect()~t.merge(m:wrap,polys:$steps.0.data.polygons,bg:f2994a)/images/transformation/race_car.jpeg"
/>

import Pixelbin from "@pixelbin/core";

const obj = {
    cloudName: "dummy-cloudname",
    zone: "FIDrmb",
    version: "v2",
    transformations: [{"name":"detect","plugin":"numPlate"},{"name":"merge","plugin":"t","values":[{"key":"m","value":"wrap"},{"key":"polys","value":"$steps.0.data.polygons"},{"key":"bg","value":"f2994a"}]}],
    filePath: "images/transformation/race_car.jpeg",
    baseUrl: "https://cdn.pixelbin.io",
};

const url = Pixelbin.default.utils.objToUrl(obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/numPlate.detect()~t.merge(m:wrap,polys:$steps.0.data.polygons,bg:f2994a)/images/transformation/race_car.jpeg

const Pixelbin = require("@pixelbin/admin");

const obj = {
    cloudName: "dummy-cloudname",
    zone: "FIDrmb",
    version: "v2",
    transformations: [{"name":"detect","plugin":"numPlate"},{"name":"merge","plugin":"t","values":[{"key":"m","value":"wrap"},{"key":"polys","value":"$steps.0.data.polygons"},{"key":"bg","value":"f2994a"}]}],
    filePath: "images/transformation/race_car.jpeg",
    baseUrl: "https://cdn.pixelbin.io",
};

const url = Pixelbin.url.objToUrl(obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/numPlate.detect()~t.merge(m:wrap,polys:$steps.0.data.polygons,bg:f2994a)/images/transformation/race_car.jpeg

from pixelbin.utils.url import obj_to_url

obj = {
    "cloudName": "dummy-cloudname",
    "zone": "FIDrmb",
    "version": "v2",
    "transformations": [{"name":"detect","plugin":"numPlate"},{"name":"merge","plugin":"t","values":[{"key":"m","value":"wrap"},{"key":"polys","value":"$steps.0.data.polygons"},{"key":"bg","value":"f2994a"}]}],
    "filePath": "images/transformation/race_car.jpeg",
    "baseUrl": "https://cdn.pixelbin.io",
}

url = obj_to_url(obj)

# url
# https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/numPlate.detect()~t.merge(m:wrap,polys:$steps.0.data.polygons,bg:f2994a)/images/transformation/race_car.jpeg

package main

import (
 "fmt"
 "github.com/pixelbin-dev/pixelbin-go/v2/sdk/utils/url"
)

func main() {
    obj := map[string]interface{}{
        "cloudName": "dummy-cloudname",
        "zoneSlug": "FIDrmb",
        "version": "v2",
        "transformations": []map[string]interface{}{
            {"plugin": "numPlate", "name": "detect"},,
{"plugin": "t", "name": "merge", "values": []map[string]interface{}{ {"key": "m", "value": "wrap"},{"key": "polys", "value": "$steps.0.data.polygons"},{"key": "bg", "value": "f2994a"},}},
        },
        "filePath": "images/transformation/race_car.jpeg",
        "baseUrl": "https://cdn.pixelbin.io",
        "options": map[string]interface{}{},
    }

    urlstring, err := url.ObjToUrl(obj)

    if err != nil {
        fmt.Println(err)
    }
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/numPlate.detect()~t.merge(m:wrap,polys:$steps.0.data.polygons,bg:f2994a)/images/transformation/race_car.jpeg

import com.pixelbin.url.UrlObj
import com.pixelbin.Utils
import com.pixelbin.transformation.TransformationObj

fun main(){
    val obj = UrlObj(
        cloudName = "dummy-cloudname",
        zone = "FIDrmb",
        version = "v2",
        transformation = arrayListOf(
            TransformationObj( plugin = "numPlate", name = "detect", ),
TransformationObj( plugin = "t", name = "merge", values = hashMapOf( "m" to "wrap","polys" to "$steps.0.data.polygons","bg" to "f2994a"), )
        ),
        filePath = "images/transformation/race_car.jpeg",
        baseUrl = "https://cdn.pixelbin.io"
    )

    val url = Utils.objToUrl(obj)
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/numPlate.detect()~t.merge(m:wrap,polys:$steps.0.data.polygons,bg:f2994a)/images/transformation/race_car.jpeg

using System;
using System.Collections.Generic;
using System.IO;
using Pixelbin.Utils;

namespace ExampleNamespace
{
    class ExampleClass
    {
        static void Main(string[] args)
        {
            UrlObj obj = new UrlObj(
                version: "v2",
                cloudName: "dummy-cloudname",
                filePath: "images/transformation/race_car.jpeg",
                zone: "FIDrmb",
                baseUrl: "https://cdn.pixelbin.io",
                transformations: new List<UrlTransformation>() {
                    new UrlTransformation(plugin: "numPlate", name: "detect", ),
new UrlTransformation(plugin: "t", name: "merge", values: new List<Dictionary<string, string>>() { new Dictionary<string, string>() { { "key", "m" }, { "value", "wrap" } }, new Dictionary<string, string>() { { "key", "polys" }, { "value", "$steps.0.data.polygons" } }, new Dictionary<string, string>() { { "key", "bg" }, { "value", "f2994a" } }} )
                }
            );

            string url = Url.ObjToUrl(obj);
        }
    }
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/numPlate.detect()~t.merge(m:wrap,polys:$steps.0.data.polygons,bg:f2994a)/images/transformation/race_car.jpeg

<?php
require 'vendor/autoload.php';
use Pixelbin\Utils\Url;

$obj = [
    "cloudName" => "dummy-cloudname",
    "zone" => "FIDrmb",
    "version" => "v2",
    "options" => [],
    "transformations" => [
        ["plugin" => "numPlate", "name" => "detect", ],
["plugin" => "t", "name" => "merge", "values" => [ [ "key" => "m", "value" => "wrap" ], [ "key" => "polys", "value" => "$steps.0.data.polygons" ], [ "key" => "bg", "value" => "f2994a" ], ], ],
    ],
    "filePath" => "images/transformation/race_car.jpeg",
    "baseUrl" => "https://cdn.pixelbin.io",
];

$url = Url::obj_to_url($obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/numPlate.detect()~t.merge(m:wrap,polys:$steps.0.data.polygons,bg:f2994a)/images/transformation/race_car.jpeg
?>

info

Click here to learn step-by-step how this works.