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

리소스

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

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

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

  • 시간대 ID입니다.
  • 시간대 이름(현지화일 경우)
  • UTC와의 오프셋(단위: 초)
  • 일광 절약 시간 오프셋(단위: 초)
  • 구체적인 응답 예는 시간대를 참조하세요.
  • 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에서 설치 안내와 샘플 코드도 찾을 수 있습니다.

다음 단계