모든 준비를 마쳤습니다!

개발을 시작하려면 개발자 문서로 이동하세요.

Google Maps Time Zone API 활성화

개발을 시작하기 위해 Google Developers Console에서 우선적으로 해야 할 일을 몇 가지 소개하겠습니다.

  1. 프로젝트 생성 또는 선택
  2. Google Maps Time Zone API 활성화
  3. 적합한 키 생성
계속

개발자 가이드

Google Maps Time Zone API는 지구상의 한 위치에 대한 시간대를 요청하고 이 위치와 UTC의 간의 시간 오프셋을 요청하는 간단한 인터페이스입니다.

이 서비스는 Java Client, Python Client, Go Client 및 Node.js Client for Google Maps Services에서도 사용할 수 있습니다.

이 문서는 Google Maps API 중 하나에서 제공하는 지도에 시간대 데이터를 포함하기를 원하는 웹사이트 및 모바일 개발자를 위한 것입니다. 이 문서에서는 API 사용 방법과 사용 가능한 매개변수에 대한 참조 자료를 소개합니다.

소개

Google Maps Time Zone API는 지표면의 위치에 대한 시간 오프셋 데이터를 제공합니다. 특정 위도/경도 쌍 및 날짜에 대한 시간대 정보를 요청합니다. API가 해당 시간대 이름, UTC 시간 오프셋 및 일광 절약 시간 오프셋을 반환합니다.

HTTPS 인터페이스를 통해 Google Maps Time Zone API에 액세스할 수 있습니다.

Time Zone API 개발을 시작하기 전에 인증 요구사항(API 키 필요) 및 API 사용 제한을 검토하세요.

시간대 요청

Google Maps Time Zone API 요청은 URL 문자열로 구성됩니다. 이 API는 위도/경도 쌍으로 지정된 지구상의 한 지점에 대한 시간대 데이터를 반환합니다. 참고로, 대양 또는 바다와 같은 물 위의 위치에는 시간대 데이터를 사용할 수 없습니다.

Google Maps Time Zone API 요청의 형식은 다음과 같습니다.

https://maps.googleapis.com/maps/api/timezone/outputFormat?parameters

여기서 outputFormat은 다음 값 중 하나일 수 있습니다.

  • json(권장): JSON(JavaScript Object Notation) 형식으로 출력을 나타냅니다.
  • xml: <TimeZoneResponse> 노드 내에 래핑된 XML 형식으로 출력을 나타냅니다.

중요: http가 아니라 https를 통해 요청을 제출해야 합니다.

참고: URL은 유효하도록 적절하게 인코딩해야 하며 모든 웹 서비스에 대해 8192자로 제한됩니다. URL을 구성할 때 이 제한을 알아야 합니다. 참고로 브라우저, 프록시 및 서버가 다르면 URL 문자 제한도 다를 수 있습니다.

요청 매개변수

모든 URL 표준 형식과 마찬가지로, 매개변수는 앰퍼샌드(&) 문자를 사용하여 구분합니다. 매개변수 및 가능한 값 목록은 아래와 같습니다.

필수 매개변수

  • location: 쉼표로 구분된 위도,경도 쌍(예: location=-33.86,151.20)이며, 검색할 위치를 나타냅니다.
  • timestamp는 1970년 1월 1일 자정(UTC) 이후 원하는 시간을 초 단위로 지정합니다. Google Maps Time Zone API는 timestamp를 사용하여 일광 절약 시간의 적용 여부를 결정합니다. 1970 이전의 시간은 음수 값으로 표현될 수 있습니다.
  • key — 애플리케이션의 API 키. 이 키는 할당량 관리를 위해 애플리케이션을 식별합니다. 키 가져오기 방법에 대해 알아봅니다.

    참고: Google Maps API 프리미엄 플랜 고객은 Time Zone 요청에서 API 키를 사용하거나 유효한 클라이언트 ID와 디지털 서명을 사용할 수 있습니다. 자세한 내용은 프리미엄 플랜 고객의 인증 매개변수를 참조하세요.

선택적 매개변수

  • language — 결과 반환 시 사용되는 언어. 지원되는 도메인 언어 목록을 참조하세요. 지원되는 언어는 자주 업데이트되므로 목록이 완전하지 않을 수 있습니다. 기본값은 en입니다.

시간대 응답

올바른 각 요청에 대해, 시간대 서비스는 요청 URL에 내에 나타난 형식으로 응답을 반환합니다. 각 응답에는 다음과 같은 요소가 포함됩니다.

  • dstOffset: 일광 절약 시간의 초 단위 오프셋. 지정된 timestamp 중에 시간대가 일광 절약 시간이 아니면 이 오프셋이 0이 됩니다.
  • rawOffset: 지정된 위치에 대한 UTC로부터의 초 단위 오프셋. 이는 일광 절약 시간에 영향을 미치지 않습니다.
  • timeZoneId: 시간대의 "tz" ID가 포함된 문자열(예: "America/Los_Angeles" 또는 "Australia/Sydney"). 이 ID는 IANA 시간대 데이터베이스에 정의되며, Wikipedia의 tz 데이터베이스 시간대 목록에서 검색 가능한 형식으로도 제공됩니다.
  • timeZoneName: 시간대의 긴 형식 이름이 포함된 문자열입니다. 언어 매개변수가 설정된 경우에는 이 필드가 현지화됩니다. 예: "태평양 일광 절약 시간" 또는 "오스트레일리아 동부 일광 절약 시간"
  • status: 응답 상태를 나타내는 문자열.
    • OK는 요청이 성공했음을 나타냅니다.
    • REQUEST_DENIED는 요청 형식이 잘못되었음을 나타냅니다.
    • OVER_QUERY_LIMIT는 요청자가 할당량을 초과했음을 나타냅니다.
    • REQUEST_DENIED는 API가 요청을 완료하지 않았음을 나타냅니다. HTTP 대신 HTTPS를 통해 요청이 전송되었는지 확인합니다.
    • UNKNOWN_ERROR는 알 수 없는 오류를 나타냅니다.
    • ZERO_RESULTS는 지정된 위치 또는 시간에 대해 발견된 시간대 데이터가 없음을 나타냅니다. 요청이 물 위가 아닌 육지의 위치에 대한 요청인지 확인합니다.
  • error_message: OK가 아닌 경우, 지정된 상태 코드가 제시된 이유에 대한 상세정보.

    참고: 이 필드는 항상 존재하는 것은 아니며 내용이 변경될 수 있습니다.

현지 시간 계산

지정된 위치의 현지 시간은 timestamp 매개변수와, 결과에서 dstOffsetrawOffset 필드의 합입니다.

예시 요청

이 섹션에는 API의 기능을 보여주는 샘플 쿼리가 포함되어 있습니다.

아래 쿼리는 미국 네바다에 대해 시간대 요청을 수행합니다. 타임스탬프는 2012년 3월 8일로 설정됩니다.

JSON

요청:

https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1331161200&key=YOUR_API_KEY

응답:

{
   "dstOffset" : 0,
   "rawOffset" : -28800,
   "status" : "OK",
   "timeZoneId" : "America/Los_Angeles",
   "timeZoneName" : "Pacific Standard Time"
}
    
XML

요청:

https://maps.googleapis.com/maps/api/timezone/xml?location=39.6034810,-119.6822510&timestamp=1331161200&key=YOUR_API_KEY

응답:

<TimeZoneResponse>
  <status>OK</status>
  <raw_offset>-28800.0000000</raw_offset>
  <dst_offset>0.0000000</dst_offset>
  <time_zone_id>America/Los_Angeles</time_zone_id>
  <time_zone_name>Pacific Standard Time</time_zone_name>
</TimeZoneResponse>

아래 쿼리는 미국 네바다에 대해 시간대 요청을 수행합니다. 위치는 위와 동일하지만, 타임스탬프는 2012년 3월 15일로 설정됩니다. 이제 응답에 일광 절약 시간 오프셋이 포함됩니다.

JSON

요청:

https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1331766000&key=YOUR_API_KEY

응답:

{
   "dstOffset" : 3600,
   "rawOffset" : -28800,
   "status" : "OK",
   "timeZoneId" : "America/Los_Angeles",
   "timeZoneName" : "Pacific Daylight Time"
}
    
XML

요청:

https://maps.googleapis.com/maps/api/timezone/xml?location=39.6034810,-119.6822510&timestamp=1331766000&key=YOUR_API_KEY

응답:

<TimeZoneResponse>
  <status>OK</status>
  <raw_offset>-28800.0000000</raw_offset>
  <dst_offset>3600.0000000</dst_offset>
  <time_zone_id>America/Los_Angeles</time_zone_id>
  <time_zone_name>Pacific Daylight Time</time_zone_name>
</TimeZoneResponse>

이 예시는 위의 두 예제와 비슷하지만 언어 매개변수를 설정합니다. 이제 응답이 스페인어로 현지화됩니다.

JSON

요청:

https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1331766000&language=es&key=YOUR_API_KEY

응답:

{
   "dstOffset" : 3600,
   "rawOffset" : -28800,
   "status" : "OK",
   "timeZoneId" : "America/Los_Angeles",
   "timeZoneName" : "Hora de verano del Pacífico"
}
    
XML

요청:

https://maps.googleapis.com/maps/api/timezone/xml?location=39.6034810,-119.6822510&timestamp=1331766000&language=es&key=YOUR_API_KEY

응답:

<TimeZoneResponse>
  <status>OK</status>
  <raw_offset>-28800.0000000</raw_offset>
  <dst_offset>3600.0000000</dst_offset>
  <time_zone_id>America/Los_Angeles</time_zone_id>
  <time_zone_name>Hora de verano del Pacífico</time_zone_name>
</TimeZoneResponse>

sensor 매개변수

이전의 Google Maps API는 애플리케이션이 사용자의 위치 파악을 위해 센서를 사용했는지 여부를 나타내기 위해 sensor 매개변수를 포함하도록 요구했습니다. 이 매개변수는 더 이상 필요하지 않습니다.

다음에 대한 의견 보내기...

Google Maps Time Zone API
Google Maps Time Zone API
도움이 필요하시나요? 지원 페이지를 방문하세요.