Bir posta adresini temsil eder (ör. posta teslimatı veya ödeme adresleri için). Posta adresi göz önüne alındığında, posta hizmetleri öğeleri tesise, posta kutusuna veya benzer bir adrese teslim edebilir. Coğrafi konumları (yollar, kasabalar, dağlar) modellemek için tasarlanmamıştır.
Tipik kullanımda, işlemin türüne bağlı olarak kullanıcı girişi aracılığıyla veya mevcut verileri içe aktararak bir adres oluşturulur.
Adres girişi / düzenleme hakkında tavsiye: - https://github.com/google/libaddressinput gibi i18n uyumlu bir adres widget'ı kullanın.) - Bu alanın kullanıldığı ülkelerin dışındaki alanlara giriş veya düzenleme yapmak için kullanıcılara kullanıcı arayüzü öğeleri sunulmamalıdır.
Bu şemanın kullanımıyla ilgili daha fazla bilgi için lütfen şu sayfayı inceleyin: 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 uyumlu olmalıdır. |
regionCode |
Zorunlu. Adresteki ülkenin/bölgenin CLDR bölge kodu. Çı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 bkz. http://cldr.unicode.org/ ve http://www.unicode.org/cldr/schemas/30/supplemental/region_information.html. Örnek: İsviçre için "CH" |
languageCode |
İsteğe bağlı. Bu adresin içeriğinin BCP-47 dil kodu (biliniyorsa). Bu, genellikle giriş formunun kullanıcı arayüzü dilidir veya adres ve ülke/bölgede kullanılan dillerden birinde ya da harf çevirilerinde karşılık gelen dillerden biriyle 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 zaman doğrulamayı veya biçimlendirmeyle ilgili olmayan diğer işlemleri etkilemez. Bu değer bilinmiyorsa atlanmalıdır (yanlış olabilecek bir varsayılan değer belirtmek yerine). Örnekler: "zh-Hant" |
postalCode |
İsteğe bağlı. Adresin posta kodu. Tüm ülkeler posta kodlarının kullanılmasını zorunlu kılmaz veya gerektirmez, ancak kullanıldıklarında adresin diğer bölümleriyle ek doğrulama işlemini tetikleyebilirler (ör. ABD'de eyalet/posta doğrulaması). |
sortingCode |
İsteğe bağlı. Ülkeye özgü ilave sıralama kodu. Çoğu bölgede kullanılmaz. Değer kullanıldığında, değer "CEDEX" gibi bir dizedir, isteğe bağlı olarak bir sayı (ör. "CEDEX 7") veya sadece bir sayıdır, &sektör kodu kodu, "teslimat alanı göstergesi""post. göstergesi |
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 vilayet olabilir. Özellikle, İspanya'da bu şehir özerk topluluk değildir (ör. "Katalona" değil, Barselona belediyesi). Birçok ülkede posta adreslerinde bağlı olduğu yer kullanılmaz. Örneğin, İsviçre'de bu alan doldurulmadan bırakılmalıdır. |
locality |
İsteğe bağlı. Genellikle adresin şehir/bölge kısmını belirtir. Örnekler: ABD şehri, BT topluluğu, Birleşik Krallık posta şehri. Şehirlerin iyi tanımlanmadığı veya bu yapıya uygun olmadığı bölgelerinde mahalleyi boş bırakın ve addressLine'ları kullanın. |
sublocality |
İsteğe bağlı. Adresin semti. Örneğin mahalleler, ilçeler, ilçeler olabilir. |
addressLines[] |
Bir adresin daha düşük düzeylerini açıklayan yapılandırılmamış adres satırları. addressLines alanındaki değerlerin tür bilgisi olmadığından ve bazen tek bir alanda birden çok değer (ör. &Atin, TX") içerebileceği için satır sırasının net olması önemlidir. Adres satırlarının sırası, adresin ülkesi/bölgesi için "zarf sırası" olmalıdır. Bunun değişebileceği yerlerde (ör. Japonya), bunu açık bir şekilde belirtmek için address_language kullanılır (ör. büyükten küçüğe sıralama ve "ja-Latn" Böylece, dile özgü bir adres satırının en spesifik satırı seçilebilir. Bir adresin izin verilen minimum yapısal gösterimi, adres satırlarında kalan tüm bilgilerin yer aldığı bir bölge kodundan oluşur. Bu tür bir adresi neredeyse coğrafi kodlama olmadan biçimlendirmek mümkün olsa da, en azından kısmen çözülene kadar adres bileşenlerinin herhangi biri hakkında anlamsal bir gerekçe oluşturulamaz. Yalnızca regionCode ve addressLines içeren bir adres oluşturmak. Tamamen yapılandırılmamış adresleri yönetmek için bu yöntem coğrafi kodlama olarak kullanılır (adresin hangi bölümlerinin şehirler veya idari bölgeler 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, "ihtiyaç" bilgileri içerebilir. |
organization |
İsteğe bağlı. Adresteki kuruluşun adı. |