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

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

Lý do sử dụng API Múi giờ

Với Time Zone API, bạn có thể phát triển các ứng dụng cung cấp tên và mã 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ị như sau dữ liệu múi giờ:

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

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

Những việc bạn có thể làm với API Múi giờ

Với API Múi giờ, 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 giờ so với UTC và giờ mùa hè cho từng vị trí đó.

Cách hoạt động của API Múi giờ

API Múi giờ chấp nhận yêu cầu HTTPS về toạ độ vĩ độ/kinh độ, ngày và giờ mong muốn dưới dạng dấu thời gian và tuỳ ý là mã ngôn ngữ. Phương thức này trả về dữ liệu ở định dạng do yêu cầu chỉ định. Ví dụ sau đây minh hoạ yêu cầu cho Nevada, Hoa Kỳ, với đầu ra được yêu cầu ở định dạng JSON.

 https://maps.googleapis.com/maps/api/timezone/json
    ?location=39.6034810%2C-119.6822510
    &timestamp=1331161200
    &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 API Múi giờ 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ủa mình cùng với vị trí và dấu thời gian. Xem bắt buộc tham số.

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

Cách sử dụng API Múi giờ

1 Thiết lập Hãy bắt đầu bằng việc Thiết lập Dự án trên Google Cloud và hoàn tất quá trình thiết lập tiếp theo.
2 Thử yêu cầu về múi giờ Sau khi có khoá API, bạn có thể bắt đầu thử nghiệm Time Zone API ngay từ trình duyệt của bạn. Hãy xem Ví dụ về múi giờ trong hướng dẫn 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 thông tin cơ bản về câu trả lời Khám phá cách sử dụng dữ liệu múi giờ trong ứng dụng hoặc trang web của bạn. Xem Phản hồi theo múi giờ để biết thông tin chi tiết.
5 Tích 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 cho người dùng ở nhiều ngôn ngữ dựa trên múi giờ.

Các 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ụ Maps của Google là các thư viện ứng dụng do cộng đồng hỗ trợ, nguồn mở theo Giấy phép Apache 2.0. Tải các tệp đó 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.

Các bước tiếp theo