Bir posta adresini temsil eder (ör. posta teslimatı veya ödeme adresleri için). Posta adresi göz önüne alındığında bir posta hizmeti öğeleri bir tesise, posta kutusuna veya benzer bir yere teslim edebilir. Coğrafi konumları (yollar, kasabalar, dağlar) modellemek için tasarlanmamıştır.
Genelde adres, işlemin türüne bağlı olarak kullanıcı girişi yoluyla veya mevcut verileri içe aktararak oluşturulur.
Adres girişi/düzenlemesi hakkında tavsiye: - https://github.com/google/libaddressinput gibi uluslararasılaştırmaya hazır bir adres widget'ı kullanın) - Kullanıcılara, bu alanın kullanıldığı ülkelerin dışındaki alanların girişi veya düzenlenmesi için kullanıcı arayüzü öğeleri sunulmamalıdır.
Bu şemanın nasıl kullanılacağıyla ilgili daha fazla bilgi için lütfen şu adresi ziyaret edin: https://support.google.com/business/answer/6397478
| JSON gösterimi |
|---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
| Alanlar | |
|---|---|
revision |
Tüm yeni düzeltmeler, eski düzeltmelerle geriye dönük uyumlu olmalıdır. |
regionCode |
Zorunlu. Adresteki ülkenin/bölgenin CLDR bölge kodu. Bu çıkarım hiçbir zaman tahmin edilmez ve değerin doğru olduğundan emin olmak kullanıcıya bağlıdır. Ayrıntılar için https://cldr.unicode.org/ ve https://www.unicode.org/cldr/graphics/30/supplemental/region_information.html sayfalarına bakın. Örnek: İsviçre için "CH". |
languageCode |
İsteğe bağlı. Bu adrese ait içeriklerin 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 çevirisindeki eşdeğerleriyle eşleşmesi beklenir. Bu durum, bazı ülkelerdeki biçimlendirmeyi etkileyebilir ancak verilerin doğruluğu açısından kritik öneme sahip değildir ve biçimlendirmeyi veya biçimlendirmeyle ilgili olmayan diğer işlemleri hiçbir zaman etkilemez. Bu değer bilinmiyorsa unutulmalıdır (yanlış olabilecek bir varsayılan belirtmek yerine). Örnekler: "zh-Hant", "ja", "ja-Latn", "en". |
postalCode |
İsteğe bağlı. Adresin posta kodu. Tüm ülkeler posta kodlarının var olmasını zorunlu tutmaz. Ancak bu kodların kullanıldığı yerlerde adresin diğer bölümleriyle birlikte ek doğrulamalar (ör. ABD'de eyalet/posta doğrulaması) tetikleyebilir. |
sortingCode |
İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Çoğu bölgede kullanılmaz. Değer kullanıldığında değer, "CEDEX" gibi bir dize, bunu takip eden bir sayı (ör. "CEDEX 7") veya yalnızca bir sayıdır ve "sektör kodu" (Jamaika), "teslimat bölgesi göstergesi" (Malawi) veya "postane göstergesi"ni (ör. Fildişi Sahili) temsil eder. |
administrativeArea |
İ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 il olabilir. Özellikle İspanya için bu özerk topluluk değildir (örneğin, "Katalona değil", "Barselona"). Birçok ülke, posta adreslerinde bağlı olduğu bir idari bölge kullanmaz. Örneğin, İsviçre'de bu alan boş bırakılmamalıdır. |
locality |
İsteğe bağlı. Genellikle adresin şehir/şehir bölümünü belirtir. Örnekler: ABD şehri, BT komitesi, Birleşik Krallık posta şehri. Şehirlerin iyi tanımlanmadığı veya bu yapıya iyi sığmadığı bölgelerde, semti boş bırakın ve addressLines kullanın. |
sublocality |
İsteğe bağlı. Adresin alt semti. Örneğin bu; mahalleler, ilçeler, mahalleler olabilir. |
addressLines[] |
Bir adresin alt düzeylerini açıklayan yapılandırılmamış adres satırları. addressLines alanındaki değerler tür bilgisi içermediğinden ve bazen tek bir alanda birden fazla 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. Bu özelliğin değişebileceği yerlerde (ör. Japonya), adresi göstermek için address_language [ör. büyük veya küçük siparişlerde "ja", küçükten büyüğe "ja-Latn" veya "en") kullanılır. Bu şekilde, adrese göre en spesifik satır dili dile göre seçilebilir. Bir adresin izin verilen minimum yapısal gösterimi, adres satırlarında kalan tüm bilgilerin bulunduğu bir regionCode'dan 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ülmeden adres bileşenlerinin hiçbiriyle ilgili anlamsal gerekçeler sağlanamaz. Yalnızca regionCode ve addressLines içeren bir adres oluşturmak, ardından yapılandırılmamış adreslerin işlenmesi için önerilen adres coğrafi kodlamadır (adresin hangi bölümlerinin semt veya bağlı bölge olması gerektiğini tahmin etmek yerine). |
recipients[] |
İsteğe bağlı. Adresteki alıcı. Bu alan, belirli durumlarda çok satırlı bilgiler içerebilir. Örneğin, video "sağlık" bilgileri içerebilir. |
organization |
İsteğe bağlı. Adresteki kuruluşun adı. |