شروع کنید

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

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

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

درخواست زیر یک درخواست منطقه زمانی را برای نوادا، ایالات متحده آمریکا انجام می دهد. مهر زمانی روی 8 مارس 2012 تنظیم شده است.

URL 

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

CURL 

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

می‌توانید این مورد را با وارد کردن URL در مرورگر وب خود آزمایش کنید (حتماً YOUR_API_KEY با کلید API واقعی خود جایگزین کنید). پاسخ شامل داده های منطقه زمانی برای مکان و تاریخ مشخص شده (timestamp) است.

برای اطلاعات بیشتر در مورد ساخت URL های درخواست و پارامترهای موجود و درک پاسخ ، راهنمای توسعه دهنده را مشاهده کنید.

در زیر یک نمونه پاسخ در 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 برای توسعه‌دهندگان وب‌سایت و تلفن همراه در نظر گرفته شده است که می‌خواهند داده‌های زمانی را در نقشه‌های ارائه‌شده توسط یکی از APIهای پلتفرم Google Maps لحاظ کنند. مقدمه ای برای استفاده از API و مواد مرجع در پارامترهای موجود ارائه می دهد.