שנתחיל?

ה-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
  &timestamp=1331161200
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&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, בלקוח Python, בלקוח Go וב-Node.js לשירותי מפות Google.

אימות, מכסות, תמחור וכללי מדיניות

אימות

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

מכסות ותמחור

פרטים על המכסות והתמחור שהוגדרו ב-Time Zone API מופיעים בדף שימוש וחיוב.

כללי מדיניות

השימוש ב-Time Zone API חייב להיות בהתאם למדיניות של ה-API.

מידע נוסף

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

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