شروع کنید

قبل از شروع: قبل از شروع استفاده از رابط برنامه‌نویسی کاربردی منطقه زمانی، به یک پروژه با حساب صورتحساب و API منطقه زمانی فعال شده است. توصیه می‌کنیم چندین مالک پروژه و مدیر صورتحساب ایجاد کنید تا همیشه فردی با این نقش‌ها در تیم خود داشته باشید. برای کسب اطلاعات بیشتر، به بخش «تنظیم در کنسول ابری» مراجعه کنید.

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

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

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

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

آدرس اینترنتی

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

حلقه زدن

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

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

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

در زیر یک نمونه پاسخ، در قالب 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>

شروع به کدنویسی با کتابخانه‌های کلاینت ما کنید

کتابخانه‌های کلاینت با ارائه پیاده‌سازی‌های ساده و بومی از وظایف رایج مانند احراز هویت، کنترل درخواست و تلاش مجدد خودکار، توسعه با APIهای سرویس وب Google Maps را آسان‌تر می‌کنند. API منطقه زمانی در Java Client، Python Client، Go Client و Node.js Client برای سرویس‌های Google Maps موجود است.

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

احراز هویت

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

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

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

سیاست‌ها

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

بیشتر بدانید

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

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