Aikavyöhyke-API tarjoaa aikavyöhyketietoja maan pinnalla sijaitseville paikoille. Pyydä aikavyöhyketietoja tietylle leveyspiiri/pituuspiiri -parille ja päivämäärälle. API palauttaa kyseisen aikavyöhykkeen nimen, aikavyöhykkeen siirtymän UTC:stä ja kesäajan siirtymän.

Esimerkkipyyntö ja -vaste

Käytä aikavyöhyke-API:tä HTTPS-liitännän kautta siten, että pyynnöt on muodostettu URL-merkkijonoksi, jossa käytetään leveyspiiri/pituuspiiri -koordinaatteja location:n määrittelemiseen, päivämäärän määrittelemistä varten timestamp:tä ja API-avainta.

Seuraavassa esimerkissä pyydetään aikavyöhyketietoja Washingtonista, DC:stä, Yhdysvalloista, 15. maaliskuuta 2016 JSON-muodossa:

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

Voit testata tätä syöttämällä URL-osoitteen selaimeesi (muista korvata YOUR_API_KEY todellisella API-avaimellasi). Vastaus sisältää määritetyn sijainnin ja päivämäärän aikavyöhyketiedot (timestamp).

Katso kehittäjän oppaasta lisätietoja pyyntö-URL:ien ja käytettävissä olevien parametrien rakentamisesta ja vastauksen ymmärtämisestä.

Alhaalla on esimerkkivastaus JSON-muodossa:

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

Aloita koodaus asiakaskirjastojemme avulla

Asiakaskirjastot helpottavat Google Maps -verkkopalvelun sovellusliittymien kanssa kehittämistä tarjoamalla yksinkertaisia natiivitoteutuksia yleisimpiin tehtäviin, kuten todennukseen, pyyntöjen rajoittamiseen ja automaattiseen uudelleenkokeeseen. Aikavyöhyke-API on saatavilla Google Maps -palveluiden Java-asiakasohjelmassa, Python-asiakasohjelmassa, Go-asiakasohjelmassa ja Node.js-asiakasohjelmassa.

Autentikointi, kiintiöt, hinnoittelu ja käytännöt

Autentikointi

Käyttääksesi Aikavyöhyke-API:tä sinun on ensin otettava API käyttöön ja hankittava asianmukaiset todennustiedot. Lisätietoja on kohdassa Google Maps Platformin käyttöönotto.

Kiintiöt ja hinnoittelu

Katso Käyttö ja laskutus -sivulta lisätietoja Aikavyöhyke-API:lle asetetuista kiintiöistä ja hinnoittelusta.

Käytännöt

Aikavyöhyke-API:n käytön on oltava API-käytäntöjen mukaista.

Learn more

Aikavyöhyke-API:ssä voit myös asettaa kieliparametrin palauttaaksesi tuloksia muilla kielillä kuin oletusarvoisesti englanniksi. Katso lisää esimerkkejä ja muita yksityiskohtia Time Zone API Developer Guide -oppaasta.