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ờ mong muố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è thời gian.

Lý do bạn nên sử dụng API Múi giờ

Với API múi giờ, bạn có thể phát triển các ứng dụng cung cấp mã múi giờ và tên 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 giờ UTC và để tiết kiệm ánh sáng ngày.

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 có liên quan đến người dùng của bạn.

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 vị trí trên bề mặt trái đất, với chênh lệch thời gian từ UTC và giờ tiết kiệm ánh sáng ngày cho mỗi các 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ề vĩ độ/kinh độ toạ độ, ngày và giờ mong muốn dưới dạng dấu thời gian và (không bắt buộc) 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 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 Time Zone API (API múi giờ) cùng với dữ liệu được 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ờ, không bắt buộc phải 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
  • Xem Múi giờ để biết các ví dụ cụ thể cho câu trả lờ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. 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 của 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 các ứng dụng và trang web cho người dùng trên ngôn ngữ dựa trên thời gian khác nhau.

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

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

Ứng dụng Java, Ứng dụng Python, Ứng dụng Go và Ứng dụng Node.js cho Google Maps Các dịch vụ là thư viện ứng dụng được 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