نمای کلی Time Zone API

Time Zone API سرویسی است که درخواست HTTP مختصات طول/عرض جغرافیایی و تاریخ و زمان انتخابی را می‌پذیرد. داده‌های منطقه زمانی مکان را برمی‌گرداند، ازجمله جبران‌های ساعت هماهنگ جهانی و ساعت تابستانی.

چرا از Time Zone API استفاده کنیم

با Time Zone API، می‌توانید برنامه‌هایی توسعه دهید که شناسه و نام منطقه زمانی را برای تاریخ‌ها و زمان‌ها در مکان‌های خاص روی نقشه ارائه می‌دهد. برای مثال، می‌توانید داده‌های منطقه زمانی زیر را نشان دهید:

  • نام‌های بومی‌سازی‌شده منطقه زمانی برای مکان‌های نقشه از Google Maps Platform.
  • اختلاف منطقه زمانی از «ساعت هماهنگ جهانی» و برای وقت تابستانی.

داده‌های منطقه زمانی به‌ویژه زمانی مفید است که بخواهید وب‌سایت یا برنامه شما داده‌های زمان‌بندی‌شده مرتبط با کاربران را نمایش دهد.

کارهایی که می‌توانید با Time Zone API انجام دهید

با Time Zone API، می‌توانید منطقه زمانی را برای مکان‌های روی سطح زمین، با اختلاف زمانی از UTC و برای وقت تابستانی برای هریک از آن مکان‌ها درخواست کنید.

نحوه عملکرد Time Zone API

«میانای برنامه‌سازی کاربردی منطقه زمانی» درخواست HTTPS مختصات عرض/طول جغرافیایی، تاریخ و زمان موردنظر به‌عنوان مُهر زمان، و درصورت تمایل، کد زبان را می‌پذیرد. داده‌ها را در قالبی که درخواست مشخص کرده است برمی‌گرداند. مثال زیر درخواستی را برای نوادا، ایالات متحده، با خروجی درخواستی در JSON نشان می‌دهد.

 https://maps.googleapis.com/maps/api/timezone/json
    ?location=39.6034810%2C-119.6822510
    &timestamp=1733428634
    &key=YOUR_API_KEY

منابع

جدول زیر منابع دردسترس ازطریق «میانای برنامه‌سازی کاربردی منطقه زمانی» را به‌همراه داده‌هایی که برمی‌گرداند خلاصه می‌کند.

منابع داده داده‌ها برگردانده شد قالب برگشتی
منطقه زمانی

درخواستتان را به‌همراه مکان و مُهر زمان ارائه می‌دهید. پارامترهای الزامی را ببینید.

  • شناسه منطقه زمانی.
  • نام منطقه زمانی، به‌صورت اختیاری بومی‌سازی‌شده
  • فاصله زمانی با UTC، برحسب ثانیه
  • فاصله زمانی برای ساعت تابستانی، برحسب ثانیه
  • برای نمونه‌های پاسخ خاص، به «منطقه زمانی» مراجعه کنید.
  • (قالب) JSON
  • XML

نحوه استفاده از Time Zone API

۱ راه‌اندازی کنید با راه‌اندازی پروژه Google Cloud شروع کنید و دستورالعمل‌های راه‌اندازی را که در ادامه می‌آید تکمیل کنید.
۲ درخواست منطقه زمانی را امتحان کنید پس‌از دریافت کلید API، می‌توانید آزمایش «میانای برنامه‌سازی کاربردی منطقه زمانی» را مستقیماً از مرورگرتان شروع کنید. برای جزئیات بیشتر، مثال‌های منطقه زمانی را در راهنمای درخواست‌ها و پاسخ‌های منطقه زمانی ببینید.
3 آشنایی با اصول اولیه پاسخ ببینید چگونه از داده‌های منطقه زمانی در برنامه یا وب‌سایتتان استفاده کنید. برای جزئیات، پاسخ‌های منطقه زمانی را ببینید.
۵ داده‌های منطقه زمانی را در برنامه خودتان بگنجانید! می‌توانید از داده‌های منطقه زمانی برای بهبود برنامه‌ها و وب‌سایت‌ها برای کاربران در مکان‌های زمانی مختلف استفاده کنید.

کتابخانه‌های کارخواه دردسترس

این «میانای برنامه‌سازی کاربردی» را به زبان دلخواهتان ازطریق یکی از کتابخانه‌های مشتری زیر فراخوانی کنید:

«کارخواه جاوا»، «کارخواه پایتون»، «کارخواه Go»، و «کارخواه Node.js» برای «سرویس‌های Google Maps» کتابخانه‌های کارخواه با پشتیبانی انجمن هستند که تحت پروانه Apache 2.0 به‌صورت متن‌باز ارائه شده‌اند. آن‌ها را از GitHub بارگیری کنید، در آنجا می‌توانید دستورالعمل‌های نصب و کد نمونه را نیز پیدا کنید.

قدم بعدی چیست