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 키가 있으면 브라우저에서 바로 Time Zone API 테스트를 시작할 수 있습니다. 자세한 내용은 시간대 요청 및 응답 가이드의 시간대 예시를 참고하세요.
3 응답 기본사항 이해하기 앱 또는 웹사이트에서 시간대 데이터를 사용하는 방법을 알아보세요. 자세한 내용은 시간대 응답 을 참고하세요.
5 시간대 데이터를 자체 앱에 통합하세요. 시간대 데이터를 사용하여 다양한 시간 기반 언어를 사용하는 사용자를 위해 앱과 웹사이트를 개선할 수 있습니다.

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

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

Google 지도 서비스용 Java Client, Python Client, Go Client, Node.js Client는 커뮤니티에서 지원하는 클라이언트 라이브러리로, Apache 2.0 라이선스에 따라 오픈소스로 제공됩니다. GitHub에서 다운로드하세요. GitHub에서 설치 안내와 샘플 코드도 확인할 수 있습니다.

다음 단계