نمای کلی Time Zone API

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

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

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

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

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

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

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

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

‫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

منابع

جدول زیر منابع دردسترس ازطریق Time Zone API را به‌همراه داده‌هایی که برمی‌گرداند خلاصه می‌کند:

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

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

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

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

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

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

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

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

قدم بعدی چیست