Rozpocznij

Time Zone API udostępnia dane o przesunięciu czasu dla lokalizacji na powierzchni Ziemi. Uzyskaj informacje o strefie czasowej dla określonej pary szerokości i długości geograficznej oraz daty. Interfejs API zwraca nazwę tej strefy czasowej, przesunięcie czasu względem czasu UTC i przesunięcie czasu letniego.

Przykładowe żądanie i odpowiedź

Dostęp do interfejsu Time Zone API można uzyskać przez interfejs HTTPS, w którym żądania są tworzone jako ciąg adresu URL, z użyciem współrzędnych szerokości i długości geograficznej do określenia location, timestamp do określenia daty oraz klucza interfejsu API.

Poniższe zapytanie wysyła żądanie dotyczące strefy czasowej w Nevadzie w USA. 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 przetestować to żądanie, wpisując adres URL w przeglądarce. Pamiętaj, aby zastąpić YOUR_API_KEY rzeczywistym kluczem interfejsu API. Odpowiedź zawiera dane o strefie czasowej dla określonej lokalizacji i daty (timestamp).

Więcej informacji o tworzeniu adresów URL żądań i dostępnych parametrach oraz o interpretowaniu odpowiedzi znajdziesz w przewodniku dla programistów.

Poniższy przykład pokazuje 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ć za pomocą bibliotek klienta

Biblioteki klienta upraszczają tworzenie aplikacji za pomocą interfejsów API usług internetowych Map Google, ponieważ udostępniają proste, wbudowane implementacje typowych zadań, takich jak uwierzytelnianie, ograniczanie żądań i automatyczne ponawianie prób. Interfejs Time Zone API jest dostępny w klientach Java, Python, Go i 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 uwierzytelniające. Więcej informacji znajdziesz w artykule Pierwsze kroki z Google Maps Platform.

Limity i ceny

Szczegółowe informacje o limitach i cenach Time Zone API znajdziesz w artykule Korzystanie i rozliczenia.

Zasady

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

Więcej informacji

W interfejsie API stref czasowych możesz też ustawić parametr języka, aby zwracać wyniki w językach innych niż domyślny angielski. Więcej przykładów i szczegółowych informacji znajdziesz w przewodniku dla programistów korzystających z interfejsu API stref czasowych.

Przewodnik dla programistów korzystających z interfejsu Time Zone API pomaga programistom stron internetowych i aplikacji mobilnych dodawać dane o strefach czasowych do map udostępnianych przez jeden z interfejsów API Google Maps Platform. Zawiera wprowadzenie do korzystania z interfejsu API i materiały referencyjne dotyczące dostępnych parametrów.