מתחילים

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

בקשה ותגובה לדוגמה

ניתן לגשת ל-Time Zone API דרך ממשק HTTPS, עם בקשות שנוצרו כמחרוזת של כתובת אתר, המשתמשות בקואורדינטות של קו אורך/רוחב לציין את 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 בכך שהן מספקות הטמעות נייטיב של משימות נפוצות כמו אימות, בקשה ויסות נתונים (throttle) וניסיונות חוזרים באופן אוטומטי. ה-Time Zone API זמין ב לקוח Java, לקוח Python, Go Client ו-Node.js של שירותי מפות Google.

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

אימות

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

מכסות ותמחור

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

מדיניות

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

מידע נוסף

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

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