شروع به کار

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

درخواست و پاسخ نمونه

ازطریق میانای HTTPS به Time Zone API دسترسی پیدا کنید، درخواست‌ها به‌صورت رشته نشانی وب ساخته می‌شوند، از مختصات طول و عرض جغرافیایی برای مشخص کردن location، از timestamp برای مشخص کردن تاریخ، و از کلید میانای برنامه‌سازی کاربردی شما استفاده می‌شود.

پرسمان زیر درخواست منطقه زمانی را برای نوادا، ایالات متحده انجام می‌دهد. مُهر زمان روی ۸ مارس ۲۰۱۲ تنظیم شده است.

نشانی وب

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

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=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» دردسترس است.

اصالت‌سنجی، سهمیه‌ها، قیمت‌گذاری، و خط‌مشی‌ها

اصالت‌سنجی

برای استفاده از Time Zone API، ابتدا باید این API را فعال کنید و اعتبارنامه‌های اصالت‌سنجی مناسب را دریافت کنید. برای اطلاعات بیشتر، به شروع به کار با Google Maps Platform مراجعه کنید.

سهمیه‌ها و قیمت‌گذاری

برای جزئیات مربوط به سهمیه‌ها و قیمت‌گذاری تعیین‌شده برای Time Zone API، استفاده و صورت‌حساب را ببینید.

خط‌مشی‌ها

استفاده از Time Zone API باید از خط‌مشی‌های API تبعیت کند.

بیشتر بدانید

در Time Zone API، می‌توانید پارامتر زبان را نیز تنظیم کنید تا نتایج به زبان‌هایی غیراز زبان پیش‌فرض انگلیسی برگردانده شود. برای مثال‌های بیشتر و جزئیات دیگر، راهنمای توسعه‌دهنده Time Zone API را ببینید.

راهنمای توسعه‌دهندگان Time Zone API به توسعه‌دهندگان وب‌سایت و تلفن همراه کمک می‌کند تا داده‌های زمان را در نقشه‌های ارائه‌شده توسط یکی از میاناهای برنامه‌سازی کاربردی «پلاتفرم Google Maps» بگنجانند. این سند مقدمه‌ای برای استفاده از API و مطالب مرجع درباره پارامترهای دردسترس ارائه می‌دهد.