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
    &timestamp=1331161200
    &key=YOUR_API_KEY

자료

다음 표에는 Time Zone API를 통해 사용할 수 있는 리소스와 리소스가 반환되는 데이터가 요약되어 있습니다.

데이터 리소스 데이터 반환됨 반환 형식
시간대

위치 및 타임스탬프와 함께 요청을 제공합니다. 필수 매개변수를 참고하세요.

  • 시간대 ID
  • 시간대 이름(선택사항)
  • UTC와의 오프셋(초)
  • DST의 초 단위 오프셋
  • 특정 응답 예시는 시간대를 참조하세요.
  • JSON
  • XML

Time Zone API 사용 방법

1 설정하기 Google Cloud 프로젝트 설정부터 시작하여 설정 안내를 완료합니다.
2 시간대 요청 시도 API 키가 있으면 브라우저에서 직접 시간대 API를 테스트할 수 있습니다. 자세한 내용은 시간대 요청 및 응답 가이드의 시간대 예를 참고하세요.
3 응답 기본사항 이해하기 앱 또는 웹사이트에서 시간대 데이터를 사용하는 방법을 알아보세요. 자세한 내용은 시간대 응답을 참고하세요.
5 앱에 시간대 데이터를 통합합니다. 시간대 데이터를 사용하면 여러 시간 기반 언어의 사용자를 위해 앱과 웹사이트를 개선할 수 있습니다.

사용 가능한 클라이언트 라이브러리

다음 클라이언트 라이브러리 중 하나를 통해 원하는 언어로 이 API를 호출합니다.

Google 지도 서비스용 자바 클라이언트, Python 클라이언트, Go 클라이언트, Node.js 클라이언트는 Apache 2.0 라이선스에 따라 오픈소스로 제공되는 클라이언트 지원 클라이언트 라이브러리입니다. GitHub에서 다운로드합니다. 여기에는 설치 안내 및 샘플 코드도 포함되어 있습니다.

다음 단계