Omówienie interfejsu Time Zone API

Interfejs Time Zone API to usługa, która akceptuje żądania HTTP szerokość i długość geograficzną oraz wybraną datę i godzinę. Wyświetla godzinę, dane strefy dla danej lokalizacji, w tym przesunięcia dla czasu UTC i czasu letniego.
.

Dlaczego warto korzystać z interfejsu Time Zone API

Za pomocą interfejsu Time Zone API możesz tworzyć aplikacje udostępniające identyfikator i nazwa strefy czasowej w przypadku dat i godzin w określonych lokalizacjach na mapie. Możesz na przykład pokazać: dane strefy czasowej:

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

Informacje o strefie czasowej mogą być szczególnie przydatne, gdy chcesz, aby dane o Twojej strefie czasowej witryna lub aplikacja wyświetla istotne dla użytkowników dane w ujęciu czasowym.

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 Time Zone API

Interfejs Time Zone API akceptuje żądanie HTTPS zawierające szerokość/długość geograficzną współrzędne, żądaną datę i godzinę w postaci sygnatury czasowej, a opcjonalnie kod 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=1331161200
    &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 na czas letni (w sekundach)
  • Konkretne 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 o strefie czasowej w aplikacji lub witrynie. Zobacz Odpowiedzi dotyczące strefy czasowej. .
5 Umieść dane o strefie czasowej we własnej aplikacji. Dzięki danym o strefie czasowej możesz ulepszać aplikacje i strony internetowe dla użytkowników w różnych regionach czasowych.

Dostępne biblioteki klienta

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

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

Co dalej?