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:
|
chld=<error_correction_level>|<margin> |
Opcjonalnie |
|
Przykład:
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.