Rozpocznij

Interfejs Time Zone API udostępnia dane o przesunięciach w czasie dla lokalizacji na powierzchni Ziemi. Możesz poprosić o 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 UTC i zmianę czasu na letni lub zimowy.

Przykładowe żądanie i odpowiedź

Dostęp do interfejsu Time Zone API jest możliwy przez interfejs HTTPS, gdzie żądania mają postać ciągu adresu URL ze współrzędnymi szerokości i długości geograficznej do określenia location, timestamp do określenia daty oraz klucza interfejsu API.

Poniższe zapytanie wykonuje żądanie strefy czasowej dla Nevady 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=1331161200
  &key=YOUR_API_KEY

cURL

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

Aby to sprawdzić, wpisz adres URL w przeglądarce (pamiętaj, aby zastąpić YOUR_API_KEY właściwym 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żej znajdziesz przykładową 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ą naszych bibliotek klienta

Biblioteki klienta ułatwiają programowanie za pomocą interfejsów API usług internetowych Map Google, udostępniając proste, natywne implementacje typowych zadań, takich jak uwierzytelnianie, ograniczanie żądań i automatyczne ponawianie próby. Interfejs Time Zone API jest dostępny dla klientów Java, Python, Go i Node.js dla usług Map Google.

Uwierzytelnianie, limity, ceny i zasady

Uwierzytelnianie

Aby używać interfejsu Time Zone API, musisz najpierw go włączyć i uzyskać odpowiednie dane uwierzytelniające. Więcej informacji znajdziesz w artykule o pierwszych krokach z Google Maps Platform.

Limity i ceny

Sprawdź stronę wykorzystania i płatności, aby dowiedzieć się więcej o limitach i cenach interfejsu Time Zone API.

Zasady

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

Więcej informacji

W interfejsie Time Zone API możesz też ustawić parametr language, aby zwracał wyniki w językach innych niż domyślny angielski. Więcej przykładów i inne informacje znajdziesz w przewodniku dla programistów interfejsu Time Zone API.

Przewodnik dla programistów interfejsu Time Zone API jest przeznaczony dla deweloperów witryn i aplikacji mobilnych, którzy chcą umieszczać na mapach dane o czasie dostarczane przez jeden z interfejsów API Google Maps Platform. Zawiera wprowadzenie do korzystania z interfejsu API oraz materiały referencyjne na temat dostępnych parametrów.