התחל בעבודה

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

‏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=1733428634
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=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, בלקוח 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 וחומר עזר בנושא הפרמטרים הזמינים.