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

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

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

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

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

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

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

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

איך פועל Time Zone API

ממשק ה-API של Time Zone מקבל בקשת 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, בשניות
  • קיזוז ל-DST, בשניות
  • דוגמאות אזור מוצגות בקטע 'אזור זמן'.
  • JSON
  • XML

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

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

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

יש לקרוא לממשק ה-API הזה בשפה שנבחרה דרך אחת מספריות הלקוח הבאות:

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

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