Bắt đầu

Time Zone API cung cấp dữ liệu chênh 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ĩ độ/kinh độ và ngày cụ thể. API trả về tên của múi giờ đó, độ lệch thời gian so với UTC và độ lệch thời gian theo giờ mùa hè.

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

Truy cập vào API Múi giờ thông qua giao diện HTTPS, với các yêu cầu được tạo dưới dạng 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 đặ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 thử điều này bằng cách nhập URL vào trình duyệt web (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ề cách tạo URL yêu cầu và các thông số có sẵn cũng như tìm hiểu phản hồi.

Dưới đây là phản hồi mẫu, ở đị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 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 trở nên dễ dàng hơn bằng cách cung cấp các phương thức triển khai gốc đơn giản cho các tác vụ phổ biến như xác thực, điều tiết yêu cầu và thử lại tự động. API Múi giờ có sẵn 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 API Múi giờ, trước tiên, bạn phải bật API và lấy thông tin xác thực thích 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á

Xem trang hạn mức sử dụng và thanh toán để biết thông tin chi tiết về hạn mức và mức giá được đặt 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 tham 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. Hãy xem Hướng dẫn dành cho nhà phát triển về API múi giờ để 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ề API Múi giờ dành cho các nhà phát triển trang web và nhà phát triển ứng dụng di động muốn đư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 cung cấp thông tin giới thiệu về cách sử dụng API và tài liệu tham khảo về các tham số có sẵn.