Package google.type

Dizin

LatLng

Bir enlem/boylam çiftini temsil eden nesne. Bu değer, enlem derecelerini ve boylam derecelerini temsil eden bir çift çift sayı olarak ifade edilir. Aksi belirtilmediği sürece bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklar içinde olmalıdır.

Alanlar
latitude

double

Enlem (derece cinsinden). [-90.0, +90.0] aralığında olmalıdır.
longitude

double

Boylam (derece cinsinden). [-180.0, +180.0] aralığında olmalıdır.

LocalizedText

Belirli bir dildeki metnin yerelleştirilmiş varyantı.

Alanlar
text

string

Aşağıdaki language_code ile eşleşen dilde yerelleştirilmiş dize.
language_code

string

Metnin BCP-47 dil kodu (ör. "en-US" veya "sr-Latn").

Daha fazla bilgi için http://www.unicode.org/reports/tr35/#Unicode_locale_identifier adresini ziyaret edin.

PostalAddress

Posta teslimatı veya ödeme adresleri gibi posta adreslerini temsil eder. Posta adresiyle, posta hizmeti öğeleri bir binaya, posta kutusuna veya benzer bir yere teslim edebilir. Posta adresi, yollar, kasabalar veya dağlar gibi coğrafi konumları modellemek için kullanılmaz.

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

Adres girişi veya düzenleme ile ilgili tavsiyeler:

  • https://github.com/google/libaddressinput gibi uluslararasılaştırmaya hazır bir adres widget'ı kullanın.
  • Kullanıcılara, alanın kullanıldığı ülkelerin dışındaki alanların girilmesi veya düzenlenmesi için kullanıcı arayüzü öğeleri gösterilmemelidir.

Bu şemayı kullanma hakkında daha fazla bilgi için: https://support.google.com/business/answer/6397478.

Alanlar
revision

int32

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 olarak uyumlu olmalıdır.
region_code

string

Zorunlu. Adresin bulunduğu ülkenin/bölgenin CLDR bölge kodu. Bu değer hiçbir zaman çıkarılmaz 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 adreslerine bakın. Örnek: İsviçre için "CH".
language_code

string

İsteğe bağlıdır. Bu adresteki içeriklerin BCP-47 dil kodu (biliniyorsa). Bu genellikle giriş formunun kullanıcı arayüzü dilidir veya adresin bulunduğu ülkede/bölgede 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".
postal_code

string

İsteğe bağlıdır. Adresin posta kodu. Tüm ülkelerde posta kodu kullanılmaz veya posta kodunun bulunması zorunlu değildir. Ancak posta kodu kullanıldığında adresin diğer kısımlarıyla (ör. ABD'de eyalet veya posta kodu doğrulaması) ek doğrulama tetiklenebilir.
sorting_code

string

İsteğe bağlıdır. Ülkeye özgü ek banka/şube kodu. Bu özellik çoğu bölgede kullanılmaz. Kullanıldığı yerlerde değer, isteğe bağlı olarak bir sayıyla birlikte kullanılan "CEDEX" gibi bir dize (ör. "CEDEX 7") veya "sektör kodunu" (Jamaika), "teslimat alanı göstergesini" (Malavi) ya da "postane göstergesini" (Fildişi Sahili) temsil eden tek bir sayı olabilir.
administrative_area

string

İsteğe bağlıdır. Bir ülkenin 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, eyalettir (ö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ıdır. Genellikle adresin şehir veya kasaba kısmını ifade eder. Örnekler: ABD şehri, İtalya komünü, Birleşik Krallık posta bölgesi. Dünyanın, yerleşim yerlerinin iyi tanımlanmadığı veya bu yapıya iyi uymadığı bölgelerinde locality alanını boş bırakın ve address_lines alanını kullanın.
sublocality

string

İsteğe bağlıdır. Adresin bulunduğu alt yerleşim birimi. Örneğin, bu bir mahalle, ilçe veya bölge olabilir.
address_lines[]

string

Bir adresin alt düzeylerini açıklayan yapılandırılmamış adres satırları.

address_lines içindeki değerlerde tür bilgisi bulunmadığından ve bazen tek bir alanda birden çok 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 bulunduğu ülke veya bölgenin "zarf sırası" olmalıdır. Bunun değişebileceği yerlerde (ör. Japonya), address_language kullanılarak açıkça belirtilir (ö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, bir adresin en spesifik satırı dile göre seçilebilir.

Bir adresin izin verilen minimum yapısal gösterimi, region_code ile başlar ve kalan tüm bilgiler address_lines içine yerleştirilir. Bu tür bir adresi coğrafi kodlama olmadan çok yaklaşık olarak biçimlendirmek mümkün olsa da en azından kısmen çözülene kadar adres bileşenlerinden herhangi biri hakkında anlamsal bir çıkarım yapılamaz.

Yalnızca region_code ve address_lines içeren bir adres oluşturup ardından coğrafi kodlama yapmak, tamamen yapılandırılmamış adresleri (adresin hangi bölümlerinin yerleşim yeri veya idari bölge olması gerektiğini tahmin etmek yerine) ele almanın önerilen yoludur.
recipients[]

string

İsteğe bağlıdır. Adresteki alıcı. Bu alan, belirli durumlarda çok satırlı bilgiler içerebilir. Örneğin, "ilgili" bilgisi içerebilir.
organization

string

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