Interfejs Time Zone API udostępnia dane o przesunięciu czasowym dla lokalizacji na powierzchni Ziemi. Poproś 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 czasowe względem czasu UTC i przesunięcie czasu letniego.
Przykładowe żądanie i odpowiedź
Dostęp do interfejsu Time Zone API jest możliwy za pomocą interfejsu HTTPS. Żądania są tworzone jako ciąg znaków URL z użyciem współrzędnych geograficznych (szerokości i długości) do określenia location, timestamp do określenia daty i klucza interfejsu API.
Poniższe zapytanie wysyła prośbę o strefę czasową dla Nevady 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 ×tamp=1733428634 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1733428634&key=YOUR_API_KEY'
Możesz to sprawdzić, 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 określonej lokalizacji i daty(timestamp).
Więcej informacji o tworzeniu adresów URL żądań i dostępnych parametrach oraz interpretowaniu odpowiedzi znajdziesz w przewodniku dla deweloperó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ą tworzenie aplikacji korzystających z interfejsów API usług internetowych Map Google, ponieważ zapewniają proste, natywne implementacje typowych zadań, takich jak uwierzytelnianie, ograniczanie liczby żądań i automatyczne ponawianie. 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 włączyć go 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 cenach interfejsu Time Zone API znajdziesz na stronie użytkowanie i rozliczenia.
Zasady
Korzystanie z interfejsu Time Zone API musi być zgodne z zasadami dotyczącymi interfejsów API.
Więcej informacji
W interfejsie Time Zone API możesz też ustawić parametr języka, aby zwracać wyniki w językach innych niż domyślny język angielski. Więcej przykładów i informacji znajdziesz w przewodniku dla programistów po interfejsie Time Zone API.
Przewodnik dla programistów dotyczący interfejsu Time Zone API jest przeznaczony dla programistów witryn i aplikacji mobilnych, którzy chcą uwzględniać dane o czasie na mapach 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.