البدء

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

توفّر واجهة برمجة التطبيقات للمنطقة الزمنية بيانات معادلة الوقت للمواقع الجغرافية على سطح الأرض. اطلب معلومات المنطقة الزمنية لزوج/خط عرض معيّن/خط عرض. تعرض واجهة برمجة التطبيقات اسم هذه المنطقة الزمنية، مع معادلة الوقت بالتوقيت العالمي المنسّق (UTC).

نموذج للطلب والاستجابة

يمكنك الوصول إلى واجهة برمجة تطبيقات المنطقة الزمنية من خلال واجهة HTTPS، مع الطلبات التي يتم إنشاؤها كسلسلة عناوين URL، باستخدام إحداثيات خطوط الطول والعرض لتحديد location، وtimestamp لتحديد التاريخ، ومفتاح واجهة برمجة التطبيقات.

يُجري الطلب التالي طلب منطقة زمنية لولاية نيفادا بالولايات المتحدة الأمريكية. تم ضبط الطابع الزمني على 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'

JavaScript

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY',
  headers: { }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Python

import requests

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

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY")
  .method("GET", body)
  .build();
Response response = client.newCall(request).execute();

لغة Ruby

require "uri"
require "net/http"

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

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body

البدء

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1331161200&key=YOUR_API_KEY"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

بوستمان

تتوفر أيضًا مواصفات OpenAPI كمجموعة Postman.

التشغيل في Postman

ويمكنك اختبار ذلك من خلال إدخال عنوان URL في متصفّح الويب (احرص على استبدال YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات الفعلي). تتضمن الاستجابة بيانات المنطقة الزمنية للموقع الجغرافي المحدد (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" على الويب، وذلك من خلال توفير عمليات تنفيذ بسيطة وأصلية للمهام الشائعة، مثل المصادقة وطلب تقييد البيانات وإعادة المحاولة تلقائيًا. وتتوفّر واجهة برمجة التطبيقات للمنطقة الزمنية في برنامج Java، وبرنامج Python، وGo Client، وNode.js Client لخدمات "خرائط Google"..

المصادقة والحصص والأسعار والسياسات

المصادقة

لاستخدام واجهة برمجة التطبيقات للمنطقة الزمنية، يجب أولاً تفعيل واجهة برمجة التطبيقات والحصول على بيانات اعتماد المصادقة الصحيحة. ولمزيد من المعلومات، يمكنك الاطّلاع على بدء استخدام "منصة خرائط Google".

الحصص والأسعار

يُرجى مراجعة صفحة الاستخدام والفوترة للحصول على تفاصيل عن الحصص والأسعار المُحدَّدة لواجهة برمجة تطبيقات المنطقة الزمنية.

السياسات

يجب أن يكون استخدام واجهة برمجة التطبيقات للمنطقة الزمنية متوافقًا مع سياسات واجهة برمجة التطبيقات.

مزيد من المعلومات

في واجهة برمجة التطبيقات للمنطقة الزمنية، يمكنك أيضًا ضبط معلمة اللغة لعرض نتائج بلغات أخرى غير الإنجليزية. راجِع دليل مطوّري برامج المنطقة الزمنية لواجهة برمجة التطبيقات للحصول على مزيد من الأمثلة والتفاصيل الأخرى.

تم تصميم دليل مطوّري برامج المنطقة الزمنية لمطوّري البرامج على الويب والأجهزة الجوّالة الذين يريدون إدراج بيانات الوقت على الخرائط التي توفرها إحدى واجهات برمجة تطبيقات "منصة خرائط Google". ويوفّر مقدّمة عن استخدام واجهة برمجة التطبيقات ومرجعًا مرجعيًا إلى المعلّمات المتاحة.