Package google.type

אינדקס

תאריך

מייצג תאריך קלנדרי מלא או חלקי, כמו יום הולדת. השעה ביום ואזור הזמן מצוינים במקום אחר או לא משמעותיים. התאריך הוא ביחס ללוח השנה הגרגוריאני. הערך הזה יכול לייצג אחת מהאפשרויות הבאות:

  • תאריך מלא, עם ערכים שונים מאפס לשנה, לחודש וליום.
  • חודש ויום, עם שנה אפס (למשל יום נישואין).
  • שנה בפני עצמה, עם חודש אפס ויום אפס.
  • שנה וחודש, עם יום אפס (לדוגמה, תאריך תפוגת תוקף של כרטיס אשראי).

סוגים קשורים:

שדות
year

int32

השנה שבה חל התאריך. חייב להיות בין 1 ל-9999, או 0 כדי לציין תאריך ללא שנה.
month

int32

החודש בשנה. הערך צריך להיות בין 1 ל-12, או 0 כדי לציין שנה ללא חודש ויום.
day

int32

היום בחודש. הערך חייב להיות בין 1 ל-31 ותקף לשנה ולחודש, או 0 כדי לציין שנה בלבד או שנה וחודש שבהם היום לא רלוונטי.

DayOfWeek

מייצג יום בשבוע.

טיפוסים בני מנייה (enum)
DAY_OF_WEEK_UNSPECIFIED היום בשבוע לא צוין.
MONDAY שני
TUESDAY שלישי
WEDNESDAY רביעי
THURSDAY חמישי
FRIDAY שישי
SATURDAY שבת
SUNDAY ראשון

LatLng

אובייקט שמייצג צמד של קו רוחב/קו אורך. הערך הזה מבוטאת כצמד של כפולים כדי לייצג מעלות קו רוחב ומעלות קו אורך. האובייקט חייב לעמוד בדרישות של תקן WGS84, אלא אם צוין אחרת. הערכים חייבים להיות בטווח נורמלי.

שדות
latitude

double

קו הרוחב במעלות. הוא חייב להיות בטווח [-90.0, +90.0].
longitude

double

קו האורך במעלות. הוא חייב להיות בטווח [-180.0, +180.0].

כסף

מייצג סכום כסף בסוג המטבע שלו.

שדות
currency_code

string

קוד המטבע בן שלוש האותיות שמוגדר בתקן ISO 4217.
units

int64

מספר היחידות השלמות של הסכום. לדוגמה: אם הערך של currencyCode הוא "USD", המשמעות היא ש-1 יחידה = 1 דולר ארה"ב.
nanos

int32

מספר יחידות הננו (10‎^-9) של הסכום. הערך חייב להיות בין -999,999,999 ל- +999,999,999, כולל. אם הערך של units הוא חיובי, הערך של nanos חייב להיות חיובי או אפס. אם הערך של units הוא אפס, הערך של nanos יכול להיות חיובי, אפס או שלילי. אם הערך של units הוא שלילי, הערך של nanos חייב להיות שלילי או אפס. לדוגמה, $-1.75 מיוצג באמצעות הנוסחה units=-1 ו-nanos=-750,000,000.

TimeOfDay

מייצג שעה ביום. התאריך ואזור הזמן לא משמעותיים או שהם מצוינים במקום אחר. יכול להיות ש-API יאפשר להוסיף שניות רגילות. הסוגים הקשורים הם google.type.Date ו-google.protobuf.Timestamp.

שדות
hours

int32

שעות ביום בפורמט 24 שעות. חייב להיות גדול מ-0 או שווה לו, ובדרך כלל חייב להיות שווה ל-23 או קטן ממנו. ממשק API עשוי לאפשר את הערך '24:00:00' בתרחישים כמו שעת סגירת העסק.
minutes

int32

דקות בשעה. חייב להיות גדול מ-0 או שווה לו וקטן מ-59 או שווה לו.
seconds

int32

שניות של דקה. חייב להיות גדול מ-0 או שווה לו, ובדרך כלל חייב להיות שווה ל-59 או קטן ממנו. ממשק API עשוי לאפשר את הערך 60 אם הוא מאפשר שניות רגילות.
nanos

int32

חלקי שנייה, בננו-שניות. הערך חייב להיות גדול מ-0 או שווה לו, וקטן מ-999,999,999 או שווה לו.