
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 ×tamp=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. |
|
|
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:
- Klient Java dla usług Map Google
- Klient Pythona dla usług Map Google
- Klient Go dla usług Map Google
- Klient Node.js dla usług Map Google
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
- Dowiedz się, jak wysyłać żądania dotyczące strefy czasowej: przeczytaj artykuł o żądaniach i odpowiedziach dotyczących strefy czasowej.
- Zastosuj sprawdzone metody: zapoznaj się ze sprawdzonymi metodami dotyczącymi usług internetowych.