
ה-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 ×tamp=1331161200 &key=YOUR_API_KEY
משאבים
בטבלה הבאה מוצג סיכום של המשאבים הזמינים דרך Time Zone API יחד עם הנתונים שהיא מחזירה.
משאבי נתונים | הנתונים שהוחזרו | פורמט החזרה |
---|---|---|
אזור זמן
צריך לספק את הבקשה יחד עם המיקום וחותמת הזמן. לעיון בפרמטרים הנדרשים. |
|
|
איך להשתמש ב-Time Zone API
1 | להגדרה | השלב הראשון הוא הגדרת פרויקט ב-Google Cloud וביצוע ההוראות להגדרה. |
2 | איך לנסות לשלוח בקשה באזור זמן? | כשיהיה לכם מפתח API, תוכלו להתחיל לבדוק את ממשק ה-API של Time Zone ישירות מהדפדפן. פרטים נוספים זמינים בקטע דוגמאות לאזור זמן במדריך בקשות ותגובות של אזור זמן. |
3 | מידע בסיסי על תשובות | איך להשתמש בנתוני אזור זמן באפליקציה או באתר. פרטים נוספים זמינים במאמר התשובות לאזור הזמן . |
5 | משלבים את נתוני אזור הזמן באפליקציה שלכם! | אפשר להשתמש בנתונים של אזור הזמן כדי לשפר אפליקציות ואתרים עבור משתמשים במקומות שונים מבוססי זמן. |
ספריות לקוח זמינות
יש לקרוא לממשק ה-API הזה בשפה שנבחרה דרך אחת מספריות הלקוח הבאות:
- לקוח Java עבור שירותי מפות Google
- Python לקוח עבור שירותי מפות Google
- Go Client עבור שירותי מפות Google
- לקוח Node.js עבור שירותי מפות Google
לקוחות Java, Client-Client, Go Client ו-Node.js עבור 'מפות Google' הם ספריות לקוח הנתמכות על-ידי הקהילה, בקוד פתוח בכפוף לרישיון Apache 2.0. מורידים אותם מ-GitHub. תוכלו למצוא שם גם הוראות להתקנה וקוד לדוגמה.
המאמרים הבאים
- מידע על שליחת בקשות לגבי אזור זמן: כאן אפשר לקרוא את המאמר בקשות ותשובות לגבי אזור זמן.
- כדאי ליישם את השיטות המומלצות: כדאי לעיין במאמר שיטות מומלצות לשירותי אינטרנט.