เริ่มต้นใช้งาน

ข้อควรปฏิบัติก่อนที่จะเริ่มต้น: ก่อนที่จะเริ่มใช้ Time Zone API คุณต้องมีโปรเจ็กต์ที่มีบัญชีสำหรับการเรียกเก็บเงินและเปิดใช้ Time Zone API เราขอแนะนำให้สร้างเจ้าของโปรเจ็กต์และผู้ดูแลระบบการเรียกเก็บเงินหลายคน เพื่อให้ทีมของคุณมีผู้ที่มีบทบาทเหล่านี้อยู่เสมอ ดูข้อมูลเพิ่มเติมได้ที่ ตั้งค่าใน Cloud Console

Time Zone API ให้ข้อมูลออฟเซ็ตเวลาสำหรับสถานที่ต่างๆ บนพื้นผิวโลก ขอข้อมูลเขตเวลาสำหรับคู่ละติจูด/ลองจิจูดและวันที่ที่เฉพาะเจาะจง API จะแสดงชื่อเขตเวลาดังกล่าว ค่าชดเชยเวลาจาก UTC และ ค่าชดเชยเวลาออมแสง

ตัวอย่างคำขอและการตอบกลับ

เข้าถึง Time Zone API ผ่านอินเทอร์เฟซ HTTPS โดยมี คำขอที่สร้างเป็นสตริง URL โดยใช้พิกัดละติจูด/ลองจิจูดเพื่อ ระบุ location, timestamp เพื่อระบุวันที่ และคีย์ API ของคุณ

คำค้นหาด้านล่างจะส่งคำขอเขตเวลาสำหรับเนวาดา สหรัฐอเมริกา การประทับเวลา ตั้งค่าเป็นวันที่ 8 มีนาคม 2012

URL

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

curl

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

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 ง่ายขึ้นด้วยการใช้งานแบบเนทีฟที่เรียบง่าย สำหรับงานทั่วไป เช่น การตรวจสอบสิทธิ์ การควบคุมอัตราคำขอ และการลองใหม่โดยอัตโนมัติ Time Zone API พร้อมใช้งาน ใน Java Client, Python Client, Go Client และ Node.js Client สำหรับบริการของ Google Maps

การตรวจสอบสิทธิ์ โควต้า ราคา และนโยบาย

การตรวจสอบสิทธิ์

หากต้องการใช้ Time Zone API คุณต้องเปิดใช้ API ก่อนและรับ ข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์ที่เหมาะสม ดูข้อมูลเพิ่มเติมได้ที่ เริ่มต้นใช้งาน Google Maps Platform

โควต้าและการกำหนดราคา

ดูรายละเอียดเกี่ยวกับโควต้าและราคาที่ตั้งไว้สำหรับ Time Zone API ได้ในหน้าการใช้งานและการเรียกเก็บเงิน

นโยบาย

การใช้ Time Zone API ต้องเป็นไปตามนโยบาย API

ดูข้อมูลเพิ่มเติม

ใน Time Zone API คุณยังตั้งค่าพารามิเตอร์ภาษา เพื่อแสดงผลลัพธ์ในภาษาอื่นที่ไม่ใช่ภาษาอังกฤษซึ่งเป็นค่าเริ่มต้นได้ด้วย ดูตัวอย่างเพิ่มเติมและรายละเอียดอื่นๆ ได้ใน คู่มือนักพัฒนาซอฟต์แวร์ Time Zone API

คู่มือนักพัฒนาซอฟต์แวร์ Time Zone API มีไว้สำหรับนักพัฒนาซอฟต์แวร์เว็บไซต์และอุปกรณ์เคลื่อนที่ที่ต้องการรวมข้อมูลเวลาในแผนที่ที่ให้บริการโดย API ของ Google Maps Platform โดยจะแนะนำการใช้ API และเอกสารอ้างอิงเกี่ยวกับพารามิเตอร์ที่ใช้ได้