ภาพรวมเขตเวลาของ API

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

เหตุใดจึงใช้ Time Zone API

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

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

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

สิ่งที่คุณทําได้ด้วย Time Zone API

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

วิธีการทํางานของ API เขตเวลา

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

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

แหล่งข้อมูล

ตารางต่อไปนี้จะสรุปทรัพยากรที่พร้อมใช้งานผ่านเขตเวลาในเขตเวลา พร้อมด้วยข้อมูลที่แสดงผล

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

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

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

วิธีใช้ Time Zone API

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

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

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

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

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