
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=1331161200 &key=YOUR_API_KEY
자료
다음 표에는 Time Zone API를 통해 사용할 수 있는 리소스와 리소스가 반환되는 데이터가 요약되어 있습니다.
데이터 리소스 | 데이터 반환됨 | 반환 형식 |
---|---|---|
시간대
위치 및 타임스탬프와 함께 요청을 제공합니다. 필수 매개변수를 참고하세요. |
|
|
Time Zone API 사용 방법
1 | 설정하기 | Google Cloud 프로젝트 설정부터 시작하여 설정 안내를 완료합니다. |
2 | 시간대 요청 시도 | API 키가 있으면 브라우저에서 직접 시간대 API를 테스트할 수 있습니다. 자세한 내용은 시간대 요청 및 응답 가이드의 시간대 예를 참고하세요. |
3 | 응답 기본사항 이해하기 | 앱 또는 웹사이트에서 시간대 데이터를 사용하는 방법을 알아보세요. 자세한 내용은 시간대 응답을 참고하세요. |
5 | 앱에 시간대 데이터를 통합합니다. | 시간대 데이터를 사용하면 여러 시간 기반 언어의 사용자를 위해 앱과 웹사이트를 개선할 수 있습니다. |
사용 가능한 클라이언트 라이브러리
다음 클라이언트 라이브러리 중 하나를 통해 원하는 언어로 이 API를 호출합니다.
- Google 지도 서비스용 자바 클라이언트
- Google 지도 서비스용 Python 클라이언트
- Google 지도 서비스용 Go 클라이언트
- Google 지도 서비스용 Node.js 클라이언트
Google 지도 서비스용 자바 클라이언트, Python 클라이언트, Go 클라이언트, Node.js 클라이언트는 Apache 2.0 라이선스에 따라 오픈소스로 제공되는 클라이언트 지원 클라이언트 라이브러리입니다. GitHub에서 다운로드합니다. 여기에는 설치 안내 및 샘플 코드도 포함되어 있습니다.
다음 단계
- 시간대 요청 방법 알아보기: 시간대 요청 및 응답으로 이동하세요.
- 권장사항 따르기: 웹 서비스 권장사항으로 이동하세요.