PDF417
PDF417 je vrstvený 2D čárový kód na zadní straně každého amerického řidičského průkazu, většiny amerických pasů, nákladních listů FedEx/UPS a nespočetných vládních formulářů. Je to jediná 2D symbolika spolehlivě čitelná 1D laserovými skenery, proto instituce s milionovými flotami skenerů od ní za 30 let neupustily.
Aplikace AAMVA:AAMVA Card Design Standard v10, nařizuje PDF417 pro americké/kanadské řidičské průkazy.
Původce: Symbol Technologies (nyní Zebra), 1991. Název znamená „Portable Data File, 4 bars, 17 modules."
Co to je
Fyzicky je symbol PDF417 zásobník vodorovných řádků, každý řádek je lineární čárový kód. Celý PDF417 vypadá jako vysoká úzká cihla s ~3–90 řádky, přičemž každý nese část celkového payload. Protože každý řádek začíná startovním vzorem a končí stopovacím vzorem, může PDF417 dekódovat laserový skener pohybující se zleva doprava řádek po řádku, žádný 2D imager není potřeba.
Každé kódové slovo je 17 modulů široké, složeno ze 4 pruhů a 4 mezer (odtud „4/17"). Payload se rozděluje přes kódová slova pomocí jednoho ze tří „kompresních režimů":
- Textová komprese, 1,8 znaku/kódové slovo. Používá se pro smíšené alfanumerické znaky.
- Bajtová komprese, 1,2 bajtu/kódové slovo. Používá se pro libovolná binární data.
- Číselná komprese, 2,9 číslic/kódové slovo. Používá se pro dlouhé číselné payloady (jako kombinace PSČ+stát v AAMVA).
Kapacita (řádky × sloupce)
Velikost PDF417 se udává jako řádky × datové sloupce. Maximum je 90 řádků × 30 datových sloupců = 2 700 datových kódových slov. Přibližná alfanumerická kapacita:
| Řádky × datové sloupce | Max. alfanumericky | Typické použití |
|---|---|---|
| 3 × 1 | ~3 znaky | Minimálně životaschopný symbol |
| 10 × 3 | ~30 znaků | Krátká ID, krátké URL |
| 20 × 5 | ~100 znaků | Palubní vstupenka, krátká AAMVA |
| 30 × 8 | ~250 znaků | Nákladní list FedEx |
| 40 × 12 | ~500 znaků | Plný řidičský průkaz AAMVA |
| 90 × 30 | ~1 800 znaků | Teoretické maximum, vzácně používané |
Úrovně opravy chyb (0–8)
PDF417 definuje 9 úrovní Reed-Solomonovy opravy chyb, přidávající 2, 4, 8, 16, 32, 64, 128, 256 nebo 512 kódových slov ECC. Vyšší úrovně zvládají větší poškození, ale za cenu kapacity payloadu.
| Úroveň ECC | Kódová slova ECC | Typické použití | % režie |
|---|---|---|---|
| 0 | 2 | Pouze experimentální | ~0,1 % |
| 1 | 4 | Krátké kódy, řízené prostředí | ~0,2 % |
| 2 | 8 | Malé payloady | ~0,4 % |
| 3 | 16 | Střední payloady, skenování uvnitř | ~0,8 % |
| 4 | 32 | Výchozí pro krátké dokumenty | ~1,5 % |
| 5 | 64 | Výchozí v reálném světě, nákladní listy, palubní vstupenky, AAMVA | ~3 % |
| 6 | 128 | Vysoce poškozené prostředí | ~6 % |
| 7 | 256 | Zmačkané / venkovní / průmyslové | ~12 % |
| 8 | 512 | Extrémní prostředí | ~25 % |
Macro PDF417 (víceznakové payloady)
Pokud payload překročí limit 1 800 znaků, PDF417 podporuje Macro PDF417, payload se rozdělí přes až 99 999 samostatných symbolů, každý označen indexem Macro a ID souboru. Skener čte všechny symboly v libovolném pořadí, znovu je sestaví a vydá jeden dekódovaný payload. V praxi vzácné mimo specializované skenování dokumentů.
Kanonické testovací vektory
| Případ | Payload | Očekávaný podřetězec |
|---|---|---|
| GS1 nákladní list (FedEx styl) | 123456789012345 FEDEX 2026-04-20 | FEDEX |
| Řidičský průkaz AAMVA (minimální) | @\n\x1e\rANSI 636014100002DL00410241ZVZVA01DAQA123456789 | ANSI 636014 |
| Krátká běžná URL | https://example.com/doc/X1234 | example.com/doc/X1234 |
| Dlouhý účet / faktura | INV:2026-04-19 VENDOR:ACME TOTAL:$1,234.56 TAX:$98.76 … | ACME |
Typické chyby
- Spotřebitelské telefony nedekódují PDF417 spolehlivě. iOS 17+ má speciální AAMVA-vědomý tok (Wallet rozpoznává americké řidičské průkazy), ale považovat to za „iPhone podporuje PDF417" je zavádějící, platí jen pro konkrétní payload AAMVA. Chování Androidu se velmi liší podle OEM aplikace fotoaparátu.
- AAMVA nařizuje PDF417. AAMVA Card Design Standard (CDS) vyžaduje konkrétně PDF417, ne QR, ne Aztec. Pokud generujete payloady AAMVA, standard vás v tom uzamkne.
- Klidové zóny jsou 2× šířka modulu. Jinak než u QR (4 moduly) a Aztec (žádné). PDF417 potřebuje alespoň 2 moduly bílého prostoru na levém a pravém okraji; špatná klidová zóna je důvod č. 1, proč legitimní kódy PDF417 selhávají při skenování.
- Poměr stran záleží. Řádky PDF417 jsou z principu širší než vysoké. Vynucení čtvercového poměru stran (škálováním nebo tiskem na čtvercový podklad) narušuje dekódování laserovým skenerem; 2D imagerům se to někdy podaří obnovit.
- Zkrácený PDF417. Varianta, která vynechává pravý indikátor řádku + stopovací vzor. Ušetří ~12 % šířky symbolu, ale dekóduje jen na 2D imagerech, laserové skenery potřebují stopovací vzor. Používejte jen tehdy, kdy znáte třídu skeneru.
- Automatická volba kompresního režimu. Dobré enkodéry přepínají kompresi uprostřed payloadu pro efektivitu (číselný blok → textový blok). Manuální enkodéry uzamčené na jediný režim plýtvají kapacitou. Enkodér Abundera vybírá automaticky pro každé kódové slovo.
- Kompresní režim a sada znaků. Textová komprese zvládá pouze tisknutelné ASCII. Vložené NUL, akcenty Latin-1 nebo binární data vynucují Bajtovou kompresi, která snižuje efektivitu na 1,2 bajtu/kódové slovo.
- Stylování zakázáno. Funkce specifické pro QR (vlastní tvary teček, přechody, centrální loga) se nevztahují. Panel stylu Abundera se pro PDF417 sám deaktivuje.
Kompatibilita skenerů
| Čtečka | Podpora PDF417 | Poznámky |
|---|---|---|
| iOS fotoaparát (iOS 17+) | Pouze AAMVA | Nativní tok Wallet pro americké řidičské průkazy. Obecné payloady PDF417 se nedekódují. |
| Android fotoaparát (závislý na OEM) | Částečný | Standardní fotoaparáty Samsung + Pixel dekódují nekonzistentně. Google Lens částečně. |
| Google Lens | Nespolehlivý | Není schůdná cesta ověření pro produkci. |
| Skener US DMV / kiosek | Ano (kanonické) | K tomu byl PDF417 navržen, každý DMV a kiosek s alkoholem čte PDF417 nativně. |
| Čtečka palubní vstupenky | Někteří dopravci | Většina přešla na Aztec; někteří (ANA, JAL, starší US dopravci) stále přijímají PDF417 palubní vstupenky. |
| Čtečka nákladního listu FedEx / UPS | Ano (kanonické) | Laserové skenery v každém třídícím zařízení čtou PDF417 nativně. |
| 1D laserový skener | Ano | Unikátní výhoda oproti Aztec / Data Matrix, 1D lasery MOHOU dekódovat PDF417. |
| Imager Zebra / Honeywell / Datalogic | Ano | Každý průmyslový 2D imager podporuje PDF417. |
| Scandit / Dynamsoft SDK | Ano | Plná podpora včetně Macro PDF417. |
Viz také
- /pdf417-barcode-generator/, generátor PDF417.
- Reference AAMVA, kanonický případ použití PDF417 (americké řidičské průkazy). Nařízeno specifikací.
- Srovnání Aztec · PDF417 · Data Matrix, srovnání vedle sebe.
- Reference Aztec, sourozenec zaměřený na displej, pro palubní vstupenky a transit.
- Reference Data Matrix, sourozenec pro přímé značení dílů.
- Index standardů, zpět do referenčního centra.