Posta adresi (ör. posta teslimatı veya ödeme adresleri) temsil eder. Posta adresi sayesinde, posta hizmetleri bir binaya ürün teslim edebilir. Kutu veya benzeri. Coğrafi konumları (yollar, kasabalar, dağlar) modellemesi amaçlanmamış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/düzenlemeyle ilgili öneriler: - https://github.com/google/libaddressinput gibi i18n 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 yardım için lütfen bkz: 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. Adresin bulunduğu ülkenin/bölgenin CLDR bölge kodu. Bu durum hiçbir zaman tahmin edilmez ve değerin doğru olup olmadığını kontrol etmek kullanıcıya bağlıdır. Ayrıntılar için http://cldr.unicode.org/ ve http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html adresine bakın. Ö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 adreste kullanılan dillerden biriyle eşleşmesi beklenir ülke/bölge ya da harf çevirisi yapılmış eşdeğerleri. Bu, 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 yanlış olabilecek bir varsayılan belirtmek yerine belirtilmemelidir. Örnekler: "zh-Hant", "ja", "ja-Latn", "en". |
postalCode |
İsteğe bağlı. Adresin posta kodu. Posta kodları her ülkede kullanılmaz veya zorunlu tutulmaz ancak kullanıldıkları yerlerde adresin diğer bölümleriyle birlikte ek doğrulama (ör. ABD'de eyalet/posta kodu doğrulaması) tetiklenebilir. |
sortingCode |
İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Bu ad çoğu bölgede kullanılmaz. Kullanıldığı yerde değer, "CEDEX" gibi bir dize ve isteğe bağlı olarak ardından bir sayı (ör. "CEDEX 7") veya "sektör kodunu" temsil eden yalnızca tek bir sayıdır (Jamaika), "teslimat alanı göstergesi" (Malavi) veya "postane göstergesi" (ör. Fildişi Sahili). |
administrativeArea |
İ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'da bu, özerk topluluk değil ildir (ör. "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 |
İsteğe bağlı. Genellikle adresin şehir/kasaba kısmını ifade eder. Örnekler: ABD şehri, BT komünü, Birleşik Krallık posta şehri. Yerelliklerin iyi tanımlanmadığı veya bu yapıya iyi uymadığı dünya bölgelerinde locality alanını boş bırakın ve addressLines alanını kullanın. |
sublocality |
İsteğe bağlı. Adresin alt mahallesi. Örneğin; mahalle, kaza, ilçe olabilir. |
addressLines[] |
Bir adresin alt düzeylerini açıklayan yapılandırılmamış adres satırları. addressLines içindeki değerler tür bilgisi içermediğinden ve bazen tek bir alanda birden çok değer (ör. "Austin, TX") içerebildiğinden satır sırasının açık olması önemlidir. Adres satırlarının sırası, adresin bulunduğu ülke/bölge için "zarf sırası" olmalıdır. Bu özelliğin değişebileceği yerlerde (ör. Japonya), açık hale getirmek için address_language 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" ya da "en"). Bu sayede, bir adresin en spesifik satırı dile göre seçilebilir. Bir adresin izin verilen minimum yapısal gösterimi, kalan tüm bilgilerin addressLines içine yerleştirildiği bir regionCode'dan 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şenlerinin hiçbiri hakkında anlamsal bir çıkarım yapılamaz. Yalnızca regionCode ve addressLines içeren bir adres oluşturduktan sonra coğrafi kodlama, tamamen yapılandırılmamış adresleri işlemek için önerilen yöntemdir (adresin hangi bölümlerinin yerel bölgeler veya idari alanlar olması gerektiğini tahmin etmek yerine). |
recipients[] |
İ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 |
İsteğe bağlı. Adresteki kuruluşun adı. |