Bắt đầu

API Múi giờ cung cấp dữ liệu về độ lệch thời gian cho các vị trí trên bề mặt Trái Đất. Yêu cầu thông tin về múi giờ cho một cặp vĩ độ và kinh độ cụ thể cũng như ngày. API này trả về tên của múi giờ đó, độ lệch thời gian so với giờ UTC và độ lệch giờ mùa hè.

Yêu cầu và phản hồi mẫu

Truy cập vào Time Zone API thông qua giao diện HTTPS, trong đó các yêu cầu được tạo dưới dạng chuỗi URL, sử dụng toạ độ vĩ độ và kinh độ để chỉ định location, timestamp để chỉ định ngày và khoá API của bạn.

Truy vấn sau đây thực hiện yêu cầu về múi giờ cho Nevada, Hoa Kỳ. Dấu thời gian được đặt thành ngày 8 tháng 3 năm 2012.

URL

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

curl

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

Bạn có thể kiểm tra yêu cầu này bằng cách nhập URL vào trình duyệt web. Hãy nhớ thay thế YOUR_API_KEY bằng khoá API thực tế của bạn. Phản hồi bao gồm dữ liệu múi giờ cho vị trí và ngày được chỉ định (timestamp).

Để biết thêm thông tin về cách tạo URL yêu cầu và các tham số có sẵn cũng như tìm hiểu về phản hồi, hãy xem hướng dẫn dành cho nhà phát triển.

Mẫu sau đây cho thấy một phản hồi ở định dạng JSON:

JSON

{
  "dstOffset": 0,
  "rawOffset": -28800,
  "status": "OK",
  "timeZoneId": "America/Los_Angeles",
  "timeZoneName": "Pacific Standard Time",
}

XML

<TimeZoneResponse>
 <status>OK</status>
 <raw_offset>-28800.0000000</raw_offset>
 <dst_offset>0.0000000</dst_offset>
 <time_zone_id>America/Los_Angeles</time_zone_id>
 <time_zone_name>Pacific Standard Time</time_zone_name>
</TimeZoneResponse>

Bắt đầu lập trình bằng thư viện ứng dụng

Thư viện ứng dụng đơn giản hoá việc phát triển bằng các API dịch vụ web của Google Maps bằng cách cung cấp các phương thức triển khai đơn giản, tích hợp sẵn cho các tác vụ phổ biến như xác thực, điều tiết yêu cầu và tự động thử lại. API Múi giờ có trong Ứng dụng Java, Ứng dụng Python, Ứng dụng Go và Ứng dụng Node.js cho Dịch vụ Google Maps.

Xác thực, hạn mức, giá và chính sách

Xác thực

Để sử dụng Time Zone API, trước tiên, bạn phải bật API này và lấy thông tin xác thực phù hợp. Để biết thêm thông tin, hãy xem bài viết Bắt đầu sử dụng Google Maps Platform.

Hạn mức và giá

Để biết thông tin chi tiết về hạn mức và giá được đặt cho Time Zone API, hãy xem phần Mức sử dụng và thanh toán.

Chính sách

Việc sử dụng API múi giờ phải tuân thủ chính sách về API.

Tìm hiểu thêm

Trong Time Zone API, bạn cũng có thể đặt tham số ngôn ngữ để trả về kết quả bằng các ngôn ngữ khác ngoài tiếng Anh mặc định. Hãy xem Hướng dẫn cho nhà phát triển về Time Zone API để biết thêm ví dụ và thông tin chi tiết khác.

Hướng dẫn dành cho nhà phát triển về Time Zone API giúp nhà phát triển trang web và thiết bị di động đưa dữ liệu thời gian vào bản đồ do một trong các API của Nền tảng Google Maps cung cấp. Tài liệu này giới thiệu cách sử dụng API và tài liệu tham khảo về các tham số có sẵn.