نظرة عامة على Time Zone API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
Time Zone API هي خدمة تقبل طلب HTTP يحتوي على إحداثيات خط الطول/العرض وتاريخ ووقت محدّدَين. يعرض الوقت
بيانات المنطقة الخاصة بالموقع الجغرافي، بما في ذلك معادلة التوقيت العالمي المنسَّق (UTC) والتوقيت الصيفي
الوقت.
أسباب استخدام Time Zone API
باستخدام واجهة برمجة التطبيقات Time Zone API، يمكنك تطوير التطبيقات التي توفّر
رقم تعريف المنطقة الزمنية واسم التواريخ والأوقات في مواقع جغرافية محدّدة
على الخريطة. على سبيل المثال، يمكنك عرض بيانات المنطقة الزمنية التالية:
- أسماء المناطق الزمنية المترجَمة للمواقع الجغرافية على الخريطة من "منصة خرائط Google"
- توقيت المنطقة الزمنية مقارنةً بالتوقيت العالمي المنسّق وتوقيت التوقيت الصيفي
يمكن أن تكون بيانات المنطقة الزمنية مفيدة بشكل خاص عندما تريد أن يعرض
موقعك الإلكتروني أو تطبيقك بيانات مستندة إلى الوقت ذات صلة بالمستخدمين.
الإجراءات التي يمكنك تنفيذها باستخدام 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 بالإضافة إلى البيانات التي تعرِضها.
| موارد البيانات |
البيانات التي تم عرضها |
تنسيق الإرجاع |
| المنطقة الزمنية
يمكنك تقديم طلبك مع الموقع الجغرافي والطابع الزمني. عرض
حقل مطلوب
المَعلمات.
|
- رقم تعريف المنطقة الزمنية.
- اسم المنطقة الزمنية، مترجم اختياريًا
- الانحراف عن التوقيت العالمي المنسَّق (UTC) بالثواني
- الفارق الزمني للتوقيت الصيفي بالثواني
- اطّلِع على "المنطقة الزمنية" للحصول على أمثلة محدّدة على الردود.
|
|
كيفية استخدام Time Zone API
| 1 |
الإعداد |
ابدأ بـ إعداد
مشروعك على Google Cloud
وأكمِل تعليمات الإعداد التالية. |
| 2 |
تجربة طلب منطقة زمنية |
بعد الحصول على مفتاح واجهة برمجة التطبيقات، يمكنك بدء اختبار Time Zone API مباشرةً من
المتصفّح. اطّلِع على أمثلة على المناطق الزمنية
في دليل طلبات المناطق الزمنية وردود عليها للاطّلاع على التفاصيل.
|
| 3 |
التعرّف على أساسيات الاستجابة |
تعرَّف على كيفية استخدام بيانات المنطقة الزمنية في تطبيقك أو موقعك الإلكتروني.
اطّلِع على الردود المتعلّقة بالمنطقة الزمنية
للاطّلاع على التفاصيل.
|
| 5 |
يمكنك دمج بيانات المنطقة الزمنية في تطبيقك. |
يمكنك استخدام بيانات المنطقة الزمنية لتحسين التطبيقات والمواقع الإلكترونية للمستخدمين في
لغات مختلفة مستندة إلى الوقت.
|
مكتبات البرامج المتاحة
يمكنك طلب بيانات من واجهة برمجة التطبيقات هذه بلغة
اختيارك من خلال إحدى مكتبات العملاء التالية:
مكتبة Java Client وPython Client وGo Client وNode.js Client لخدمات "خرائط Google"
هي مكتبات عملاء مفتوحة المصدر تدعمها جهات خارجية بموجب ترخيص Apache 2.0.
قم بتنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونموذج التعليمات البرمجية.
الخطوات التالية
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Time Zone API provides time zone data, including UTC and daylight savings offsets, for specific locations based on latitude/longitude and timestamp.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the API to display localized time zone names, offsets, and enhance time-based data in your applications.\u003c/p\u003e\n"],["\u003cp\u003eThe API accepts HTTPS requests with location and timestamp parameters and returns data in JSON or XML format.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries are available in Java, Python, Go, and Node.js for easy integration into your projects.\u003c/p\u003e\n"]]],["The Time Zone API retrieves time zone data for specific locations using latitude/longitude coordinates and a timestamp. It returns the time zone ID, localized name, UTC offset, and daylight saving time offset in JSON or XML format. To use it, you send an HTTPS request with location and timestamp and you can then utilize the data in your website or apps to show time-based information relevant to users' locations. You can also use one of the provided client libraries to access the API.\n"],null,["# Time Zone API overview\n\nThe Time Zone API is a service that accepts an HTTP request of\nlatitude/longitude coordinates and a chosen date and time. It returns the time\nzone data for the location, including offsets for UTC and daylight savings\ntime.\n\nWhy use the Time Zone API\n-------------------------\n\nWith the Time Zone API, you can develop applications that provide\nthe time zone ID and name for dates and times at specific locations\non a map. For example, you can show the following\ntime zone data:\n\n- Localized time zone names for map locations from the Google Maps Platform.\n- Time zone offsets from UTC and for daylight savings.\n\nTime zone data can be particularly useful when you want to have your\nwebsite or app display time-based data relevant to your users.\n\nWhat you can do with the Time Zone API\n--------------------------------------\n\nWith the Time Zone API, you can request the time zone for\nlocations on the surface of the earth, with the time offset from\nUTC and for daylight savings time for each of\nthose locations.\n\nHow the Time Zone API works\n---------------------------\n\nThe Time Zone API accepts an HTTPS request of latitude/longitude\ncoordinates, the desired date and time as a timestamp, and optionally,\na language code. It returns data in the format specified by the request.\nThe following example shows a request for\nNevada, USA, with a requested output in JSON. \n\n```scdoc\n https://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\n### Resources\n\nThe following table summarizes the resources available through the\nTime Zone API along with the data it returns.\n\n| Data resources | Data returned | Return format |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|\n| **Timezone** You provide your request along with location and timestamp. See [required parameters](/maps/documentation/timezone/requests-timezone#required-parameters). | - Time zone ID. - Time zone name, optionally localized - Offset from UTC, in seconds - Offset for DST, in seconds - See Time Zone for specific response examples. | - JSON - XML |\n\nHow to use the Time Zone API\n----------------------------\n\n|---|--------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/elevation/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Try a timezone request** | Once you have an API key, you can start testing out the Time Zone API directly from your browser. See [Time Zone examples](/maps/documentation/timezone/requests-timezone#examples) in the Timezone requests and responses guide for details. |\n| 3 | **Understand response basics** | Explore how to use timezone data in your app or website. See [Time Zone responses](/maps/documentation/timezone/requests-timezone#responses) for details. |\n| 5 | **Incorporate timezone data into your own app!** | You can use timezone data to enhance apps and websites for users across different time-based locales. |\n\n### Available client libraries\n\nCall this API in the language of\nyour choice through one of the following client libraries:\n\n- [Java\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client\n for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nThe Java Client, Python Client, Go Client and Node.js Client for Google Maps\nServices are community-supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\nDownload them from GitHub, where you can also find installation instructions and sample code.\n\nWhat's next\n-----------\n\n- **Learn how to make Time Zone requests** : Go to [Time Zone Requests and responses](/maps/documentation/timezone/requests-timezone).\n- **Follow best practices** : Go to [Web Services Best Practices](/maps/documentation/timezone/web-service-best-practices)."]]
