PostalAddress

Bir posta adresini temsil eder (ör. posta teslimatı veya ödeme adresleri için). Bir posta adresi göz önüne alındığında, bir posta hizmeti öğeleri tesise, posta kutusuna veya benzeri bir yere teslim edebilir. Coğrafi konumları (yollar, kasabalar, dağlar) modellemeyi amaçlamamaktadır.

Tipik kullanım sırasında, işlemin türüne bağlı olarak kullanıcı girişi yoluyla veya mevcut verilerin içe aktarılması yoluyla bir adres oluşturulur.

Adres girişi / düzenleme hakkında öneriler: - https://github.com/google/libaddressinput gibi i18n uyumlu bir adres widget'ı kullanın.) - İlgili alanın kullanıldığı ülkelerin dışındaki alanlara giriş yapmak veya alanları düzenlemek için kullanıcılara kullanıcı arayüzü öğeleri sunulmamalıdır.

Bu şemanın nasıl kullanılacağı ile ilgili daha fazla bilgi için lütfen şu sayfayı 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

integer

PostalAddress öğesinin şema düzeltmesi. Bu, en son düzeltme olan 0 olarak ayarlanmalıdır.

Tüm yeni düzeltmeler eski düzeltmelerle geriye dönük uyumlu olmalıdır.

regionCode

string

Zorunlu. Adresteki ülkenin/bölgenin CLDR bölge kodu. Tahminde bulunulamaz. Değerin doğru olduğundan emin olmak kullanıcıya bağlıdır. Ayrıntılar için http://cldr.unicode.org/ ve http://www.unicode.org/cldr/Charts/30/additional/region_information.html sayfasına bakın. Örnek: İsviçre için "CH".

languageCode

string

İ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 bunların harf çevirisi yapılan eşdeğerleriyle 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 biçimlendirmeyi veya biçimlendirmeyle ilgili olmayan diğer işlemleri hiçbir zaman etkilemez.

Bu değer bilinmiyorsa atlanmalıdır (yanlış olabilecek bir varsayılan belirtmek yerine).

Örnekler: "zh-Hant", "ja", "ja-Latn", "en".

postalCode

string

İsteğe bağlı. Adresin posta kodu. Tüm ülkeler, posta kodlarının kullanılmasını zorunlu tutmaz. Ancak bu kodların kullanıldığı yerlerde adresin diğer bölümleriyle de ek doğrulama sürecini (ör. ABD'de eyalet/posta doğrulamasını) tetikleyebilir.

sortingCode

string

İ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 ve isteğe bağlı olarak bir sayı (ör. "CEDEX 7") ya da yalnızca "sekiz kodu" (Jamaika), "teslimat bölgesi göstergesi" (Malawi) veya "postane göstergesi" (ör. Fildişi Sahili) anlamına gelen bir sayıdır.

administrativeArea

string

İ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 özerk topluluk değildir (ör. "Katalona" değil, "Barselona"). Birçok ülke, posta adreslerinde bağlı olduğu bir idari bölgeyi kullanmaz. Örneğin, İsviçre'de bu alan doldurulmadan bırakılmalıdır.

locality

string

İsteğe bağlı. Genellikle adresin şehir/ilçe kısmını ifade eder. Örnekler: ABD şehri, BT topluluğu, Birleşik Krallık'ın posta şehri. Şehirlerin iyi tanımlanmadığı veya bu yapıya uygun olmadığı tüm bölgelerde bölgelerde boş bırakın ve adres satırları kullanın.

sublocality

string

İsteğe bağlı. Adresin alt konumu. Örneğin bu; mahalleler, ilçeler, ilçeler olabilir.

addressLines[]

string

Bir adresin daha düşük seviyelerini açıklayan yapılandırılmamış adres satırları.

addressLines bölümündeki değerlerin tür bilgisi olmadığından ve bazen tek bir alanda birden fazla değer (ör. "Austin, TX") içerebileceğinden, 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. Farklılık gösterebileceği yerlerde (ör. Japonya) açık olması için address_language kullanılır (ör. küçükten büyük siparişlere yönelik "ja", küçükten büyüğe "ja-Latn" veya "en"). Böylece dile göre bir adresin en spesifik satırı seçilebilir.

Bir adresin izin verilen minimum yapısal gösterimi, adres satırlarına kalan tüm bilgilerin yerleştirildiği bir bölge kodundan oluşur. Bu tür bir adresi coğrafi kodlama olmadan yaklaşık olarak biçimlendirmek mümkün olabilir ancak adres bileşenlerinden herhangi biri hakkında en azından kısmen çözümlenene kadar anlamsal bir mantık yürütülemez.

Yalnızca bir bölge kodu ve adres satırları içeren bir adres oluşturmak ve ardından coğrafi kodlama, adresin hangi bölümlerinin şehir konumları veya idari bölgeler olması gerektiğini tahmin etmek yerine tamamen yapılandırılmamış adreslerin işlenmesi için önerilen yöntemdir.

recipients[]

string

İsteğe bağlı. Adresteki alıcı. Bu alan bazı durumlarda çok satırlı bilgiler içerebilir. Örneğin, "sağlık" bilgileri içerebilir.

organization

string

İsteğe bağlı. Adresteki kuruluşun adı.