Kody QR

Możesz na bieżąco utworzyć kod QR za pomocą żądania URL GET.

Opis

Kody QR to popularny typ dwuwymiarowych kodów kreskowych. Są one również nazywane linkami sztywnymi lub hiperlinkami do świata fizycznego. Kody QR mogą zawierać do 4296 znaków alfanumerycznych dowolnego tekstu. Może to być dowolny tekst, na przykład adres URL, informacje kontaktowe, numer telefonu, a nawet wiersz. Kody QR mogą być odczytywane przez urządzenie optyczne z odpowiednim oprogramowaniem. Dotyczy to różnych urządzeń – od dedykowanych czytników kodów QR po telefony komórkowe.

Składnia

Główny URL: https://chart.googleapis.com/chart?

Żądania kodu QR obsługują następujące parametry zapytania URL po znaku ? w głównym adresie URL:

Parametr Wymagany czy opcjonalny Opis
cht=qr Wymagany Określa kod QR.
chs=<width>x<height> Wymagany Rozmiar obrazu.
chl=<data> Wymagany Dane do zakodowania. Dane mogą zawierać cyfry (0–9), znaki alfanumeryczne, bajty binarne lub znaki kanji. Nie można łączyć typów danych w kodzie QR. Dane muszą być zakodowane w formacie UTF-8. Pamiętaj, że adresy URL mają maksymalną długość 2 KB, więc jeśli chcesz zakodować więcej niż 2000 bajtów (z wyłączeniem pozostałych znaków adresu URL), musisz wysyłać dane za pomocą metody POST.
choe=<output_encoding> Opcjonalnie Jak zakodować dane w kodzie QR. Oto dostępne wartości:
  • UTF-8 [wartość domyślna]
  • Shift_JIS
  • ISO-8859-1
chld=<error_correction_level>|<margin> Opcjonalnie
  • error_correction_level – kody QR obsługują 4 poziomy poprawiania błędów, co umożliwia odzyskiwanie brakujących, błędnie odczytanych lub niewidocznych danych. Większa nadmiarowość wiąże się z kosztem możliwości przechowywania mniejszej liczby danych. Szczegółowe informacje znajdziesz w dodatku. Oto obsługiwane wartości:
    • L – [wartość domyślna] umożliwia przywrócenie utraty danych do 7%
    • M – umożliwia przywrócenie utraty danych do 15%
    • Q – umożliwia przywrócenie utraty danych do 25%
    • H – umożliwia przywrócenie utraty danych do 30%
  • margin – szerokość białego obramowania wokół fragmentu kodu. Wartość jest podawana w wierszach, a nie w pikselach. (Patrz poniżej, by dowiedzieć się, co zawiera kod QR). Wartością domyślną jest 4.

 

Przykład:

Kod QR
cht=qr
chl=Hello+world
choe=UTF-8

Szczegóły kodu QR [opcjonalnie czytanie]

Poniżej znajdziesz więcej informacji o działaniu kodów QR. Nie musisz znać tej funkcji, aby móc wygenerować kod QR.

Kody QR są kwadratami z jednakową liczbą wierszy i kolumn. Obowiązuje stały zestaw rozmiarów kodów QR: od 21 do 177 wierszy/kolumn, rosnąco co 4. Każda konfiguracja jest nazywana wersją. Im więcej wierszy/kolumn, tym więcej danych może przechowywać kod. Oto podsumowanie poszczególnych wersji:

  • Wersja 1 ma 21 wierszy i 21 kolumn oraz może zakodować do 25 znaków alfanumerycznych
  • Wersja 2 ma 25 wierszy i 25 kolumn oraz może zakodować do 47 znaków alfanumerycznych
  • Wersja 3 ma 29 wierszy i 29 kolumn oraz może zakodować do 77 znaków alfanumerycznych
  • ...
  • Wersja 40 ma 177 wierszy i 177 kolumn oraz może zakodować do 4296 znaków alfanumerycznych

Nie należy mylić liczby wierszy i kolumn z rozmiarem obrazu kodu QR. Rozmiar kodu w pikselach jest określany jak zwykle za pomocą parametru chs.

Na podstawie ilości przesłanych danych interfejs API określi, której wersji należy użyć.

Odpowiednia wersja kodu QR zostanie zwrócona w zależności od liczby podanych znaków. Jeśli na przykład podasz 55 znaków alfanumerycznych, otrzymasz kod QR w wersji 3. Może się on jednak zmienić, jeśli wyraźnie określisz poziom korekty błędów (EC) za pomocą parametru chld.

Zanim wygenerujesz kod QR, zastanów się, jakiego rodzaju urządzenie zostanie użyte do jego odczytania: najlepsze czytniki kodów QR potrafią odczytywać kody w wersji 40, a urządzenia mobilne mogą odczytywać je tylko do wersji 4.

W tabeli poniżej znajdziesz podsumowanie cech kilku różnych wersji:

Wersja Wiersze x kolumny Poziom EC Maksymalna liczba znaków według poziomu EC i typu znaków
Cyfry: 0–9 Znaki alfanumeryczne:
0–9, A–Z,
spacja, $ % * + - . / 		Binarne kanji
1 21 × 21 L 41 25 17 10
P 34 20 14 8
P 27 16 11 7
H 17 10 7 4
2 25 × 25 L 77 47 32 20
P 63 38 26 16
P 48 29 20 12
H 34 20 14 8
3 29 × 29 L 127 77 53 32
P 101 61 42 26
P 77 47 32 20
H 58 35 24 15
4 33 × 33 L 187 114 78 48
P 149 90 62 38
P 111 67 46 28
H 82 50 34 21
10 57 × 57 L 652 395 271 167
P 513 311 213 131
P 364 221 151 93
H 288 174 119 74
40 177x177 L 7,089 4,296 2,953 1,817
P 5,596 3,391 2,331 1,435
P 3,993 2,420 1,663 1024
H 3057 1,852 1,273 784

Dodatkowe informacje i standardy

Standard kodu QR jest znakiem towarowym firmy Denso Wave, Inc.

ISO sprzedaje w swojej witrynie specyfikację w języku angielskim. Wersja japońska jest bezpłatna.

Standardy dotyczące kodów QR zostały zatwierdzone jako:

  • Standard AIM International (Automatic Identification Manufacturers International) (ISS – QR Code) wprowadzony w październiku 1997 r.
  • Standard JEIDA (Japanese Electronic Industry Development Association) (JEIDA-55) w marcu 1998 r.
  • Standard JIS (Japoński Standard Przemysłowy) (JIS X 0510) w styczniu 1999 r.
  • Międzynarodowa norma ISO (ISO/IEC18004) z czerwca 2000 r.

Oprogramowanie do odczytywania kodów QR jest dostępne w wielu źródłach. Google bezpłatnie udostępnia bibliotekę czytnika kodów QR o nazwie Zebra Crossing (ZXing). Szczegółowe informacje znajdziesz na stronie http://code.google.com/p/zxing/.

Ogólne informacje o standardowym kodowaniu informacji w kodach kreskowych znajdziesz na stronie Zawartość kodu kreskowego.