Time Zone API מספק נתונים על הזמן שחלף במיקומים על פני כדור הארץ. בקשת מידע על אזור הזמן של זוג קואורדינטות ספציפי של קו רוחב וקו אורך ושל תאריך. ה-API מחזיר את השם של אזור הזמן, את הזמן שחלף מ-UTC ואת הזמן שחלף משעון הקיץ.
דוגמה לבקשה ולתשובה
כדי לגשת ל-Time Zone API דרך ממשק HTTPS, צריך ליצור בקשות כמחרוזת של כתובת URL, באמצעות קואורדינטות של קו רוחב וקו אורך כדי לציין את location, timestamp כדי לציין את התאריך, ומפתח ה-API.
השאילתה הבאה מבצעת בקשה לאזור זמן עבור נבאדה, ארה"ב. חותמת הזמן מוגדרת ל-8 במרץ 2012.
כתובת URL
https://maps.googleapis.com/maps/api/timezone/json ?location=39.6034810%2C-119.6822510 ×tamp=1733428634 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1733428634&key=YOUR_API_KEY'
כדי לבדוק את הבקשה, אפשר להזין את כתובת ה-URL בדפדפן האינטרנט. חשוב להחליף את הערך YOUR_API_KEY במפתח ה-API בפועל. התגובה כוללת את נתוני אזור הזמן של המיקום והתאריך שצוינו (timestamp).
במדריך למפתחים מוסבר איך ליצור כתובות URL לבקשות ופרמטרים זמינים ואיך להבין את התגובה.
הדוגמה הבאה מציגה תגובה ב-JSON:
JSON
{ "dstOffset": 0, "rawOffset": -28800, "status": "OK", "timeZoneId": "America/Los_Angeles", "timeZoneName": "Pacific Standard Time", }
XML
<TimeZoneResponse> <status>OK</status> <raw_offset>-28800.0000000</raw_offset> <dst_offset>0.0000000</dst_offset> <time_zone_id>America/Los_Angeles</time_zone_id> <time_zone_name>Pacific Standard Time</time_zone_name> </TimeZoneResponse>
איך מתחילים לתכנת באמצעות ספריות לקוח
ספריות הלקוח מפשטות את הפיתוח באמצעות ממשקי ה-API של שירות האינטרנט של מפות Google, על ידי הטמעות מובנות ופשוטות של משימות נפוצות כמו אימות, ויסות בקשות וניסיון חוזר אוטומטי. Time Zone API זמין ב-Java Client, Python Client, Go Client ו-Node.js Client for Google Maps Services.
אימות, מכסות, תמחור וכללי מדיניות
אימות
כדי להשתמש ב-Time Zone API, קודם צריך להפעיל את ה-API ולקבל את פרטי הכניסה המתאימים לאימות. מידע נוסף זמין במאמר תחילת העבודה עם Google Maps Platform.
מכסות ותמחור
במאמר שימוש וחיוב מפורטות המכסות והמחירים של Time Zone API.
מדיניות
השימוש ב-Time Zone API חייב לעמוד בדרישות של מדיניות ה-API.
מידע נוסף
ב-Time Zone API, אפשר גם להגדיר פרמטר של שפה כדי לקבל תוצאות בשפות אחרות, ולא רק באנגלית (שמוגדרת כברירת מחדל). במדריך למפתחים של Time Zone API יש דוגמאות נוספות ופרטים אחרים.
המדריך למפתחים של Time Zone API עוזר למפתחים של אתרים ואפליקציות לנייד לכלול נתוני זמן במפות שסופקו על ידי אחד מממשקי ה-API של הפלטפורמה של מפות Google. הוא כולל מבוא לשימוש ב-API וחומר עזר על הפרמטרים הזמינים.