تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توفّر واجهة برمجة التطبيقات Time Zone API بيانات التوقيت المُعدَّل للمواقع الجغرافية على سطح
الأرض. يمكنك طلب معلومات المنطقة الزمنية لزوج خطوط الطول/العرض الجغرافي وتاريخ محدّدَين.
تعرض واجهة برمجة التطبيقات اسم المنطقة الزمنية هذه، ومعادلة التوقيت من التوقيت العالمي المنسق، ومقدار
معادلة التوقيت الصيفي.
نموذج طلب واستجابة
يمكنك الوصول إلى Time Zone API من خلال واجهة HTTPS، مع
إنشاء الطلبات على شكل سلسلة عنوان URL، باستخدام إحداثيات خط العرض/خط الطول لتحديد
المنطقة الزمنية، وtimestamp لتحديد التاريخ،
ومفتاح واجهة برمجة التطبيقات.location
يُجري الطلب أدناه طلب منطقة زمنية لنيومكسيكو، الولايات المتحدة الأمريكية. تم ضبط الطابع الزمني
على 8 آذار (مارس) 2012.
يمكنك اختبار ذلك من خلال إدخال عنوان URL في متصفّح الويب (احرص على استبدال
YOUR_API_KEY بـ مفتاح واجهة برمجة التطبيقات الفعلي).
يتضمّن الردّ بيانات المنطقة الزمنية للموقع الجغرافي والتاريخ المحدّدَين
(timestamp).
تسهّل مكتبات العملاء عملية التطوير باستخدام واجهات برمجة تطبيقات خدمة الويب في "خرائط Google" من خلال توفير تنفيذات بسيطة
ومضمّنة للمهام الشائعة، مثل المصادقة، وتقييد معدل إرسال الطلبات، وإعادة المحاولة التلقائية. تتوفّر واجهة برمجة التطبيقات Time Zone API
في
Java Client
Python Client وGo Client وNode.js Client لخدمات "خرائط Google".
المصادقة والحصص والأسعار والسياسات
المصادقة
لاستخدام Time Zone API، عليك أولاً تفعيل واجهة برمجة التطبيقات والحصول على بيانات اعتماد مصادقة المناسبة. لمزيد من المعلومات، يُرجى الاطّلاع على
بدء استخدام Google Maps Platform.
الحصص والأسعار
راجِع صفحة الاستخدام والفوترة
للاطّلاع على تفاصيل حول الحصص والأسعار المحدّدة لواجهة برمجة التطبيقات Time Zone API.
في Time Zone API، يمكنك أيضًا ضبط مَعلمة لغة
لعرض النتائج بلغات غير اللغة التلقائية وهي الإنجليزية. اطّلِع على
دليل المطوّر لـ Time Zone API للحصول على المزيد من الأمثلة والتفاصيل الأخرى.
دليل مطوّري Time Zone API مخصّص لمطوّري المواقع الإلكترونية والتطبيقات المتوافقة مع الأجهزة الجوّالة الذين يريدون تضمين بيانات الوقت على الخرائط التي تقدّمها إحدى واجهات برمجة التطبيقات في "منصة خرائط Google". ويقدّم مقدّمة عن استخدام واجهة برمجة التطبيقات ومواد مرجعية حول المَعلمات المتاحة.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Time Zone API provides time offset data for locations on Earth based on latitude/longitude and date, returning the time zone name, UTC offset, and daylight savings offset.\u003c/p\u003e\n"],["\u003cp\u003eTo use the API, you need a Google Cloud project with billing enabled and the Time Zone API enabled, along with an API key for authentication.\u003c/p\u003e\n"],["\u003cp\u003eYou can access the API through HTTPS using a URL with parameters for location, timestamp, and your API key.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries are available in Java, Python, Go, and Node.js to simplify development with the Time Zone API.\u003c/p\u003e\n"],["\u003cp\u003eUsage of the Time Zone API is subject to quotas, pricing, and policies outlined in the documentation.\u003c/p\u003e\n"]]],["The Time Zone API provides time offset data for specific locations and dates. Access it via HTTPS, constructing URLs with latitude/longitude (`location`), date (`timestamp`), and your API key. The API returns the time zone name, UTC offset, and daylight savings offset. Client libraries in Java, Python, Go, and Node.js simplify integration. Using the API requires enabling it, getting authentication credentials, understanding quotas, pricing, and adhering to API policies. Additional information can be found on the developer's guide.\n"],null,["# Get Started\n\n| **Before you begin:** Before you start using the Time Zone API, you need a project with a billing account and the Time Zone API enabled. We recommend creating multiple Project Owners and Billing Administrators, so that you'll always have someone with these roles available to your team. To learn more, see [Set up in Cloud console](/maps/documentation/timezone/cloud-setup).\n\nThe Time Zone API provides time offset data for locations on the surface of the\nearth. Request the time zone information for a specific latitude/longitude pair and date.\nThe API returns the name of that time zone, the time offset from UTC, and the\ndaylight savings offset.\n\nSample request and response\n---------------------------\n\nAccess the Time Zone API through an **HTTPS** interface, with\nrequests constructed as a URL string, using latitude/longitude coordinates to\nspecify the `location`, a `timestamp` to specify the date,\nand your API key.\n\nThe below query performs a time zone request for Nevada, USA. The timestamp\nis set to March 8th, 2012. \n\n### URL\n\n```scdoc\nhttps://maps.googleapis.com/maps/api/timezone/json\n ?location=39.6034810%2C-119.6822510\n ×tamp=1733428634\n &key=YOUR_API_KEY\n```\n\n### cURL\n\n```bash\ncurl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1733428634&key=YOUR_API_KEY'\n```\n\nYou can test this by entering the URL into your web browser (be sure to replace\n`YOUR_API_KEY` with [your actual API key](#get-a-key)).\nThe response includes the time zone data for the specified location and date\n`(timestamp)`.\n\nView the [developer's guide](/maps/documentation/timezone/overview)\nfor more information about\n[building request URLs and available parameters](/maps/documentation/timezone/overview#requests)\nand [understanding the response](/maps/documentation/timezone/overview#TimeZoneResponse).\n\nBelow is a sample response, in JSON: \n\n### JSON\n\n```json\n{\n \"dstOffset\": 0,\n \"rawOffset\": -28800,\n \"status\": \"OK\",\n \"timeZoneId\": \"America/Los_Angeles\",\n \"timeZoneName\": \"Pacific Standard Time\",\n}\n```\n\n### XML\n\n```xml\n\u003cTimeZoneResponse\u003e\n \u003cstatus\u003eOK\u003c/status\u003e\n \u003craw_offset\u003e-28800.0000000\u003c/raw_offset\u003e\n \u003cdst_offset\u003e0.0000000\u003c/dst_offset\u003e\n \u003ctime_zone_id\u003eAmerica/Los_Angeles\u003c/time_zone_id\u003e\n \u003ctime_zone_name\u003ePacific Standard Time\u003c/time_zone_name\u003e\n\u003c/TimeZoneResponse\u003e\n```\n\nStart coding with our client libraries\n--------------------------------------\n\nClient libraries make developing with the Google Maps web service APIs easier by providing simple,\nnative implementations of common tasks such as authentication, request\nthrottling and automatic retry. The Time Zone API is available\nin the\n[Java Client,\nPython Client, Go Client and Node.js Client for Google Maps Services](/maps/documentation/timezone/client-library).\n\nAuthentication, quotas, pricing, and policies\n---------------------------------------------\n\n### Authentication\n\nTo use the Time Zone API, you must first enable the API and obtain the proper\nauthentication credentials. For more information, see\n[Get Started with Google Maps Platform](https://developers.google.com/maps/get-started).\n\n### Quotas and pricing\n\nReview the [usage and billing](/maps/documentation/timezone/usage-limits) page\nfor details on the quotas and pricing set for the Time Zone API.\n\n### Policies\n\nUse of the Time Zone API must be in accordance with the\n[API policies](/maps/documentation/timezone/policies).\n\nLearn more\n----------\n\nIn the Time Zone API, you can also set a language parameter\nto return results in languages other than the default of English. See the\n[Time Zone API\nDeveloper Guide](/maps/documentation/timezone/overview) for more examples and other details.\n\nThe [Time Zone API Developer Guide](/maps/documentation/timezone/overview) is intended for website and mobile\ndevelopers who want to include time data on maps provided by one of the Google Maps Platform\nAPIs. It provides an introduction to using the API and reference material on the available\nparameters."]]
