
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 ×tamp=1733428634 &key=YOUR_API_KEY
منابع
جدول زیر منابع دردسترس ازطریق Time Zone API را بههمراه دادههایی که برمیگرداند خلاصه میکند:
| منابع دادهها | دادههای برگرداندهشده | قالب برگشتی |
|---|---|---|
| منطقه زمانی
درخواستتان را بههمراه مکان و مُهر زمان ارائه میدهید. پارامترهای الزامی را ببینید. |
|
|
نحوه استفاده از Time Zone API
| ۱ | راهاندازی کردن | با راهاندازی پروژه Google Cloud شروع کنید و دستورالعملهای راهاندازی را که در ادامه میآید تکمیل کنید. |
| ۲ | درخواست منطقه زمانی را امتحان کنید | وقتی کلید میانای برنامهسازی کاربردی را دریافت کردید، میتوانید آزمایش Time Zone API را مستقیماً از مرورگرتان شروع کنید. برای جزئیات، نمونههای منطقه زمانی را در راهنمای درخواستها و پاسخهای منطقه زمانی ببینید. |
| 3 | آشنایی با اصول پاسخ | ببینید چگونه از دادههای منطقه زمانی در برنامه یا وبسایتتان استفاده کنید. برای جزئیات، پاسخهای منطقه زمانی را ببینید. |
| ۵ | دادههای منطقه زمانی را در برنامه خودتان ادغام کنید! | میتوانید از دادههای منطقه زمانی برای بهبود برنامهها و وبسایتها در مناطق زبانی مختلف مبتنی بر زمان استفاده کنید. |
کتابخانههای کارخواه دردسترس
این میانای برنامهسازی کاربردی را به زبان انتخابیتان ازطریق یکی از کتابخانههای کارخواه زیر فراخوانی کنید:
- Java Client for Google Maps Services
- Python Client for Google Maps Services
- Go Client for Google Maps Services
- Node.js Client for Google Maps Services
«کارخواه Java»، «کارخواه Python»، «کارخواه Go»، و «کارخواه Node.js» برای «سرویسهای Google Maps» کتابخانههای کارخواه با پشتیبانی انجمن هستند که تحت پروانه Apache 2.0 بهصورت متنباز ارائه شدهاند. آنها را از GitHub بارگیری کنید، در آنجا میتوانید دستورالعملهای نصب و کد نمونه را نیز پیدا کنید.
قدم بعدی چیست
- با نحوه ایجاد درخواستهای Time Zone آشنا شوید: به درخواستها و پاسخهای Time Zone بروید.
- روالهای مطلوب را دنبال کنید: به روالهای مطلوب سرویسهای وب بروید.