«میانای برنامه‌سازی کاربردی منطقه زمانی» داده‌های اختلاف زمان را برای مکان‌های روی سطح زمین ارائه می‌دهد. درخواست اطلاعات منطقه زمانی برای یک جفت طول/عرض جغرافیایی و تاریخ خاص. این میانای برنامه‌سازی کاربردی نام آن منطقه زمانی، اختلاف زمانی از ساعت هماهنگ جهانی، و اختلاف وقت تابستانی را برمی‌گرداند.
نمونه درخواست و پاسخ
ازطریق میانای HTTPS به Time Zone API دسترسی پیدا کنید، با
درخواست‌هایی که به‌عنوان رشته نشانی وب ساخته شده‌اند، بااستفاده از مختصات طول/عرض جغرافیایی برای
مشخص کردن location، و timestamp برای مشخص کردن تاریخ،
و کلید API شما.
پُرسمان زیر درخواست منطقه زمانی برای نوادا، ایالات متحده امریکا را انجام می‌دهد. مُهر زمان روی ۸ مارس ۲۰۱۲ تنظیم شده است.
نشانی وب
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'
می‌توانید این را با وارد کردن نشانی وب در مرورگر وب خود آزمایش کنید (حتماً
YOUR_API_KEY را با کلید میانای برنامه‌سازی کاربردی واقعی خود جایگزین کنید).
پاسخ شامل داده‌های منطقه زمانی برای مکان و تاریخ مشخص‌شده است
(timestamp).
برای کسب اطلاعات بیشتر درباره ساختن نشانی‌های وب درخواست و پارامترهای دردسترس و درک پاسخ، راهنمای توسعه‌دهنده را ببینید.
در زیر نمونه‌ای از پاسخ در قالب 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>
با کتابخانه‌های مشتری ما کدنویسی را شروع کنید
کتابخانه‌های کارخواه با ارائه پیاده‌سازی‌های بومی ساده از تکالیف رایج مثل اصالت‌سنجی، تحدید درخواست، و تلاش مجدد خودکار، توسعه با «میاناهای برنامه‌سازی کاربردی سرویس وب Google Maps» را آسان‌تر می‌کنند. Time Zone API در Java Client، Python Client، Go Client، و Node.js Client برای Google Maps Services دردسترس است.
اصالت‌سنجی، سهمیه، قیمت‌گذاری، و خط‌مشی‌ها
اصالت‌سنجی
برای استفاده از Time Zone API، ابتدا باید این API را فعال کنید و اعتبارنامه‌های اصالت‌سنجی مناسب را دریافت کنید. برای اطلاعات بیشتر، به شروع به کار با Google Maps Platform مراجعه کنید.
سهمیه‌ها و قیمت‌گذاری
برای جزئیات مربوط به سهمیه‌ها و قیمت‌گذاری تنظیم‌شده برای «میانای برنامه‌سازی کاربردی منطقه زمانی»، صفحه استفاده و صورت‌حساب را مرور کنید.
خط‌مشی‌ها
استفاده از Time Zone API باید مطابق با خط‌مشی‌های API باشد.
بیشتر بدانید
در Time Zone API، می‌توانید پارامتر زبان را نیز تنظیم کنید تا نتایج به زبان‌هایی غیراز زبان پیش‌فرض انگلیسی برگردانده شود. برای نمونه‌های بیشتر و جزئیات دیگر، راهنمای توسعه‌دهندگان میانای برنامه‌سازی کاربردی منطقه زمانی را ببینید.
«راهنمای توسعه‌دهندگان Time Zone API» برای توسعه‌دهندگان وب‌سایت و تلفن همراهی درنظر گرفته شده است که می‌خواهند داده‌های زمان را در نقشه‌های ارائه‌شده توسط یکی از میاناهای برنامه‌سازی کاربردی «پلاتفرم Google Maps» بگنجانند. این سند مقدمه‌ای بر استفاده از API و مطالب مرجع درباره پارامترهای موجود ارائه می‌دهد.