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

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

למה כדאי להשתמש ב-Time Zone API

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

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

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

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

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

איך פועל 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
  

מקורות מידע

בטבלה הבאה מוצג סיכום של המשאבים שזמינים דרך 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, שם גם אפשר למצוא הוראות התקנה וקוד לדוגמה.

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