البدء

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

نموذج لطلب ورد

يمكنك الدخول إلى واجهة برمجة تطبيقات المنطقة الزمنية من خلال واجهة 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.

Run in 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" على الويب من خلال توفير عمليات تنفيذ أصلية وبسيطة للمهام الشائعة مثل المصادقة وتقييد الطلبات وإعادة المحاولة التلقائية. تتوفّر واجهة برمجة تطبيقات المنطقة الزمنية في برنامج جافا، برنامج Python، Go Go، وعميل Node.js لخدمات "خرائط Google".

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

المصادقة

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

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

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

السياسات

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

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

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

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