Tổng quan về API múi giờ

Time Zone API là một dịch vụ chấp nhận yêu cầu HTTP về toạ độ vĩ độ/kinh độ cũng như ngày và giờ đã chọn. API này trả về dữ liệu múi giờ cho vị trí, bao gồm cả độ lệch so với giờ UTC và giờ mùa hè.

Lý do nên sử dụng Time Zone API

Với Time Zone API, bạn có thể phát triển các ứng dụng cung cấp mã nhận dạng và tên múi giờ cho ngày và giờ tại các vị trí cụ thể trên bản đồ. Ví dụ: bạn có thể hiển thị dữ liệu múi giờ sau:

  • Tên múi giờ được bản địa hoá cho các vị trí trên bản đồ từ Google Maps Platform.
  • Chênh lệch múi giờ so với giờ UTC và giờ mùa hè.

Dữ liệu múi giờ đặc biệt hữu ích khi bạn muốn trang web hoặc ứng dụng của mình hiển thị dữ liệu theo thời gian phù hợp với những người dùng ứng dụng của bạn.

Những việc bạn có thể làm với Time Zone API

Với Time Zone API, bạn có thể yêu cầu múi giờ cho các vị trí trên bề mặt Trái Đất, với độ lệch thời gian so với giờ UTC và giờ mùa hè cho từng vị trí đó.

Cách hoạt động của Time Zone API

Time Zone API chấp nhận yêu cầu HTTPS về toạ độ vĩ độ và kinh độ, ngày và giờ đã chọn dưới dạng dấu thời gian và mã ngôn ngữ (không bắt buộc). Hàm này trả về dữ liệu theo định dạng được chỉ định trong yêu cầu. Ví dụ sau đây cho thấy một yêu cầu cho Nevada, Hoa Kỳ, với kết quả được yêu cầu ở định dạng JSON:

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

Tài nguyên

Bảng sau đây tóm tắt các tài nguyên có sẵn thông qua Time Zone API cùng với dữ liệu mà API này trả về:

Tài nguyên dữ liệu Dữ liệu được trả về Định dạng trả về
Múi giờ

Bạn cung cấp yêu cầu cùng với vị trí và dấu thời gian. Xem các tham số bắt buộc.

  • Mã múi giờ.
  • Tên múi giờ, có thể được bản địa hoá.
  • Độ lệch so với giờ UTC, tính bằng giây.
  • Thời gian chênh lệch cho giờ mùa hè, tính bằng giây.
  • Hãy xem phần Múi giờ để biết các ví dụ cụ thể về phản hồi.
  • JSON
  • XML

Cách sử dụng Time Zone API

1 Thiết lập Bắt đầu bằng cách Thiết lập dự án trên đám mây của Google và hoàn tất hướng dẫn thiết lập sau đây.
2 Thử yêu cầu về múi giờ Sau khi có khoá API, bạn có thể bắt đầu kiểm thử Time Zone API ngay trên trình duyệt. Hãy xem ví dụ về Múi giờ trong hướng dẫn về Yêu cầu và phản hồi về múi giờ để biết thông tin chi tiết.
3 Tìm hiểu kiến thức cơ bản về phản hồi Tìm hiểu cách sử dụng dữ liệu múi giờ trong ứng dụng hoặc trang web của bạn. Hãy xem phần Phản hồi về múi giờ để biết thông tin chi tiết.
5 Kết hợp dữ liệu múi giờ vào ứng dụng của riêng bạn! Bạn có thể sử dụng dữ liệu múi giờ để cải thiện ứng dụng và trang web trên nhiều ngôn ngữ dựa trên thời gian.

Thư viện ứng dụng hiện có

Gọi API này bằng ngôn ngữ bạn chọn thông qua một trong các thư viện ứng dụng sau:

Ứng dụng Java, Ứng dụng Python, Ứng dụng Go và Ứng dụng Node.js cho Dịch vụ Google Maps là các thư viện ứng dụng được cộng đồng hỗ trợ, có nguồn mở theo Giấy phép Apache 2.0. Tải các thư viện này xuống từ GitHub, nơi bạn cũng có thể tìm thấy hướng dẫn cài đặt và mã mẫu.

Bước tiếp theo