Time Zone API 개요
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Time Zone API는 위도/경도 좌표 및 선택한 날짜와 시간의 HTTP 요청을 수락하는 서비스입니다. 이 함수는 시간을 반환합니다.
UTC 오프셋 및 일광 절약 시간을 포함한 위치의 시간대 데이터
있습니다.
Time Zone API를 사용하는 이유
Time Zone API를 사용하면 지도의 특정 위치에 대한 날짜 및 시간의 시간대 ID와 이름을 제공하는 애플리케이션을 개발할 수 있습니다. 예를 들어 다음과 같은 시간대 데이터를 표시할 수 있습니다.
- Google Maps Platform의 지도 위치에 대한 현지화된 시간대 이름입니다.
- UTC 및 일광 절약 시간의 시간대 오프셋입니다.
시간대 데이터는
사용자와 관련된 시간 기반 데이터를 표시할 수 있습니다.
Time Zone API로 할 수 있는 작업
Time Zone API를 사용하면 지구 표면의 위치에 대한 시간대와 UTC와의 시간 오프셋, 각 위치의 일광 절약 시간을 요청할 수 있습니다.
Time Zone API 작동 방식
Time Zone API는 위도/경도 좌표의 HTTPS 요청, 원하는 날짜 및 시간을 타임스탬프로, 원하는 경우 언어 코드를 수락합니다. 요청에 지정된 형식으로 데이터를 반환합니다.
다음 예는 미국 네바다에 대한 요청과 요청된 출력(JSON)을 보여줍니다.
https://maps.googleapis.com/maps/api/timezone/json
?location=39.6034810%2C-119.6822510
×tamp=1733428634
&key=YOUR_API_KEY
리소스
다음 표에는 Time Zone API를 통해 사용할 수 있는 리소스와 반환되는 데이터가 요약되어 있습니다.
| 데이터 리소스 |
반환된 데이터 |
반환 형식 |
| 시간대
위치 및 타임스탬프와 함께 요청을 제공합니다. 필수 매개변수를 참고하세요.
|
- 시간대 ID입니다.
- 시간대 이름(현지화일 경우)
- UTC와의 오프셋(단위: 초)
- 일광 절약 시간 오프셋(단위: 초)
- 구체적인 응답 예는 시간대를 참조하세요.
|
|
Time Zone API 사용 방법
| 1 |
설정하기 |
Google Cloud 프로젝트 설정하기부터 시작하여 다음의 설정 안내를 완료합니다. |
| 2 |
시간대 요청 사용해 보기 |
API 키가 있으면 브라우저에서 바로 Time Zone API 테스트를 시작할 수 있습니다. 시간대 예를 참고하세요.
시간대 요청 및 응답 가이드를 참고하세요.
|
| 3 |
응답 기본사항 이해하기 |
앱 또는 웹사이트에서 시간대 데이터를 사용하는 방법을 살펴보세요.
시간대 응답 보기
참조하세요.
|
| 5 |
시간대 데이터를 자체 앱에 통합하세요. |
시간대 데이터를 사용하여 다양한 시간 기반 언어의 사용자를 위해 앱과 웹사이트를 개선할 수 있습니다.
|
사용 가능한 클라이언트 라이브러리
이 API를 다음 언어로 호출하세요.
다음 클라이언트 라이브러리 중 하나를 통해 사용할 수 있습니다.
Google 지도 서비스용 Java Client, Python Client, Go Client, Node.js Client는 커뮤니티 지원 클라이언트 라이브러리로, Apache 2.0 라이선스에 따라 오픈 소스로 제공됩니다.
GitHub에서 다운로드하세요. GitHub에서 설치 안내와 샘플 코드도 찾을 수 있습니다.
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[[["\u003cp\u003eThe Time Zone API provides time zone data, including UTC and daylight savings offsets, for specific locations based on latitude/longitude and timestamp.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the API to display localized time zone names, offsets, and enhance time-based data in your applications.\u003c/p\u003e\n"],["\u003cp\u003eThe API accepts HTTPS requests with location and timestamp parameters and returns data in JSON or XML format.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries are available in Java, Python, Go, and Node.js for easy integration into your projects.\u003c/p\u003e\n"]]],["The Time Zone API retrieves time zone data for specific locations using latitude/longitude coordinates and a timestamp. It returns the time zone ID, localized name, UTC offset, and daylight saving time offset in JSON or XML format. To use it, you send an HTTPS request with location and timestamp and you can then utilize the data in your website or apps to show time-based information relevant to users' locations. You can also use one of the provided client libraries to access the API.\n"],null,["# Time Zone API overview\n\nThe Time Zone API is a service that accepts an HTTP request of\nlatitude/longitude coordinates and a chosen date and time. It returns the time\nzone data for the location, including offsets for UTC and daylight savings\ntime.\n\nWhy use the Time Zone API\n-------------------------\n\nWith the Time Zone API, you can develop applications that provide\nthe time zone ID and name for dates and times at specific locations\non a map. For example, you can show the following\ntime zone data:\n\n- Localized time zone names for map locations from the Google Maps Platform.\n- Time zone offsets from UTC and for daylight savings.\n\nTime zone data can be particularly useful when you want to have your\nwebsite or app display time-based data relevant to your users.\n\nWhat you can do with the Time Zone API\n--------------------------------------\n\nWith the Time Zone API, you can request the time zone for\nlocations on the surface of the earth, with the time offset from\nUTC and for daylight savings time for each of\nthose locations.\n\nHow the Time Zone API works\n---------------------------\n\nThe Time Zone API accepts an HTTPS request of latitude/longitude\ncoordinates, the desired date and time as a timestamp, and optionally,\na language code. It returns data in the format specified by the request.\nThe following example shows a request for\nNevada, USA, with a requested output in JSON. \n\n```scdoc\n https://maps.googleapis.com/maps/api/timezone/json\n ?location=39.6034810%2C-119.6822510\n ×tamp=1733428634\n &key=YOUR_API_KEY\n \n```\n\n### Resources\n\nThe following table summarizes the resources available through the\nTime Zone API along with the data it returns.\n\n| Data resources | Data returned | Return format |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|\n| **Timezone** You provide your request along with location and timestamp. See [required parameters](/maps/documentation/timezone/requests-timezone#required-parameters). | - Time zone ID. - Time zone name, optionally localized - Offset from UTC, in seconds - Offset for DST, in seconds - See Time Zone for specific response examples. | - JSON - XML |\n\nHow to use the Time Zone API\n----------------------------\n\n|---|--------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/elevation/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Try a timezone request** | Once you have an API key, you can start testing out the Time Zone API directly from your browser. See [Time Zone examples](/maps/documentation/timezone/requests-timezone#examples) in the Timezone requests and responses guide for details. |\n| 3 | **Understand response basics** | Explore how to use timezone data in your app or website. See [Time Zone responses](/maps/documentation/timezone/requests-timezone#responses) for details. |\n| 5 | **Incorporate timezone data into your own app!** | You can use timezone data to enhance apps and websites for users across different time-based locales. |\n\n### Available client libraries\n\nCall this API in the language of\nyour choice through one of the following client libraries:\n\n- [Java\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client\n for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nThe Java Client, Python Client, Go Client and Node.js Client for Google Maps\nServices are community-supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\nDownload them from GitHub, where you can also find installation instructions and sample code.\n\nWhat's next\n-----------\n\n- **Learn how to make Time Zone requests** : Go to [Time Zone Requests and responses](/maps/documentation/timezone/requests-timezone).\n- **Follow best practices** : Go to [Web Services Best Practices](/maps/documentation/timezone/web-service-best-practices)."]]
