Generujte a čtěte QR kód Royal Mail pomocí C#

Čárový kód Royal Mail Mailmark 2D je strojově čitelný komplexní čárový kód používaný v dopisech. Poskytuje informace o sledování pošty a stavu doručení. Může také obsahovat další informace, jako je harmonogram dodávek a statistiky hlášení. V tomto článku se naučíme, jak vygenerovat a přečíst 2D čárový kód Royal Mail Mailmark pomocí C#.

V tomto článku se budou zabývat následujícími tématy:

  1. C# API pro generování a čtení QR kódů Royal Mail
  2. Co je to královský čárový kód?
  3. Typy QR kódů Royal Mail
  4. Generate a Royal Mail QR Code
  5. Přečtěte si QR kód Royal Mail
  6. Bezplatné výukové zdroje

C# API pro generování a čtení QR kódu Royal Mail

Pro generování a čtení QR kódu Royal Mail budeme používat Aspose.BarCode for .NET API. Pomocí API můžeme generovat a rozpoznat širokou škálu 1D a 2D typů čárových kódů.

Prosím buď stáhněte si DLL API, nebo jej nainstalujte pomocí NuGet.

PM> Install-Package Aspose.BarCode

Co je královský čárový kód?

Čárový kód Royal Mail je čárový kód Complex Mail Data Mark (CMDM). Byl vyvinut britským poštovním systémem pro automatizaci třídění a sledování pošty. Má specifikovaný formát kódu Data Matrix typu ECC200, který odpovídá mezinárodnímu standardu. Nazývá se také Royal Mail 4-State Customer Code (RM4SCC).

Typy QR kódů Royal Mail

Existují tři typy 2D komplexních čárových kódů poštovních datových značek:

  • Typ 7:
    • Písmena
    • Velikost čárového kódu: 24 × 24 modulů
    • Fyzická velikost: 12 × 12 mm
    • Celkový počet znaků: 51 znaků
    • Zákaznické využití: 6 náhradních míst
Mailmark2DType7
  • Typ 9:
    • Velká písmena, včetně písmen poly wrap
    • Velikost čárového kódu: 32 × 32 modulů
    • Fyzická velikost: 16 × 16 mm
    • Celkový počet znaků: 90 znaků
    • Zákaznické využití: >25, ale maximálně 45 náhradních míst
Mailmark2DType9
  • Typ 29:
    • Velká písmena, včetně písmen polywrap
    • Velikost čárového kódu: 16 × 48 modulů
    • Fyzická velikost: 8 × 24 mm
    • Celkový počet znaků: 70 znaků
    • Celkový počet znaků: Potřebujeme 6–25 zákaznických znaků.
Mailmark2DType29

Vygenerujte razítko čárového kódu Royal Mail v C#

Razítko čárového kódu Royal Mail můžeme vygenerovat podle následujících kroků:

  1. Nejprve vytvořte instanci třídy Mailmark2DCodetext.
  2. Dále nastavte různé vlastnosti, jako je UPUCountryID, VersionID, Class, ItemID atd.
  3. Poté zadejte Mailmark2DType jako Type7, Type9 nebo Type29.
  4. Dále vytvořte instanci třídy ComplexBarcodeGenerator s objektem Mailmark2DCodetext jako argumentem.
  5. Poté nastavte rozměry čárového kódu.
  6. Nakonec zavolejte metodu Save pro uložení obrázku čárového kódu na místní disk.

Následující příklad kódu ukazuje, jak vygenerovat čárový kód Mailmark 2D typu 7 pomocí C#.

// Tento příklad kódu ukazuje, jak vygenerovat 2D čárový kód Mailmark
// Inicializujte 2D kód Mailmark
Mailmark2DCodetext mailmark2D = new Mailmark2DCodetext();
mailmark2D.UPUCountryID = "JGB ";
mailmark2D.InformationTypeID = "0";
mailmark2D.VersionID = "1";
mailmark2D.Class = "1";
mailmark2D.SupplyChainID = 123;
mailmark2D.ItemID = 1234;
mailmark2D.DestinationPostCodeAndDPS = "QWE1";
mailmark2D.RTSFlag = "0";
mailmark2D.ReturnToSenderPostCode = "QWE2";

// Kódovat Mailmark 2D Type 7 Code
mailmark2D.DataMatrixType = Mailmark2DType.Type_7;
mailmark2D.CustomerContent = "CUSTOM";

// Inicializujte generátor čárových kódů
var generator = new ComplexBarcodeGenerator(mailmark2D);
generator.Parameters.Barcode.XDimension.Pixels = 4;

// Uložit
generator.Uložit(@"D:\Files\BarCode\Mailmark2DType7.png");

Přečtěte si QR kód Royal Mail pomocí C#

QR kód Royal Mail můžeme přečíst podle následujících kroků:

  1. Nejprve vytvořte instanci třídy BarCodeReader.
  2. Dále zadejte cestu k obrazu vstupního čárového kódu a DecodeType.
  3. Poté získejte BarCodeResult voláním metody ReadBarCodes().
  4. Poté dekódujte čárový kód pomocí metody TryDecodeMailmark2D().
  5. Nakonec si přečtěte dekódované vlastnosti objektu Mailmark2DCodetext.

Následující příklad kódu ukazuje, jak číst kód QR Mailmark pomocí C#.

// Tento příklad kódu ukazuje, jak číst 2D čárový kód Mailmark
// Rozpoznejte 2D kód Mailmark
BarCodeReader reader = new BarCodeReader(@"D:\Files\BarCode\Mailmark2DType7.png", DecodeType.DataMatrix);
foreach (BarCodeResult result in reader.ReadBarCodes())
{
    // Dekódujte poštovní známku 2D 
    Mailmark2DCodetext mailmarkResult = ComplexCodetextReader.TryDecodeMailmark2D(result.CodeText);
    
    // Přečtěte si vlastnosti
    Console.WriteLine($"UPUCountryID:{mailmarkResult.UPUCountryID}");
    Console.WriteLine($"InformationTypeID:{mailmarkResult.InformationTypeID}");
    Console.WriteLine($"VersionID:{mailmarkResult.VersionID}");
    Console.WriteLine($"Class:{mailmarkResult.Class}");
    Console.WriteLine($"SupplyChainID:{mailmarkResult.SupplyChainID}");
    Console.WriteLine($"ItemID:{mailmarkResult.ItemID}");
    Console.WriteLine($"DestinationPostCodeAndDPS:{mailmarkResult.DestinationPostCodeAndDPS}");
    Console.WriteLine($"RTSFlag:{mailmarkResult.RTSFlag}");
    Console.WriteLine($"ReturnToSenderPostCode:{mailmarkResult.ReturnToSenderPostCode}");
    Console.WriteLine($"CustomerContent:{mailmarkResult.CustomerContent}");
}

UPUCountryID:JGB
InformationTypeID:0
VersionID:1
Class:1
SupplyChainID:123
ItemID:1234
DestinationPostCodeAndDPS:QWE1
RTSFlag:0
ReturnToSenderPostCode:QWE2
CustomerContent:CUSTOM DATA

Získejte bezplatnou licenci

Můžete získat bezplatnou dočasnou licenci a vyzkoušet knihovnu bez omezení hodnocení.

Knihovna 2D čárových kódů společnosti Mailmark – studijní materiály

Kromě generování a čtení QR kódů Royal Mail se můžete dozvědět více o různých dalších funkcích Aspose.BarCode pomocí zdrojů uvedených níže:

Závěr

V tomto článku jsme se naučili vygenerovat QR kód Royal Mail a uložit obrázky čárových kódů na disk. Také jsme viděli, jak programově číst vygenerovaný 2D čárový kód Mailmark. Kromě toho se můžete dozvědět více o Aspose.BarCode for .NET API pomocí dokumentace. V případě jakýchkoli nejasností nás neváhejte kontaktovat na našem bezplatném fóru podpory.

Viz také