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

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

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

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

  • שמות אזורי זמן מותאמים לשוק המקומי למיקומים במפה מ-Google Maps Platform.
  • הסטות של אזור הזמן מ-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=1733428634
  &key=YOUR_API_KEY

משאבים

בטבלה הבאה מפורטים המשאבים שזמינים דרך Time Zone API והנתונים שהוא מחזיר:

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

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

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

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

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

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

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

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