Interfejs Time Zone API udostępnia dane o przesunięciu czasu dla lokalizacji na powierzchni Ziemię. Poproś o informacje o strefie czasowej dla konkretnej pary szerokości i długości geograficznej oraz daty. Interfejs API zwraca nazwę tej strefy czasowej, przesunięcie czasu względem UTC i wartość zmiany czasu na letni lub zimowy.
Przykładowe żądanie i odpowiedź
Uzyskaj dostęp do interfejsu Time Zone API przez interfejs HTTPS i włącz
żądań utworzonych jako ciąg adresu URL, przy użyciu współrzędnych długości i szerokości geograficznej,
podaj location
, timestamp
, aby określić datę,
i klucz interfejsu API.
Poniższe zapytanie wykonuje żądanie dotyczące strefy czasowej w stanie Nevada w Stanach Zjednoczonych. sygnatura czasowa, 8 marca 2012 r.
URL
https://maps.googleapis.com/maps/api/timezone/json ?location=39.6034810%2C-119.6822510 ×tamp=1331161200 &key=YOUR_API_KEY
cURL
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1331161200&key=YOUR_API_KEY'
Aby to sprawdzić, wpisz w przeglądarce adres URL (pamiętaj, aby zastąpić
YOUR_API_KEY
rzeczywistym kluczem interfejsu API).
Odpowiedź zawiera dane o strefie czasowej dla określonej lokalizacji i daty
(timestamp)
Zapoznaj się z przewodnikiem dla programistów . tworzenie adresów URL żądań i dostępnych parametrów i zrozumienie odpowiedzi.
Poniżej znajdziesz przykładową odpowiedź w formacie JSON:
JSON
{ "dstOffset": 0, "rawOffset": -28800, "status": "OK", "timeZoneId": "America/Los_Angeles", "timeZoneName": "Pacific Standard Time", }
XML
<TimeZoneResponse> <status>OK</status> <raw_offset>-28800.0000000</raw_offset> <dst_offset>0.0000000</dst_offset> <time_zone_id>America/Los_Angeles</time_zone_id> <time_zone_name>Pacific Standard Time</time_zone_name> </TimeZoneResponse>
Zacznij kodować, korzystając z naszych bibliotek klienta
Biblioteki klienta ułatwiają programowanie za pomocą interfejsów API usług sieciowych Map Google, ponieważ zapewniają proste, natywne implementacje typowych zadań, takich jak uwierzytelnianie, i automatyczne ponawianie próby. Interfejs Time Zone API jest dostępny w Klient Java, Klient Pythona, Klient Go i Klient Node.js dla usług Map Google.
Uwierzytelnianie, limity, ceny i zasady
Uwierzytelnianie
Aby korzystać z interfejsu Time Zone API, musisz go najpierw włączyć i uzyskać dane uwierzytelniające. Więcej informacji: Pierwsze kroki z Google Maps Platform
Limity i ceny
Przejrzyj stronę użytkowania i płatności. .
Zasady
Korzystanie z interfejsu Time Zone API musi odbywać się zgodnie z Zasady dotyczące interfejsu API
Więcej informacji
W interfejsie Time Zone API możesz też ustawić parametr języka , aby zwrócić wyniki w językach innych niż domyślny angielski. Zobacz Time Zone API w przewodniku dla programistów, aby zobaczyć więcej przykładów i inne informacje.
Przewodnik dla programistów po interfejsie Time Zone API jest przeznaczony dla witryn i urządzeń mobilnych programistów, którzy chcą umieszczać na mapach dane dotyczące czasu dostarczane przez jedną z Google Maps Platform API. Przedstawiamy w nim wprowadzenie do korzystania z interfejsu API i materiały referencyjne na temat dostępnych .