Omówienie interfejsu Time Zone API

Interfejs Time Zone API to usługa, która akceptuje żądania HTTP szerokości i długości geograficznej oraz wybranej daty i godziny. Wyświetla godzinę, dane strefy dla danej lokalizacji, w tym przesunięcia dla czasu UTC i czasu letniego. obecnie się znajdujesz.

Dlaczego warto używać interfejsu Time Zone API

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

  • Lokalizowane nazwy stref czasowych dla lokalizacji mapy z Google Maps Platform.
  • Przesunięcie strefy czasowej w stosunku do UTC i zmiany czasu na letni lub zimowy.

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

Co można zrobić przy użyciu interfejsu Time Zone API

Za pomocą interfejsu Time Zone API możesz poprosić o strefę czasową dla lokalizacje na powierzchni Ziemi z przesunięciem czasu od UTC i czas letni dla każdego z tych lokalizacji.

Jak działa interfejs API strefy czasowej

Interfejs API strefy czasowej akceptuje żądanie HTTPS z współrzędnych szerokości i długości geograficznej, żądanej daty i godziny w postaci sygnatury czasowej oraz opcjonalnie kodu języka. Zwraca dane w formacie określonym w żądaniu. Poniżej znajduje się przykład żądania dotyczącego atrybutu Nevada, USA, z żądanymi 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 Time Zone API wraz z zwracanymi danymi.

Zasoby danych Zwrócone dane Format zwrotu
Strefa czasowa

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

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

Jak korzystać z interfejsu Time Zone API

1 Konfiguracja Zacznij od skonfigurowania Projekt Google Cloud i dokończ konfigurację. z podanych instrukcji.
2 Sprawdź prośbę o strefę czasową Po otrzymaniu klucza interfejsu API możesz rozpocząć testowanie interfejsu Time Zone API bezpośrednio na stronie przeglądarki. Zobacz przykłady stref czasowych. w przewodniku Żądania i odpowiedzi dotyczące strefy czasowej.
3 Podstawowe informacje o odpowiedziach Dowiedz się, jak używać danych stref czasowych w aplikacji lub witrynie. Zobacz Odpowiedzi dotyczące strefy czasowej. .
5 Umieść dane o strefie czasowej we własnej aplikacji. Dane o strefach czasowych możesz wykorzystać do ulepszania aplikacji i witryn dla użytkowników w różnych strefach czasowych.

Dostępne biblioteki klienta

Wywołaj ten interfejs API w języku możesz wybrać za pomocą jednej z tych bibliotek klienta:

Biblioteki klienta Java, Python, Go i Node.js do obsługi Usług Map Google są bibliotekami klienta obsługiwanymi przez społeczność, które są dostępne jako oprogramowanie open source na licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.

Co dalej?