Bắt đầu

Time Zone API cung cấp dữ liệu về chênh lệch thời gian cho các vị trí trên giao diện của trái đất. Yêu cầu thông tin múi giờ cho cặp và ngày vĩ độ/kinh độ cụ thể. API 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 API Múi giờ thông qua giao diện HTTPS bằng các yêu cầu được tạo dưới dạng một chuỗi URL, sử dụng toạ độ vĩ độ/kinh độ để chỉ định location, timestamp để chỉ định ngày, và khoá API của bạn.

Truy vấn bên dưới thực hiện yêu cầu về múi giờ cho Nevada, Hoa Kỳ. Dấu thời gian được thiết lập là 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=1331161200
  &key=YOUR_API_KEY

cURL

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

Bạn có thể kiểm tra URL 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).

Xem hướng dẫn dành cho nhà phát triển để biết thêm thông tin về tạo URL yêu cầu và các tham số có sẵn và hiểu câu trả lời.

Dưới đây là phản hồi mẫu, trong 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 các thư viện ứng dụng của chúng tôi

Thư viện ứng dụng giúp việc phát triển bằng API dịch vụ web của Google Maps dễ dàng hơn bằng cách cung cấp cách triển khai gốc của các tác vụ phổ biến như xác thực, yêu cầu điều tiết và tự động thử lại. Có thể sử dụng API Múi giờ trong Ứng dụng Java, Ứng dụng Python, Go Client 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 API múi giờ, trước tiên bạn phải bật API và có được giấy uỷ nhiệm xác thực. Để biết thêm thông tin, hãy xem Bắt đầu sử dụng Nền tảng Google Maps.

Hạn mức và giá

Xem lại trang mức sử dụng và thanh toán để biết chi tiết về hạn mức và mức giá được thiết lập cho API múi giờ.

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 API Múi giờ, bạn cũng có thể đặt thông số ngôn ngữ để trả về kết quả bằng các ngôn ngữ khác với ngôn ngữ mặc định là tiếng Anh. Xem API múi giờ Hướng dẫn cho nhà phát triển để xem thêm ví dụ và thông tin chi tiết.

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