התחל בעבודה

לפני שמתחילים: כדי להתחיל להשתמש ב-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
  ×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, לקוח Python, לקוח Go ולקוח Node.js עבור שירותי מפות Google.

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

אימות

כדי להשתמש ב-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 Maps Platform. הוא כולל מבוא לשימוש ב-API וחומר עזר בנושא הפרמטרים הזמינים.