QR Kodları

URL GET isteğiyle anında QR kodu 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 bilinirler. QR Kodları rastgele metinleri 4.296 alfanümerik karaktere kadar depolar. Bu metin herhangi bir şey olabilir. URL, iletişim bilgileri, telefon numarası, hatta şiir gibi. QR kodları, uygun yazılımla 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, ? işaretinden sonra gelen aşağıdaki URL sorgu parametrelerini destekler kök URL'de:

Parametre Zorunlu veya isteğ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 karakter, ikili bayt veri veya Kanji olabilir. QR kodu içinde veri türlerini karıştıramazsınız. Veriler UTF-8 URL kodlamalı olmalıdır. URL'lerin maksimum 2.000 uzunluğunda olduğunu unutmayın. Bu nedenle, 2.000 bayttan (diğer URL karakterleri çıkarılarak) daha fazla kodlamak istiyorsanız verilerinizi POST kullanarak göndermeniz gerekir.
choe=<output_encoding> İsteğe bağlı QR kodundaki veriler nasıl kodlanır? Kullanabileceğiniz değerler şunlardır:
  • 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ış okunan veya gizlenmiş verilerin kurtarılmasını sağlamak için dört düzeyde hata düzeltmeyi destekler. Daha az veri depolayabilme maliyeti karşılığında daha fazla yedeklilik sağlanır. Ayrıntılar için ek bölümüne bakın. Desteklenen değerler:
    • L - [Varsayılan] %7'ye kadar veri kaybının kurtarılmasına olanak tanır
    • 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
  • kenar boşluğu - Kodun veri kısmının çevresindeki beyaz kenarlığın genişliğidir. Bu değer piksel cinsinden değil, satır cinsindendir. (QR kodunda hangi satırların olduğunu öğrenmek için aşağıdaki bilgilere 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]

Aşağıda QR kodlarının işleyiş şekliyle ilgili daha fazla bilgi bulabilirsiniz. QR kodu oluşturmak için bunu bilmeniz gerekmez.

QR kodları, eşit sayıda satır ve sütuna sahip karelerdir. QR kodu boyutları sabittir: 21'den 177'ye kadar satır/sütun sayısı. Bu boyutlar dört adımla artar. Her yapılandırmaya bir sürüm adı verilir. Kod, ne kadar çok satır/sütun olursa kod o kadar fazla veri depolayabilir. Aşağıda sürümlerin özeti verilmiştir:

  • Sürüm 1'de 21 satır ve 21 sütun bulunur ve 25 alfanümerik karaktere kadar kodlanabilir.
  • Sürüm 2'de 25 satır ve 25 sütun bulunur ve 47 alfanümerik karaktere kadar kodlanabilir.
  • Sürüm 3'te 29 satır ve 29 sütun bulunur ve 77 alfanümerik karaktere kadar kodlanabilir.
  • ...
  • Sürüm 40'ta 177 satır ve 177 sütun bulunur ve sürüm 4.296'ya kadar alfanümerik karakter 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 bağlı olarak hangi sürümün kullanılacağını belirler.

Sağladığınız 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 açıkça 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ı okuyabilir; mobil cihazlar ise yalnızca Sürüm 4'e kadar okuyabilir.

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

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ı
Rakamlar: 0 - 9 Alfasayısal:
0 ile 9 arası, 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

Daha Fazla Bilgi ve Standartlar

QR kodu standardı Denso Wave, Inc. tarafından ticari markaya sahiptir.

ISO, İngilizce dil spesifikasyonunu kendi sitesinde satar. Japonca sürüm ücretsizdir.

QR kodu standartları şu şekilde onaylanır:

  • Ekim 1997'de yürürlüğe giren Uluslararası Otomatik Tanımlama Üreticileri (ISS - QR Kodu) standardı.
  • Mart 1998'de JEIDA (Japon Elektronik Endüstri Geliştirme Birliği) standardı (JEIDA-55) olmuştur.
  • Ocak 1999'da JIS (Japon Endüstri Standartları) standardı (JIS X 0510).
  • Haziran 2000 tarihli ISO uluslararası standardı (ISO/IEC18004).

QR kodu okuyucu yazılımı birçok kaynaktan mevcuttur. Google, Zebra Crossing (ZXing) adlı QR kodu okuyucu kitaplığını ücretsiz olarak sunar. Ayrıntılar için http://code.google.com/p/zxing/ adresine bakın.

Barkodlarda standart kodlamaya ilişkin kaba bir rehber için Barkod İçerikleri bölümüne bakın