Zacznij

Interfejs API Strefa czasowa udostępnia dane o odchyleniu czasowym dla lokalizacji na powierzchni Ziemi. Poproś o informacje o strefie czasowej dla określonej pary współrzędnych geograficznych i daty. Interfejs API zwraca nazwę strefy czasowej, przesunięcie czasu względem UTC oraz przesunięcie na czas letni.

Przykładowe żądanie i odpowiedź

Uzyskaj dostęp do interfejsu Time Zone API przez interfejs HTTPS, wysyłając żądania w postaci ciągu adresu URL, używając współrzędnych szerokości i długości geograficznej, aby określić współrzędne location, współrzędnych timestamp, aby określić datę, oraz klucza interfejsu API.

Zapytanie poniżej wykonuje żądanie strefy czasowej dla stanu Nevada w Stanach Zjednoczonych. Sygnatura czasowa jest ustawiona na 8 marca 2012 r.

URL

https://maps.googleapis.com/maps/api/timezone/json
  ?location=39.6034810%2C-119.6822510
  &timestamp=1733428634
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1733428634&key=YOUR_API_KEY'

Możesz to przetestować, wpisując adres URL w przeglądarce (pamiętaj, aby zastąpić YOUR_API_KEY prawdziwym kluczem interfejsu API). Odpowiedź zawiera dane strefy czasowej dla wybranej lokalizacji i daty. (timestamp)

Aby dowiedzieć się więcej o  tworzeniu adresów URL żądań i dostępnych parametrach oraz o  interpretowaniu odpowiedzi, zapoznaj się z przewodnikiem dla programistów.

Poniżej znajduje się przykładowa odpowiedź w formacie JSON:

JSON

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

XML

<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>

Zacznij kodować z naszych bibliotek klienta

Biblioteki klienta ułatwiają tworzenie aplikacji korzystających z interfejsów API usługi internetowej Map Google, ponieważ zapewniają proste, natywne implementacje typowych zadań, takich jak uwierzytelnianie, ograniczanie liczby żądań i automatyczne ponowne próby. Interfejs Time Zone API jest dostępny w kliencie Java, kliencie Python, kliencie Go i kliencie Node.js dla usług Map Google.

Uwierzytelnianie, limity, ceny i zasady

Uwierzytelnianie

Aby korzystać z interfejsu Time Zone API, musisz najpierw go włączyć i uzyskać odpowiednie dane logowania. Więcej informacji znajdziesz w artykule Pierwsze kroki z Google Maps Platform.

Limity i ceny

Szczegółowe informacje o limitach i opłatach związanych z interfejsem Time Zone API znajdziesz na stronie Korzystanie i rozliczenia.

Zasady

Korzystanie z interfejsu Time Zone API musi być zgodne z zasadami dotyczącymi interfejsu API.

Więcej informacji

W interfejsie API strefy czasowej możesz też ustawić parametr języka, aby zwracać wyniki w innych językach niż domyślny angielski. Więcej przykładów i szczegółów znajdziesz w przewodniku dla programistów dotyczącym interfejsu API strefy czasowej.

Przewodnik dla deweloperów dotyczący interfejsu Time Zone API jest przeznaczony dla deweloperów witryn internetowych i aplikacji mobilnych, którzy chcą uwzględniać dane czasowe na mapach udostępnianych przez jeden z interfejsów API Google Maps Platform. Znajdziesz w nim wprowadzenie do korzystania z interfejsu API oraz materiały referencyjne dotyczące dostępnych parametrów.