
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 ×tamp=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. |
|
|
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 do usług Map Google
- Klient Python dla usług Map Google
- Klient Go dla usług Map Google
- Klient Node.js do usług Map Google
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?
- Dowiedz się, jak wysyłać żądania do interfejsu Time Zone API: otwórz artykuł Żądania i odpowiedzi interfejsu Time Zone API.
- Stosuj sprawdzone metody: zapoznaj się ze sprawdzonymi metodami dotyczącymi usług internetowych.