Package google.type

Dizin

Tarih

Doğum günü gibi takvim tarihlerinin tamamını veya bir kısmını temsil eder. Saat ve saat dilimi başka bir yerde belirtilmiş veya önemsizdir. Tarih, Gregoryen takvimine göredir. Bu durum aşağıdakilerden birini gösterebilir:

  • Sıfır olmayan yıl, ay ve gün değerleri içeren tam tarih.
  • Sıfır yılı olan bir ay ve gün (ör. yıldönümü).
  • Ay ve gün bilgisi olmayan bir yıl.
  • Sıfır gün içeren bir yıl ve ay (ör. kredi kartının son kullanma tarihi).

İlgili türler:

Alanlar
year

int32

Tarihin yılı. 1 ile 9999 arasında veya yıl olmadan tarih belirtmek için 0 olmalıdır.
month

int32

Yılın ayı. 1 ile 12 arasında veya ay ve gün olmadan bir yıl belirtmek için 0 olmalıdır.
day

int32

Ayın günü. 1 ile 31 arasında olmalı ve yıl ile ay için geçerli olmalıdır. 0 değerini kullanarak da yıl veya gününün önemli olmadığı bir yıl ve ay belirtebilirsiniz.

LatLng

Bir enlem/boylam çiftini temsil eden nesne. Bu değer, enlem derecelerini ve boylam derecelerini temsil eden bir çift çift 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

Derece cinsinden boylam. [-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 değerine karşılık gelen dilde yerelleştirilmiş dize.
language_code

string

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

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

Para

Para birimi türüyle birlikte bir para tutarını temsil eder.

Alanlar
currency_code

string

ISO 4217'de tanımlanan üç harfli para birimi kodu.
units

int64

Tutardaki tam birimler. Örneğin, currencyCode "USD" ise 1 birim bir ABD doları değerindedir.
nanos

int32

Miktarın nano (10^-9) birimi sayısı. Değer, -999.999.999 ile +999.999.999 arasında (değerler dahil) olmalıdır. units pozitifse nanos pozitif veya sıfır olmalıdır. units sıfır ise nanos pozitif, sıfır veya negatif olabilir. units negatifse nanos negatif veya sıfır olmalıdır. Örneğin, -1,75 ABD doları units=-1 ve nanos=-750.000.000 olarak temsil edilir.

PostalAddress

Posta teslimatı veya ödeme adresleri gibi bir posta adresini temsil eder. Posta hizmetleri, posta adresiyle bir tesise, posta kutusuna veya benzeri bir yere teslimat yapabilir. Posta adresleri, yollar, kasabalar veya dağlar gibi coğrafi konumları 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.

Alanlar
revision

int32

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

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

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".
language_code

string

İsteğe bağlıdır. 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".
postal_code

string

İsteğe bağlıdır. Adresin posta kodu. Posta kodları her ülkede kullanılmaz veya zorunlu tutulmaz ancak kullanıldıkları yerlerde adresin diğer bölümleriyle ek doğrulama (ör. ABD'de eyalet veya posta kodu doğrulaması) tetiklenebilir.
sorting_code

string

İsteğe bağlıdır. Ü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.
administrative_area

string

İsteğe bağlıdır. 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, otonom 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ıdır. 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ünya 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 alt mahallesi. Örneğin, bu bir mahalle, semt veya ilçe olabilir.
address_lines[]

string

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

address_lines 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, region_code ile kalan tüm bilgilerin address_lines 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şenlerinin 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 region_code ve address_lines 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ıdır. 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ıdır. Adresteki kuruluşun adı.

TimeZone

IANA Saat Dilimi Veritabanı'ndaki bir saat dilimini temsil eder.

Alanlar
id

string

IANA Saat Dilimi Veritabanı saat dilimi. Örneğin, "America/New_York".
version

string

İsteğe bağlıdır. IANA Saat Dilimi Veritabanı sürüm numarası. Örneğin, "2019a".