Program Time Zone API dostarcza danych o przesunięciach czasowych dla lokalizacji na powierzchni Ziemi. Zażądaj informacji o strefie czasowej dla określonej pary szerokości/długości geograficznej i daty. API zwraca nazwę tej strefy czasowej, przesunięcie czasu względem UTC oraz przesunięcie czasu letniego.

Przykładowe żądanie i odpowiedź

Dostęp do Time Zone API poprzez interfejs HTTPS, z żądaniami skonstruowanymi jako ciąg URL, używając współrzędnych szerokości/długości geograficznej do określenia location, timestamp do określenia daty oraz Twojego klucza API.

Następujący przykład żąda danych strefy czasowej dla Waszyngtonu, DC, USA, w dniu 15 marca 2016 r., w formacie JSON:

https://maps.googleapis.com/maps/api/timezone/json?location=38.908133,-77.047119&timestamp=1458000000&key=YOUR_API_KEY

Możesz to przetestować, wprowadzając adres URL do przeglądarki internetowej (pamiętaj, aby zastąpić YOUR_API_KEY swoim rzeczywistym kluczem API). Odpowiedź zawiera dane strefy czasowej dla określonej lokalizacji i daty (timestamp).

Zobacz przewodnik programisty, aby uzyskać więcej informacji na temat budowania adresów URL żądania i dostępnych parametrów oraz zrozumienia odpowiedzi.

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

{ "dstOffset" : 3600, "rawOffset" : -18000, "status" : "OK", "timeZoneId" : "America/New_York", "timeZoneName" : "Eastern Daylight Time"}

Zacznij kodowanie z naszymi bibliotekami klienckimi

Biblioteki klienckie ułatwiają rozwój za pomocą interfejsów API usług internetowych Map Google, zapewniając proste, natywne implementacje typowych zadań, takich jak uwierzytelnianie, dławienie żądań i automatyczne ponawianie prób. Interfejs API strefy czasowej jest dostępny w kliencie Java, kliencie Python, kliencie Go i kliencie Node.js dla usług Google Maps.

Uwierzytelnianie, limity, ceny i zasady

Uwierzytelnianie

Aby korzystać z interfejsu API strefy czasowej, musisz najpierw włączyć interfejs API i uzyskać odpowiednie poświadczenia uwierzytelniania. Aby uzyskać więcej informacji, zobacz Rozpocznij pracę z platformą Google Maps Platform.

Kwoty i ceny

Zobacz stronę użytkowania i rozliczania, aby uzyskać szczegółowe informacje na temat kwot i cen ustawionych dla interfejsu API Strefy czasowej.

Polityki

Korzystanie z API Strefy czasowej musi być zgodne z zasadami API.

Dowiedz się więcej

W API Strefy czasowej można również ustawić parametr języka, aby zwrócić wyniki w językach innych niż domyślny angielski. Zobacz Time Zone API Developer Guide, aby uzyskać więcej przykładów i innych szczegółów.