PostalAddress

• JSON gösterimi

Posta adresini (ör. posta teslimatı veya ödeme adresleri için) temsil eder. Posta hizmetleri, posta adresi verilen öğeleri bir tesise, posta kutusuna veya benzeri bir yere teslim edebilir. Coğrafi konumları (yollar, kasabalar, dağlar) modellemek için tasarlanmamıştır.

Normal kullanımda, adresler işlem türüne bağlı olarak kullanıcı girişi veya mevcut verilerin içe aktarılmasıyla oluşturulur.

Adres girişi veya düzenlemeyle ilgili öneriler: - https://github.com/google/libaddressinput gibi uluslararasılaştırmaya hazır bir adres widget'ı kullanın. - Kullanıcılara, ilgili alanın kullanıldığı ülkeler 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 https://support.google.com/business/answer/6397478 adresini ziyaret edin.

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 değer, 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. Adresin bulunduğu ülke/bölgenin CLDR bölge kodu. Bu durum hiçbir zaman çıkarılmaz 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/charts/30/supplemental/territory_information.html adreslerine bakın. Örnek: İsviçre için "CH".
languageCode	string İ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 veya bunların transkript eşdeğerleriyle eşleşmesi beklenir. Bu durum, belirli ülkelerdeki biçimlendirmeyi etkileyebilir ancak verilerin doğruluğu açısından kritik değildir ve hiçbir zaman doğrulama işlemlerini veya biçimlendirmeyle ilgili olmayan diğer işlemleri etkilemez. Bu değer bilinmiyorsa yanlış olabilecek bir varsayılan değer belirtmek yerine atlanmalıdır. Örnekler: "zh-Hant", "ja", "ja-Latn", "en".
postalCode	string İsteğe bağlı. Adresin posta kodu. Posta kodları tüm ülkelerde kullanılmaz veya kullanılması zorunlu kılınmaz ancak kullanıldıkları yerlerde adresin diğer bölümleriyle birlikte ek doğrulama (ör. ABD'de eyalet veya posta kodu doğrulaması) tetiklenebilir.
sortingCode	string İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Bu, çoğu bölgede kullanılmaz. Kullanıldığı yerlerde değer, "CEDEX" gibi bir dizedir ve isteğe bağlı olarak bir sayı (ör. "CEDEX 7") ekler veya "sektör kodu"nu (Jamaika), "teslimat bölgesi göstergesini" (Malavi) ya da "posta ofisi göstergesini" (Côte d'Ivoire) temsil eden tek bir sayıdır.
administrativeArea	string İsteğe bağlı. Bir ülke veya bölgenin posta adresleri için kullanılan en yüksek idari alt birim. Örneğin, bu bir eyalet, il, oblast veya idari bölge olabilir. İspanya için bu, özerk topluluk değil ildir (örneğin, "Katalonya" değil "Barselona"). Birçok ülkede posta adreslerinde idari bölge kullanılmaz. Örneğin, İsviçre'de bu alan doldurulmamalıdır.
locality	string İsteğe bağlı. Genellikle adresin şehir veya kasaba kısmını ifade eder. Örnekler: ABD'de şehir, İtalya'da komün, Birleşik Krallık'ta posta bölgesi. Yerelliklerin iyi tanımlanmadığı veya bu yapıya iyi uymadığı dünyanın bölgelerinde locality alanını boş bırakın ve addressLines alanını kullanın.
sublocality	string İsteğe bağlı. Adresin alt mahallesi. Örneğin, bu bir mahalle, semt veya ilçe olabilir.
addressLines[]	string Bir adresin alt düzeylerini açıklayan yapılandırılmamış adres satırları. addressLines içindeki değerler tür bilgisine sahip olmadığı ve bazen tek bir alanda birden çok değer içerebildiğinden (örneğin, "Austin, TX"), satır sırasının net olması önemlidir. Adres satırlarının sırası, adresin bulunduğu ülke veya bölge için "zarf sırası" olmalıdır. Bunun değişebileceği yerlerde (ör. Japonya) bunu açıkça belirtmek için address_language kullanılır (ör. büyükten küçüğe sıralama için "ja" ve küçükten büyüğe sıralama için "ja-Latn" veya "en"). Bu sayede, bir adresin en spesifik satırı dile göre seçilebilir. Bir adresin izin verilen minimum yapısal temsili, regionCode ile diğer tüm bilgilerin addressLines içine yerleştirilmesinden oluşur. Bu tür bir adres, coğrafi kodlama olmadan çok yaklaşık olarak biçimlendirilebilir ancak en azından kısmen çözülene kadar adres bileşenlerinden hiçbiri hakkında anlamsal bir çıkarım yapılamaz. Tamamen yapılandırılmamış adresleri işlemek için önerilen yöntem, yalnızca regionCode ve addressLines içeren bir adres oluşturmak ve ardından coğrafi kodlama yapmaktır (adresin hangi bölümlerinin yerel yönetim bölgeleri veya idari bölgeler olması gerektiğini tahmin etmek yerine).
recipients[]	string İsteğe bağlı. Adresteki alıcı. Bu alan, belirli durumlarda çok satırlık bilgiler içerebilir. Örneğin, "teslim edilecek kişi" bilgilerini içerebilir.
organization	string İsteğe bağlı. Adresteki kuruluşun adı.