Omówienie interfejsu Time Zone API

Time Zone API to usługa, która akceptuje żądanie HTTP zawierające współrzędne szerokości i długości geograficznej oraz wybraną datę i godzinę. Zwraca dane o strefie czasowej dla lokalizacji, w tym przesunięcia względem czasu UTC i czasu letniego.

Dlaczego warto używać interfejsu Time Zone API

Dzięki interfejsowi Time Zone API możesz tworzyć aplikacje, które podają identyfikator i nazwę strefy czasowej dla dat i godzin w określonych lokalizacjach na mapie. Możesz na przykład wyświetlić te dane dotyczące strefy czasowej:

  • Zlokalizowane nazwy stref czasowych dla lokalizacji na mapie z Google Maps Platform.
  • Przesunięcia strefy czasowej względem czasu UTC i czasu letniego.

Dane o strefie czasowej są szczególnie przydatne, gdy chcesz, aby Twoja witryna lub aplikacja wyświetlała dane oparte na czasie, które są istotne dla użytkowników Twojej aplikacji.

Co możesz zrobić za pomocą interfejsu Time Zone API

Za pomocą interfejsu Time Zone API możesz poprosić o strefę czasową dla lokalizacji na powierzchni Ziemi, z przesunięciem czasu względem czasu UTC i czasem letnim dla każdej z tych lokalizacji.

Jak działa interfejs Time Zone API

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

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

Zasoby

W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych w interfejsie Time Zone API oraz zwracanych przez niego danych:

Zasoby danych Zwrócone dane Format zwrotu
Strefa czasowa

Podajesz prośbę wraz z lokalizacją i sygnaturą czasową. Zobacz parametry wymagane.

  • Identyfikator strefy czasowej.
  • Nazwa strefy czasowej, opcjonalnie zlokalizowana.
  • Przesunięcie względem UTC w sekundach.
  • Przesunięcie czasu letniego w sekundach.
  • Przykłady konkretnych odpowiedzi znajdziesz w sekcji Strefa czasowa.
  • JSON
  • XML

Jak korzystać z interfejsu Time Zone API

1 Konfiguracja Zacznij od sekcji Konfigurowanie projektu Google Cloud i postępuj zgodnie z instrukcjami konfiguracji.
2 Wypróbuj prośbę o strefę czasową Gdy masz już klucz interfejsu API, możesz zacząć testować Time Zone API bezpośrednio w przeglądarce. Szczegółowe informacje znajdziesz w przykładach dotyczących stref czasowych w przewodniku Żądania i odpowiedzi dotyczące stref czasowych.
3 Podstawowe informacje o odpowiedziach Dowiedz się, jak używać danych o strefie czasowej w aplikacji lub witrynie. Szczegółowe informacje znajdziesz w sekcji Odpowiedzi dotyczące strefy czasowej.
5 Incorporate timezone data into your own app! Możesz używać danych o strefach czasowych, aby ulepszać aplikacje i witryny w różnych regionach czasowych.

Dostępne biblioteki klienta

Wywołaj ten interfejs API w wybranym języku, korzystając z jednej z tych bibliotek klienta:

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

Co dalej?