Dizin
PostalAddress(message)
PostalAddress
Bir posta adresini temsil eder (ör. posta teslimatı veya ödeme adresleri için). Bir posta adresi belirtildiğinde posta hizmeti, öğeleri posta kutusu veya benzeri bir yere teslim edebilir. Coğrafi konumları (yollar, şehirler, dağlar) modellemek için tasarlanmamıştır.
Tipik kullanımda adres, işlemin türüne bağlı olarak kullanıcı girişi veya mevcut verilerin içe aktarılması yoluyla oluşturulur.
Adres girme / düzenleme ile ilgili öneriler: - https://github.com/google/libaddressinput gibi uluslararası kullanıma hazır bir adres widget'ı kullanın) - Bu alanın kullanıldığı ülkelerin dışındaki alanlarda giriş veya düzenleme işlemleri için kullanıcılara kullanıcı arayüzü öğeleri sunulmamalıdır.
Bu şemanın nasıl kullanılacağı hakkında daha fazla yardım için lütfen bkz. https://support.google.com/business/answer/6397478
| Alanlar | |
|---|---|
revision |
Tüm yeni düzeltmeler eski düzeltmelerle geriye dönük olarak uyumlu olmalıdır. |
region_code |
Zorunlu. Adresin bulunduğu ülkenin/bölgenin CLDR bölge kodu. Bu hiçbir zaman tahmin edilmez ve değerin doğru olduğundan emin olmak kullanıcıya bağlıdır. Ayrıntılı bilgi için https://cldr.unicode.org/ ve https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html sayfalarına göz atın. Örnek: İsviçre için "CH". |
language_code |
İsteğe bağlı. Bu adresin içeriğinin BCP-47 dil kodu (biliniyorsa). Bu, genellikle giriş formunun kullanıcı arayüzü dilidir veya adresin ülkesinde/bölgesinde kullanılan dillerden biriyle ya da harf çevirisiyle eşleştirilmiş dille eşleşmesi beklenir. Bu durum belirli ülkelerde biçimlendirmeyi etkileyebilir. Ancak verilerin doğruluğu açısından kritik öneme sahip değildir ve hiçbir doğrulamayı veya biçimlendirmeyle ilgili olmayan diğer işlemleri etkilemez. Bu değer bilinmiyorsa yanlış olması muhtemel bir varsayılan değeri belirtmek yerine atlanmalıdır. Örnekler: "zh-Hant", "ja", "ja-Latn", "en". |
postal_code |
İsteğe bağlı. Adresin posta kodu. Bazı ülkeler, posta kodlarını kullanmaz veya zorunlu kılmaz ancak posta kodlarının kullanıldığı yerlerde adresin diğer bölümleriyle ek doğrulama işlemini tetikleyebilir (ör. ABD'de eyalet/posta kodu doğrulaması). |
sorting_code |
İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Bu özellik çoğu bölgede kullanılmaz. Kullanıldığı yerlerde bu değer, "CEDEX" gibi bir dize ve isteğe bağlı olarak ardından bir sayı (ör. "CEDEX 7") veya sadece "sektör kodu" (Jamaika), "teslimat alanı göstergesi" (Malavi) veya "postane göstergesi" (ör. Fildişi Sahili) temsil eden bir sayıdır. |
administrative_area |
İsteğe bağlı. Bir ülkenin veya bölgenin posta adresleri için kullanılan en yüksek idari alt bölüm. Örneğin bu bir eyalet, il, oblast veya vilayet olabilir. Daha açık belirtmek gerekirse, İspanya için bu, özerk topluluk değil, ilçedir (ör. "Katalonya" değil, "Barselona"). Birçok ülke, posta adreslerinde idari bölge kullanmaz. Örneğin, İsviçre'de bu alan boş bırakılmalıdır. |
locality |
İsteğe bağlı. Genellikle adresin şehir/ilçe bölümünü ifade eder. Örnekler: ABD şehri, BT topluluğu, Birleşik Krallık posta şehri. Dünyanın iyi tanımlanmadığı veya bu yapıya tam olarak uymadığı bölgelerde yerelliği boş bırakın ve address_lines kullanın. |
sublocality |
İsteğe bağlı. Adresin semti. Örneğin bu mahalleler, ilçeler, semtler olabilir. |
address_lines[] |
Bir adresin daha alt düzeylerini açıklayan yapılandırılmamış adres satırları. address_lines içindeki değerler tür bilgisi içermediğinden ve bazen tek bir alanda birden çok değer (ör. "Austin, TX") içerebileceğinden satır sırasının açık olması önemlidir. Adres satırlarının sırası, adresin ülkesi/bölgesi için "zarf siparişi" olmalıdır. Bunun değişiklik gösterebileceği yerlerde (ör. Japonya), address_language ifadesini açıkça belirtmek için kullanılır (örneğin, büyükten küçüğe sıralama için "ja", küçükten büyüğe sıralama için "ja-Latn" veya "en"). Bu şekilde, adresin en belirgin satırı dile göre seçilebilir. Bir adresin izin verilen minimum yapısal gösterimi, tüm kalan bilgileri address_satırlarına yerleştiren bir bölge_kodundan oluşur. Böyle bir adresi coğrafi kodlama olmadan yaklaşık olarak biçimlendirmek mümkün olsa da, en azından kısmen çözümlenene kadar adres bileşenlerinin hiçbiri hakkında anlamsal akıl yürütme yapılamaz. Yalnızca bölge_kodu ve adres_satırları içeren bir adres oluşturun. Daha sonra coğrafi kodlama, tamamen yapılandırılmamış adreslerin işlenmesi için önerilen yöntemdir (adresin hangi bölümlerinin şehir yerleri veya idari alanlar olması gerektiğini tahmin etmek yerine). |
recipients[] |
İsteğe bağlı. Adresteki alıcı. Bu alan, belirli koşullar altında çok satırlı bilgiler içerebilir. Örneğin, "bakımı" bilgileri içerebilir. |
organization |
İsteğe bağlı. Adresteki kuruluşun adı. |