Time Zone API 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ĩ độ/kinh độ và ngày cụ thể. 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, với các yêu cầu được tạo thành 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 một 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 ×tamp=1733428634 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1733428634&key=YOUR_API_KEY'
Bạn có thể kiểm thử 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 tham số có sẵn cũng như cách hiểu phản hồi.
Dưới đây là một 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 bạn phát triển dễ dàng hơn với các API dịch vụ web của Google Maps bằng cách cung cấp các triển khai đơn giản, gốc 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. Time Zone API 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á
Xem trang 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 Time Zone API.
Chính sách
Bạn phải sử dụng Time Zone API theo các chính sách về API.
Tìm hiểu thêm
Trong Time Zone API, bạn cũng có thể đặt mộ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 (ngôn ngữ mặc định). Hãy xem Hướng dẫn cho nhà phát triển 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 Time Zone API dành cho những nhà phát triển trang web và thiết bị di động muốn đưa dữ liệu thời gian vào bản đồ do một trong các API của Google Maps Platform 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.