Omówienie interfejsu Time Zone API

Time Zone API to usługa, która akceptuje żądanie HTTP dotyczące współrzędnych geograficznych oraz daty i godziny. Zwraca dane o strefie czasowej obowiązujące w danej lokalizacji z uwzględnieniem przesunięcia czasu UTC i letniego.

Dlaczego warto korzystać z interfejsu Time Zone API

Za pomocą interfejsu Time Zone API możesz tworzyć aplikacje, które udostępniają identyfikator strefy czasowej oraz nazwę dla dat i godzin w określonych lokalizacjach na mapie. Możesz na przykład wyświetlać te dane strefy czasowej:

  • Zlokalizowane nazwy stref czasowych na potrzeby lokalizacji na mapie z Google Maps Platform.
  • Strefy czasowe są przesuwane względem czasu UTC i czasu letniego.

Dane o strefie czasowej mogą być szczególnie przydatne, gdy chcesz, aby Twoja witryna lub aplikacja wyświetlała istotne dla użytkowników dane czasowe.

Do czego służy interfejs Time Zone API

Za pomocą interfejsu Time Zone API możesz zażądać strefy czasowej dla lokalizacji na powierzchni Ziemi z przesunięciem względem czasu UTC oraz czasu letniego dla każdej z tych lokalizacji.

Jak działa interfejs Time Zone API

Interfejs Time Zone API akceptuje żądanie HTTPS dotyczące współrzędnych szerokości i długości geograficznej, żądaną datę i godzinę jako sygnaturę czasową oraz opcjonalnie kod języka. Zwraca dane w formacie określonym w żądaniu. Poniższy przykład przedstawia żądanie dotyczące Nevady w Stanach Zjednoczonych z żądanymi danymi wyjściowymi w formacie JSON.

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

Zasoby

W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych za pomocą interfejsu Time Zone API oraz zwracane przez nią dane.

Zasoby danych Zwrócone dane Format zwracanych
Strefa czasowa

Przesyłasz prośbę wraz z lokalizacją i sygnaturą czasową. Zobacz wymagane parametry.

  • Identyfikator strefy czasowej.
  • Nazwa strefy czasowej, opcjonalnie zlokalizowana
  • Przesunięcie względem czasu UTC w sekundach
  • Przesunięcie w czasie letnim, w sekundach
  • Szczegółowe przykłady odpowiedzi znajdziesz w sekcji Strefa czasowa.
  • JSON
  • XML

Jak korzystać z interfejsu Time Zone API

1 Konfiguracja Zacznij od konfiguracji projektu Google Cloud i wykonaj podane niżej instrukcje konfiguracji.
2 Wysyłanie żądania dotyczącego strefy czasowej Gdy masz klucz interfejsu API, możesz zacząć testować interfejs Time Zone API bezpośrednio w przeglądarce. Więcej informacji znajdziesz w przykładach dotyczących stref czasowych w przewodniku Żądania i odpowiedzi dotyczące strefy czasowej.
3 Podstawowe informacje o odpowiedziach Dowiedz się, jak korzystać z danych o strefie czasowej w aplikacji lub witrynie. Więcej informacji znajdziesz w sekcji Odpowiedzi na temat strefy czasowej .
5 Umieść dane o strefie czasowej w swojej aplikacji. Danych o strefie czasowej możesz używać do ulepszania aplikacji i stron internetowych dostępnych dla użytkowników w różnych regionach czasowych.

Dostępne biblioteki klienta

Wywołaj ten interfejs API w wybranym języku za pomocą jednej z tych bibliotek klienta:

Klienty Java, Python, Go i Node.js dla usług Map Google to obsługiwane przez społeczność biblioteki klienckie udostępniane na licencji open source na licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.

Co dalej