PostalAddress

Posta teslimatı veya ödeme adresleri gibi posta adreslerini temsil eder. Posta hizmetleri, posta adreslerini kullanarak bir tesise, posta kutusuna veya benzer bir yere öğe teslim edebilir. Posta adresi; yollar, kasabalar veya dağlar gibi coğrafi konumları modellemek için tasarlanmamıştır.

Normal kullanımda, işlemin türüne bağlı olarak kullanıcı girişiyle veya mevcut veriler içe aktarılarak bir adres oluşturulur.

Adres girişi veya düzenlemeyle ilgili öneriler:

  • https://github.com/google/libaddressinput gibi uluslararası kullanıma hazır bir adres widget'ı kullanın.
  • Kullanıcılara, alanların kullanıldığı ülkeler dışında alan girişi veya düzenleme için kullanıcı arayüzü öğeleri gösterilmemelidir.

Bu şemanın nasıl kullanılacağı hakkında 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 ülkenin/bölgenin CLDR bölge kodu. Bu değer hiçbir zaman tahmin edilmez ve değerin doğru olduğundan emin olmak kullanıcının sorumluluğundadır. Ayrıntılar için https://cldr.unicode.org/ ve https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html adreslerini ziyaret edin. Ö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 ya da bunların harf çevirisi yapılmış 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 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. Tüm ülkelerde posta kodu kullanılmaz veya zorunlu değildir. Ancak kullanıldığı yerlerde, adresin diğer bölümleriyle (ör. ABD'de eyalet veya posta kodu doğrulaması) ek doğrulama tetiklenebilir.
sortingCode

string

İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Bu seçenek çoğu bölgede kullanılmaz. Kullanıldığı yerlerde değer, "CEDEX" gibi bir dize ve isteğe bağlı olarak bir sayı (örneğin, "CEDEX 7") veya "sektör kodu" (Jamaika), "teslimat bölgesi göstergesi" (Malavi) ya da "postane göstergesi"ni (Fildişi Sahili) 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 bölüm. Örneğin, bu bir eyalet, il, bölge 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 bağlı olduğu yer kullanılmaz. Örneğin, İsviçre'de bu alan boş bırakılmalıdır.
locality

string

İsteğe bağlı. Genellikle adresin şehir veya kasaba kısmını ifade eder. Örnekler: ABD'de şehir, İtalya'da belediye, Birleşik Krallık'ta posta şehri. Bölgelerin iyi tanımlanmadığı veya bu yapıya uymadığı yerlerde locality alanını boş bırakın ve addressLines alanını kullanın.
sublocality

string

İsteğe bağlı. Adresin alt yerleşim yeri. Ö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ğerlerde tür bilgisi bulunmadığından ve bazen tek bir alanda birden fazla değer (ör. "Austin, TX") olabileceğinden 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. Bu durumun değişiklik gösterebileceği yerlerde (ör. Japonya) address_language, durumu netleştirmek için kullanılır (ör. 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, dile göre bir adresin en spesifik satırı seçilebilir.

Bir adresin izin verilen minimum yapısal gösterimi, kalan tüm bilgilerin addressLines alanına yerleştirildiği bir regionCode alanından oluşur. Böyle bir adres, coğrafi kodlama olmadan yaklaşık olarak biçimlendirilebilir ancak en azından kısmen çözümlenene kadar adres bileşenlerinden herhangi biri hakkında anlamsal bir çıkarım yapılamaz.

Yalnızca regionCode ve addressLines içeren bir adres oluşturup ardından coğrafi kodlama yapmak, tamamen yapılandırılmamış adresleri işlemenin önerilen yoludur (adresin hangi bölümlerinin şehir veya bağlı olduğu yer olması gerektiğini tahmin etmek yerine).
recipients[]

string

İsteğe bağlı. Adresteki alıcı. Bu alan, belirli koşullar altında çok satırlı bilgiler içerebilir. Örneğin, "aracılığıyla" bilgisi içerebilir.
organization

string

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