QR Kodları

URL GET isteği göndererek QR kodunu anında oluşturabilirsiniz.

Genel bakış

QR kodları, popüler bir iki boyutlu barkod türüdür. Sabit bağlantılar veya fiziksel dünya köprüleri olarak da bilinir. QR Kodları rastgele metinlerden en fazla 4.296 alfanümerik karakter depolar. Bu metin herhangi bir şey olabilir, örneğin URL, iletişim bilgileri, telefon numarası, hatta bir şiir! QR kodları, uygun yazılıma sahip optik cihazlar tarafından okunabilir. Bu tür cihazlar özel QR kodu okuyuculardan cep telefonlarına kadar çeşitlilik gösterir.

Söz dizimi

Kök URL: https://chart.googleapis.com/chart?

QR kodu istekleri, ? kök URL'sinde:

Parametre Zorunlu veya İsteğe Bağlı Açıklama
cht=qr Zorunlu QR kodunu belirtir.
chs=<width>x<height> Zorunlu Resim boyutu.
chl=<data> Zorunlu Kodlanacak veriler. Veriler rakam (0-9), alfanümerik karakterler, ikili veri baytları veya Kanji olabilir. QR kodundaki veri türlerini karıştıramazsınız. Veriler UTF-8 URL olarak kodlanmış olmalıdır. URL'lerin maksimum uzunluğu 2K'dir. Bu nedenle, 2.000 bayttan (diğer URL karakterlerini çıkarıp) fazlasını kodlamak isterseniz verilerinizi POST kullanarak göndermeniz gerekir.
choe=<output_encoding> İsteğe bağlı QR kodundaki veriler nasıl kodlanır? Kullanabileceğiniz değerler aşağıda belirtilmiştir:
  • UTF-8 [Varsayılan]
  • Shift_JIS
  • ISO-8859-1
chld=<error_correction_level>|<margin> İsteğe bağlı
  • error_correction_level: QR kodları; eksik, yanlış okunmuş veya belirsiz verilerin kurtarılması için dört düzeyde hata düzeltmesini destekler. Daha az veri depolama maliyetiyle daha fazla yedeklilik sağlanır. Ayrıntılar için ek bölümünü inceleyin. Desteklenen değerler şunlardır:
    • L - [Varsayılan] %7'ye kadar veri kaybının kurtarılmasına izin verir
    • M - %15'e kadar veri kaybının kurtarılmasını sağlar
    • Q - %25'e kadar veri kaybının kurtarılmasını sağlar
    • H - %30'a kadar veri kaybının kurtarılmasını sağlar
  • margin - Kodun veri kısmını çevreleyen beyaz kenarlığın genişliği. Bu değer piksel cinsinden değil, satır içindedir. (QR kodunda hangi satırların olduğunu öğrenmek için aşağıya bakın.) Varsayılan değer 4'tür.

 

Örnek:

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

QR Kodu Ayrıntıları [İsteğe Bağlı Okuma]

QR kodlarının işleyiş şekli hakkında daha fazla bilgiyi aşağıda bulabilirsiniz. QR kodu oluşturabilmek için bunu bilmeniz gerekmez.

QR kodları, eşit sayıda satır ve sütuna sahip karelerdir. Sabit bir QR kodu boyutu grubu vardır: 21 ile 177 satır/sütun x dört adımdan oluşur. Her yapılandırmaya sürüm adı verilir. Ne kadar fazla satır/sütun olursa kod da o kadar çok veri depolayabilir. Sürümlerin özetini aşağıda bulabilirsiniz:

  • Sürüm 1, 21 satır ve 21 sütundan oluşur ve en fazla 25 alfanümerik karakteri kodlayabilir
  • Sürüm 2, 25 satır ve 25 sütun içerir ve 47 alfasayısal karaktere kadar kodlayabilir
  • Sürüm 3, 29 satır ve 29 sütun içerir ve 77 alfasayısal karakteri kodlayabilir
  • ...
  • Sürüm 40, 177 satır ve 177 sütun içerir ve 4.296 alfasayısal karakteri kodlayabilir

Satır ve sütun sayısını QR kodu resminin boyutuyla karıştırmayın. Kodun piksel boyutu, her zamanki gibi chs kullanılarak belirlenir.

API, sağladığınız veri miktarına göre hangi sürümün kullanılacağını belirler.

Girdiğiniz karakter sayısına bağlı olarak uygun QR kodu sürümü döndürülür. Örneğin, 55 alfanümerik karakter sağlarsanız Sürüm 3 QR kodu alırsınız. Ancak chld parametresini kullanarak bir hata düzeltme (EC) düzeyi belirtirseniz bu değer değişebilir.

QR kodunuzu oluşturmadan önce, kodunuzu okumak için ne tür bir cihaz kullanıldığını düşünün: En iyi QR kodu okuyucular Sürüm 40 kodlarını okuyabilirken mobil cihazlar yalnızca Sürüm 4’e kadar okuyabilir.

Aşağıdaki tabloda birkaç farklı sürümün özellikleri özetlenmektedir:

Sürüm Satırlar x Sütunlar EC düzeyi EC düzeyi ve karakter türüne göre maksimum karakter sayısı
Basamaklar: 0 - 9 Alfasayısal:
0 - 9, A-Z,
boşluk, % $ * + - . / :
İkili Kanji Dili
1 21x21 L 41 25 17 10
M 34 20 14 8
SORU 27 16 11 7
VR 17 10 7 4
2 25x25 L 77 47 32 20
M 63 38 26 16
SORU 48 29 20 12
VR 34 20 14 8
3 29x29 L 127 77 53 32
M 101 61 42 26
SORU 77 47 32 20
VR 58 35 24 15
4 33x33 L 187 114 78 48
M 149 90 62 38
SORU 111 67 46 28
VR 82 50 34 21
10 57x57 L 652 395 271 167
M 513 311 213 131
SORU 364 221 151 93
VR 288 174 119 74
40 177x177 L 7,089 4,296 2,953 1,817
M 5,596 3,391 2,331 1,435
SORU 3,993 2,420 1,663 1.024
VR 3.057 1,852 1,273 784

Ek Bilgi ve Standartlar

QR kodu standardının ticari markası Denso Wave, Inc.

ISO, kendi sitesinde İngilizce dil spesifikasyonunun satışını yapmaktadır. Japonca sürümü ücretsizdir.

QR kodu standartları şu şekilde onaylanmıştır:

  • Ekim 1997'de yapılan IAM International (Otomatik Tanımlama Üreticileri Uluslararası) standardı (ISS - QR Kodu).
  • Mart 1998'de JEIDA (Japon Elektronik Endüstrisi Kalkınma Birliği) standardı (JEIDA-55).
  • Ocak 1999'da JIS (Japon Endüstri Standartları) standardı (JIS X 0510).
  • ISO uluslararası standardı (ISO/IEC18004)

QR kodu okuyucu yazılımı pek çok farklı kaynaktan edinilebilir. Google, Zebra Crossing (ZXing) adlı QR Kodu okuyucuyu ücretsiz olarak sunar. Ayrıntılar için bkz. http://code.google.com/p/zxing/.

Barkodlarda bilgilerin standart kodlanmasıyla ilgili kaba bir kılavuz için Barkod İçeriği bölümüne bakın