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

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

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

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

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

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

คุณใช้ Time Zone API ทำอะไรได้บ้าง

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

วิธีการทำงานของ Time Zone API

API เขตเวลาจะยอมรับคำขอ HTTPS ของพิกัดละติจูด/ลองจิจูด วันที่และเวลาที่ต้องการเป็นการประทับเวลา และรหัสภาษา (ไม่บังคับ) โดยจะแสดงข้อมูลในรูปแบบที่คำขอระบุ ตัวอย่างต่อไปนี้แสดงคำขอสำหรับรัฐเนวาดา สหรัฐอเมริกา โดยมีเอาต์พุตที่ขอเป็น JSON

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

แหล่งข้อมูล

ตารางต่อไปนี้สรุปทรัพยากรที่พร้อมใช้งานผ่าน Time Zone API พร้อมด้วยข้อมูลที่ส่งมา

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

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

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

วิธีใช้ Time Zone API

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

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

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

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

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