aztecdecoder

README

Dekoder Kodu AZTEC 2D z Dowodu Rejestracyjnego dla Go

Oferujemy Państwu usługę Web API pozwalającą zdekodować dane z kodu AZTEC 2D zapisanego w dowodach rejestracyjnych pojazdów samochodowych.

Nasza biblioteka dekoduje dane z dowodu rejestracyjnego, zapisane w postaci kodu obrazkowego tzw. kod aztec. Dekodowane są wszystkie wymienione pola w dowodzie rejestracyjnym pojazdu.

https://www.pelock.com/pl/produkty/dekoder-aztec

Gdzie znajdzie zastosowanie Dekoder AZTec?

Dekoder AZTec może przydać się firmom i instytucjom, które pragną zautomatyzować proces ręcznego wprowadzania danych z dowodów rejestracyjnych i zastąpić go poprzez wykorzystanie naszej biblioteki programistycznej, która potrafi rozpoznać i rozkodowac kody AZTEC 2D bezpośrednio ze zdjęć dowodów rejestracyjnych lub zeskanowanych już kodów (wykorzystując skaner QR / AZTEC 2D).

Dostępne edycje programistyczne

Dekoder AZTec dostepny jest w trzech edycjach. Każda wersja posiada inne cechy i inne możliwości dekodowania. Wersja oparta o Web API jako jedyna posiada możliwość rozpoznawania i dekodowania danych bezpośrednio ze zdjęć i obrazków. Pozostałe wersje do dekodowania wymagają już odczytanego kodu w postaci tekstu (np. ze skanera).

Wersja Web API

Jest to najbardziej zaawansowana edycja Dekodera AZTec, ponieważ umożliwia precyzyjne rozpoznawanie i dekodowanie kodów AZTEC 2D bezpośrednio ze zdjęć oraz obrazków zapisanych w formatach PNG lub JPG.

Algorytm rozpoznawania obrazu należy do naszej firmy, jest to innowacyjne rozwiązanie rozwijane od podstaw przez prawie rok czasu.

Rozumiemy potrzeby naszych klientów oraz problemy wynikające z rozpoznawnia rzeczywistych zdjęć kodów AZTEC 2D znajdujących się w dowodach rejestracyjnych, które nie zawsze są idealnie wykonane, czy to ze względu na rodzaj aparatu, kąta wykonania zdjęcia, refleksów czy słabej rozdzielczości.

Przy tworzeniu naszego rozwiązania wzieliśmy wszystkie te czynniki pod uwagę i w efekcie nasz algorytm radzi sobie znakomicie z rozpoznawaniem kodów AZTEC 2D ze zdjęć z wszelkiego rodzaju zniekształceniami, uszkodzeniami i niedoskonałościami. Znacznie przewyższa pod względem funkcjonowania dostępne na rynku biblioteki rozpoznawnia kodów AZTEC 2D takie jak np. ZXing.

Gotowe paczki dla różnych języków programowania

Dla ułatwienia szybkiego wdrożenia, paczki instalacyjne Dekodera AZTec zostały wgrane na repozytoria dla kilku popularnych języków programowania, a dodatkowo ich kody źródłowe zostały opublikowane na GitHubie:

Repozytorium	Język	Instalacja	Paczka	GitHub
	Java	Dodaj wpis do pliku pom.xml <dependency> <groupId>com.pelock</groupId> <artifactId>AZTecDecoder</artifactId> <version>1.0.0</version> </dependency>	Maven	Źródła
	JavaScript, TypeScript	npm install aztec-decoder	NPM	Źródła
	C#, VB.NET, .NET	PM> Install-Package AZTecDecoder	NuGet	Źródła
	PHP	Dodaj do sekcji require w twoim pliku composer.json linijkę "pelock/aztec-decoder": "*"	Packagist	Źródła
	Python	pip install aztecdecoder	PyPi	Źródła

Instalacja

The preferred way to install the Web API SDK is via Go modules.

go get github.com/PELock/Dekoder-AZTEC-2D-Go

The module path is github.com/PELock/Dekoder-AZTEC-2D-Go.

Usage examples

Example — image/main.go

/******************************************************************************
 * Dekoder AZTEC 2D WebApi interface usage example.
 *
 * Version        : v1.1.0
 * Language       : Go
 * Author         : Bartosz Wójcik
 * Web page       : https://www.dekoderaztec.pl | https://www.pelock.com
 *
 *****************************************************************************/

package main

import (
	"context"
	"fmt"
	"os"

	aztecdecoder "github.com/PELock/Dekoder-AZTEC-2D-Go"
)

func main() {
	client := aztecdecoder.New("YOUR-WEB-API-KEY")
	result, err := client.DecodeImageFromFile(context.Background(), "aztec.png")
	if err != nil {
		fmt.Fprintln(os.Stderr, err)
		os.Exit(1)
	}
	fmt.Printf("%v\n", result)
}

Example — simple/main.go

/******************************************************************************
 * Dekoder AZTEC 2D WebApi interface usage example.
 *
 * Version        : v1.1.0
 * Language       : Go
 * Author         : Bartosz Wójcik
 * Web page       : https://www.dekoderaztec.pl | https://www.pelock.com
 *
 *****************************************************************************/

package main

import (
	"context"
	"fmt"
	"os"

	aztecdecoder "github.com/PELock/Dekoder-AZTEC-2D-Go"
)

func main() {
	client := aztecdecoder.New("") // empty key allowed
	result, err := client.DecodeText(context.Background(), "AZTEC-ASCII-PAYLOAD")
	if err != nil {
		fmt.Fprintln(os.Stderr, err)
		os.Exit(1)
	}
	fmt.Printf("%v\n", result)
}

See the examples/ directory in this repository for complete samples.

Bartosz Wójcik https://www.pelock.com | https://www.dekoderaztec.pl

Documentation

Index

• Constants
• type Client
  • func New(apiKey string) *Client
  • func (c *Client) DecodeImageFromFile(ctx context.Context, imageFilePath string) (map[string]any, error)
  • func (c *Client) DecodeText(ctx context.Context, text string) (map[string]any, error)
  • func (c *Client) DecodeTextFromFile(ctx context.Context, textFilePath string) (map[string]any, error)

Constants

const APIURL = "https://www.pelock.com/api/aztec-decoder/v1"

Types

type Client

type Client struct {
	APIKey     string
	APIURL     string
	UserAgent  string
	HTTPClient *http.Client
}

Client is the AZTEC 2D decoder Web API client. An empty key is allowed.

func New

func New(apiKey string) *Client

New creates a client. The activation key may be empty.

func (*Client) DecodeImageFromFile

func (c *Client) DecodeImageFromFile(ctx context.Context, imageFilePath string) (map[string]any, error)

DecodeImageFromFile uploads a PNG/JPG image with an AZTEC 2D code.

func (*Client) DecodeText

func (c *Client) DecodeText(ctx context.Context, text string) (map[string]any, error)

DecodeText decodes an ASCII AZTEC 2D payload.

func (*Client) DecodeTextFromFile

func (c *Client) DecodeTextFromFile(ctx context.Context, textFilePath string) (map[string]any, error)

DecodeTextFromFile reads a text file and decodes it.