Stay organized with collections Save and categorize content based on your preferences.
Before you begin: Before you start using the Time Zone API, you need a project with a billing account and the Time Zone API enabled. We recommend creating multiple Project Owners and Billing Administrators, so that you'll always have someone with these roles available to your team. To learn more, see Set up in Cloud console.The Time Zone API provides time offset data for locations on the surface of the earth. Request the time zone information for a specific latitude/longitude pair and date. The API returns the name of that time zone, the time offset from UTC, and the daylight savings offset.
Sample request and responseAccess the Time Zone API through an HTTPS interface, with requests constructed as a URL string, using latitude/longitude coordinates to specify the location, a timestamp to specify the date, and your API key.
The below query performs a time zone request for Nevada, USA. The timestamp is set to March 8th, 2012.
URLhttps://maps.googleapis.com/maps/api/timezone/json ?location=39.6034810%2C-119.6822510 ×tamp=1733428634 &key=YOUR_API_KEYcURL
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1733428634&key=YOUR_API_KEY'
You can test this by entering the URL into your web browser (be sure to replace YOUR_API_KEY with your actual API key). The response includes the time zone data for the specified location and date (timestamp).
View the developer's guide for more information about building request URLs and available parameters and understanding the response.
Below is a sample response, in 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>Start coding with our client libraries
Client libraries make developing with the Google Maps web service APIs easier by providing simple, native implementations of common tasks such as authentication, request throttling and automatic retry. The Time Zone API is available in the Java Client, Python Client, Go Client and Node.js Client for Google Maps Services.
Authentication, quotas, pricing, and policies AuthenticationTo use the Time Zone API, you must first enable the API and obtain the proper authentication credentials. For more information, see Get Started with Google Maps Platform.
Quotas and pricingReview the usage and billing page for details on the quotas and pricing set for the Time Zone API.
PoliciesUse of the Time Zone API must be in accordance with the API policies.
Learn moreIn the Time Zone API, you can also set a language parameter to return results in languages other than the default of English. See the Time Zone API Developer Guide for more examples and other details.
The Time Zone API Developer Guide is intended for website and mobile developers who want to include time data on maps provided by one of the Google Maps Platform APIs. It provides an introduction to using the API and reference material on the available parameters.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-14 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-14 UTC."],[[["The Time Zone API provides time offset data for locations on Earth based on latitude/longitude and date, returning the time zone name, UTC offset, and daylight savings offset."],["To use the API, you need a Google Cloud project with billing enabled and the Time Zone API enabled, along with an API key for authentication."],["You can access the API through HTTPS using a URL with parameters for location, timestamp, and your API key."],["Client libraries are available in Java, Python, Go, and Node.js to simplify development with the Time Zone API."],["Usage of the Time Zone API is subject to quotas, pricing, and policies outlined in the documentation."]]],["The Time Zone API provides time offset data for specific locations and dates. Access it via HTTPS, constructing URLs with latitude/longitude (`location`), date (`timestamp`), and your API key. The API returns the time zone name, UTC offset, and daylight savings offset. Client libraries in Java, Python, Go, and Node.js simplify integration. Using the API requires enabling it, getting authentication credentials, understanding quotas, pricing, and adhering to API policies. Additional information can be found on the developer's guide.\n"]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4