ภาพรวมของ Time Zone API

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

เหตุผลที่ควรใช้ Time Zone API

เมื่อใช้ Time Zone API คุณสามารถพัฒนาแอปพลิเคชันสำหรับ รหัสเขตเวลาและชื่อสำหรับวันที่และเวลาในสถานที่ที่เจาะจง บนแผนที่ เช่น คุณสามารถแสดงข้อมูลเขตเวลาต่อไปนี้

  • ชื่อเขตเวลาที่แปลแล้วสำหรับตำแหน่งบนแผนที่จาก Google Maps Platform
  • ปรับเขตเวลาจาก UTC และการปรับเวลาตามฤดูกาล

ข้อมูลเขตเวลาจะมีประโยชน์อย่างยิ่งเมื่อคุณต้องการให้เว็บไซต์หรือแอปแสดงข้อมูลที่อิงตามเวลาซึ่งเกี่ยวข้องกับผู้ใช้

คุณสามารถใช้ 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
    &timestamp=1733428634
    &key=YOUR_API_KEY

แหล่งข้อมูล

ตารางต่อไปนี้สรุปทรัพยากรที่มีผ่าน TimeZone API พร้อมกับข้อมูลที่แสดง

แหล่งข้อมูล ข้อมูลที่ส่งคืน รูปแบบการแสดงผล
เขตเวลา

คุณระบุคำขอพร้อมตำแหน่งและการประทับเวลา ดูพารามิเตอร์ที่จําเป็น

  • รหัสเขตเวลา
  • ชื่อเขตเวลา (แปลหรือไม่ก็ได้)
  • ค่าออฟเซ็ตจาก UTC เป็นวินาที
  • ออฟเซ็ตสำหรับเวลาออมแสงเป็นวินาที
  • โปรดดูตัวอย่างคำตอบในเขตเวลา
  • JSON
  • XML

วิธีใช้ Time Zone API

1 เริ่มตั้งค่า เริ่มต้นด้วยตั้งค่าโปรเจ็กต์ Google Cloud แล้วทําตามวิธีการตั้งค่าที่ระบุไว้
2 ลองใช้คำขอเขตเวลา เมื่อมีคีย์ API แล้ว คุณสามารถเริ่มทดสอบ Time Zone API ได้โดยตรงจากเบราว์เซอร์ ดูรายละเอียดได้ในตัวอย่างเขตเวลาในคู่มือคำขอและคำตอบเกี่ยวกับเขตเวลา
3 ทำความเข้าใจพื้นฐานคำตอบ สำรวจวิธีใช้ข้อมูลเขตเวลาในแอปหรือเว็บไซต์ ดูรายละเอียดได้ในคำตอบเกี่ยวกับเขตเวลา
5 รวมข้อมูลเขตเวลาไว้ในแอปของคุณเอง คุณสามารถใช้ข้อมูลเขตเวลาเพื่อปรับปรุงแอปและเว็บไซต์สำหรับผู้ใช้ในภาษาต่างๆ ตามเขตเวลา

ไลบรารีของไคลเอ็นต์ที่ใช้ได้

เรียกใช้ API นี้ในภาษาที่ต้องการผ่านไลบรารีของไคลเอ็นต์อย่างใดอย่างหนึ่งต่อไปนี้

ไคลเอ็นต์ Java, ไคลเอ็นต์ Python, ไคลเอ็นต์ Go และไคลเอ็นต์ Node.js สำหรับบริการของ Google Maps เป็นไลบรารีของไคลเอ็นต์ที่ชุมชนสนับสนุนและเป็นโอเพนซอร์สภายใต้สัญญาอนุญาต Apache 2.0 ดาวน์โหลดได้จาก GitHub ซึ่งคุณจะดูวิธีการติดตั้งและโค้ดตัวอย่างได้ด้วย

ขั้นตอนถัดไป