Rozhraní API časových pásem poskytuje údaje o časovém posunu pro místa na zemském povrchu. Vyžádejte si informace o časovém pásmu pro konkrétní dvojici zeměpisná šířka/délka a datum. Rozhraní API vrátí název daného časového pásma, časový posun od UTC a letní posun.

Ukázka požadavku a odpovědi

Přístup k rozhraní API časového pásma prostřednictvím rozhraní HTTPS, přičemž požadavky jsou sestaveny jako řetězec URL s použitím souřadnic zeměpisné šířky/délky pro zadání location, timestamp pro zadání data a vašeho klíče API.

Následující příklad požaduje údaje o časovém pásmu pro Washington, DC, USA, 15. března 2016 ve formátu JSON:

https://maps.googleapis.com/maps/api/timezone/json?location=38.908133,-77.047119&timestamp=1458000000&key=YOUR_API_KEY

Tento požadavek můžete vyzkoušet zadáním adresy URL do webového prohlížeče (nezapomeňte nahradit YOUR_API_KEY svým skutečným klíčem API). Odpověď obsahuje údaje o časovém pásmu pro zadané místo a datum (timestamp).

Podívejte se do příručky pro vývojáře, kde najdete další informace o sestavování adres URL požadavků a dostupných parametrech a o porozumění odpovědi.

Níže je ukázka odpovědi ve formátu JSON:

{ "dstOffset" : 3600, "rawOffset" : -18000, "status" : "OK", "timeZoneId" : "America/New_York", "timeZoneName" : "Eastern Daylight Time"}

Začněte kódovat s našimi klientskými knihovnami

Klientské knihovny usnadňují vývoj s rozhraním API webové služby Mapy Google tím, že poskytují jednoduché nativní implementace běžných úloh, jako je ověřování, přiškrcení požadavků a automatické opakování. Rozhraní API časového pásma je k dispozici v klientských knihovnách Java Client, Python Client, Go Client a Node.js Client pro služby Google Maps.

Ověřování, kvóty, ceny a zásady

Ověřování

Chcete-li používat rozhraní API časového pásma, musíte nejprve povolit rozhraní API a získat správné ověřovací údaje. Další informace naleznete v části Začínáme s platformou Mapy Google.

Kvóty a ceny

Podrobnosti o kvótách a cenách nastavených pro rozhraní API časových pásem naleznete na stránce používání a účtování.

Zásady

Používání rozhraní API časových pásem musí být v souladu se zásadami rozhraní API.

Další informace

V rozhraní API časových pásem můžete také nastavit parametr jazyka, aby se výsledky vracely v jiných jazycích, než je výchozí angličtina. Další příklady a další podrobnosti naleznete v příručce pro vývojáře API časových pásem.