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

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

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ị dữ liệu múi giờ sau đây:

  • 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 mà yêu cầu chỉ định. Ví dụ sau đây cho thấy một yêu cầu đối với 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=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ùng với vị trí và dấu thời gian. Xem các thông số bắt buộc.

  • 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
  • Mức chênh lệch cho DST, 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 Google Cloud và hoàn thành hướng dẫn thiết lập sau đó.
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 API Múi giờ ngay trên trình duyệt. 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 kiến thức cơ bản về phản hồ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. Hãy xem phần Phản hồi về 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ờ để nâng cao ứ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 này xuống từ GitHub. Tại đây, 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