סקירה כללית על Time Zone API

Time Zone API הוא שירות שמקבל בקשת HTTP מסוג קווי אורך ורוחב של וגם התאריך והשעה הרצויים. הפונקציה מחזירה את השעה נתוני אזור של המיקום, כולל קיזוזים משעון UTC ושעון קיץ שעה.

למה להשתמש ב-Time Zone API

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

  • שמות של אזורי זמן מותאמים לשוק המקומי מהפלטפורמה של מפות Google.
  • אזור הזמן שונה מ-UTC ולשעון קיץ.

הנתונים של אזור הזמן שימושיים במיוחד כאשר רוצים להציג נתונים מבוססי-זמן שרלוונטיים למשתמשים.

מה אפשר לעשות עם Time Zone API

באמצעות ה-Time Zone API תוכלו לבקש אזור זמן עבור על פני כדור הארץ, כשנקודת הזמן מצטמצמת שעון UTC ולשעון קיץ בכל אחד מה- את המיקומים האלה.

איך פועל ה-API של אזור הזמן (Time Zone API)

ה-Time Zone API מקבל בקשת HTTPS לגבי קו רוחב/קו אורך את התאריך והשעה הרצויים כחותמת זמן, ואם רוצים, קוד שפה. היא מחזירה נתונים בפורמט שצוין בבקשה. הדוגמה הבאה מציגה בקשה עבור נבאדה, ארה"ב, עם פלט מבוקש ב-JSON.

 https://maps.googleapis.com/maps/api/timezone/json
    ?location=39.6034810%2C-119.6822510
    &timestamp=1331161200
    &key=YOUR_API_KEY

משאבים

הטבלה הבאה מסכמת את המשאבים הזמינים באמצעות ממשק ה-API של אזור הזמן (Time Zone API) והנתונים שהוא מחזיר.

משאבי נתונים הנתונים שהוחזרו פורמט החזרה
אזור זמן

אתם צריכים לשלוח את הבקשה יחד עם המיקום וחותמת הזמן. צפייה חובה .

  • מזהה אזור הזמן.
  • שם אזור הזמן, ניתן להתאים לשוק המקומי
  • הסטה מ-UTC, בשניות
  • הסטה לשעון קיץ, בשניות
  • בקטע 'אזור זמן' מופיעות דוגמאות לתגובות ספציפיות.
  • JSON
  • XML

איך משתמשים ב-Time Zone API?

1 שנתחיל? מתחילים בהגדרת פרויקט ב-Google Cloud ולהשלים את ההגדרה מפורטות שם.
2 אפשר לנסות לבקש אזור זמן אחרי שמקבלים מפתח API, אפשר להתחיל לבדוק את ה-Time Zone API ישירות דרך בדפדפן. דוגמאות לאזורי זמן לקבלת פרטים נוספים, אפשר לעיין במדריך בקשות ותשובות לאזורי זמן.
3 מידע בסיסי על תשובות כך משתמשים בנתוני אזור זמן באפליקציה או באתר. הצגת תשובות לאזור הזמן לקבלת פרטים.
5 שילוב נתונים של אזור זמן באפליקציה שלכם ניתן להשתמש בנתוני אזור זמן כדי לשפר אפליקציות ואתרים עבור משתמשים בכל לוקאלים שונים שמבוססים על זמן.

ספריות לקוח זמינות

אפשר לקרוא ל-API הזה בשפה של לבחירתכם באמצעות אחת מספריות הלקוח הבאות:

לקוחות Java, לקוח Python, לקוח Go ולקוח Node.js למפות Google השירותים הם ספריות לקוח בתמיכה על ידי הקהילה, והן מבוססות על קוד פתוח רישיון Apache 2.0. מורידים אותם מ-GitHub, שם אפשר גם למצוא הוראות התקנה וקוד לדוגמה.

המאמרים הבאים