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 ×tamp=1331161200 &key=YOUR_API_KEY
cURL
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=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.