نمای کلی API منطقه زمانی

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

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

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

  • نام‌های منطقه زمانی محلی برای مکان‌های نقشه از پلتفرم نقشه‌های Google.
  • منطقه زمانی از UTC و برای صرفه جویی در روز تغییر می کند.

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

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

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

چگونه API منطقه زمانی کار می کند

Time Zone API یک درخواست HTTPS مختصات طول و عرض جغرافیایی، تاریخ و زمان مورد نظر را به عنوان مهر زمانی، و به صورت اختیاری، یک کد زبان را می پذیرد. داده ها را با فرمت مشخص شده توسط درخواست برمی گرداند. مثال زیر یک درخواست برای نوادا، ایالات متحده آمریکا، با خروجی درخواستی در JSON را نشان می دهد.

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

منابع

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

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

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

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

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

1 راه اندازی شود با راه‌اندازی پروژه Google Cloud خود شروع کنید و دستورالعمل‌های راه‌اندازی را تکمیل کنید.
2 درخواست منطقه زمانی را امتحان کنید هنگامی که یک کلید API دارید، می توانید آزمایش API منطقه زمانی را مستقیماً از مرورگر خود شروع کنید. برای جزئیات، نمونه‌های منطقه زمانی را در راهنمای درخواست‌ها و پاسخ‌های منطقه زمانی ببینید.
3 اصول پاسخگویی را درک کنید نحوه استفاده از داده های منطقه زمانی را در برنامه یا وب سایت خود کاوش کنید. برای جزئیات بیشتر به پاسخ‌های منطقه زمانی مراجعه کنید .
5 داده های منطقه زمانی را در برنامه خود بگنجانید! می‌توانید از داده‌های منطقه زمانی برای بهبود برنامه‌ها و وب‌سایت‌ها برای کاربران در مناطق مختلف مبتنی بر زمان استفاده کنید.

کتابخانه های مشتری موجود

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

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

بعدش چی