Kom igång
Tidzons-API:et tillhandahåller tidsförskjutningsdata för platser på jordens yta. Begär information om tidszon för ett specifikt latitud/längdpar och datum. API:et returnerar namnet på den tidszonen, tidsförskjutningen från UTC och förskjutningen för sommartid.
Exempel på begäran och svar
Access till tidszons-API:et via ett HTTPS-gränssnitt, med förfrågningar som konstrueras som en URL-sträng, med hjälp av koordinater för latitud/längdgränser för att specificera location, ett timestamp för att specificera datumet och din API-nyckel.
Följande exempel begär tidszondata för Washington, DC, USA, den 15 mars 2016 i JSON-format:
https://maps.googleapis.com/maps/api/timezone/json?location=38.908133,-77.047119×tamp=1458000000&key=YOUR_API_KEY
Du kan testa detta genom att skriva in URL:en i din webbläsare (se till att ersätta YOUR_API_KEY med din faktiska API-nyckel). Svaret innehåller tidszondata för den angivna platsen och datumet (timestamp).
Se utvecklarguiden för mer information om hur du bygger URL:er för begäran och tillgängliga parametrar och hur du förstår svaret.
Nedan följer ett exempel på svar, i JSON:
{ "dstOffset" : 3600, "rawOffset" : -18000, "status" : "OK", "timeZoneId" : "America/New_York", "timeZoneName" : "Eastern Daylight Time"}
Börja kodning med våra klientbibliotek
Klientbiblioteken underlättar utvecklingen med Google Maps webbtjänst-API:erna genom att tillhandahålla enkla, inbyggda implementeringar av vanliga uppgifter som autentisering, strypning av begäranden och automatisk omprövning. API:et för tidszon är tillgängligt i Java-klienten, Python-klienten, Go-klienten och Node.js-klienten för Google Maps-tjänster.
Autentisering, kvoter, prissättning och policyer
Autentisering
För att använda Time Zone API måste du först aktivera API:et och skaffa rätt autentiseringsuppgifter. Mer information finns i Komma igång med Google Maps Platform.
Kvoter och prissättning
Se sidan för användning och fakturering för detaljer om de kvoter och priser som fastställts för Time Zone API.
Policy
Användningen av tidszons-API måste vara i enlighet med API-policyn.
Lär dig mer
I tidszons-API kan du också ange en språkparameter för att returnera resultat på andra språk än standardspråket engelska. Se Time Zone API Developer Guide för fler exempel och andra detaljer.