סקירה כללית על 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

משאבים

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

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