De Tijdzone API verschaft gegevens over tijdsverschillen voor locaties op het aardoppervlak. Vraag de tijdzone-informatie voor een specifieke breedtegraad / lengtegraad paar en datum. De API retourneert de naam van die tijdzone, de tijdverschuiving ten opzichte van UTC, en de zomertijdcompensatie.

Sample request and response

Toegang tot de Tijdzone API via een HTTPS interface, met verzoeken geconstrueerd als een URL string, met behulp van breedtegraad/lengtegraad coördinaten om de location, een timestamp om de datum te specificeren, en uw API sleutel te specificeren.

Het volgende voorbeeld vraagt de tijdzone gegevens voor Washington, DC, USA, op 15 maart 2016, in JSON formaat:

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

U kunt dit testen door de URL in uw web browser in te voeren (zorg ervoor dat u YOUR_API_KEY vervangt door uw werkelijke API sleutel). De respons bevat de tijdzone gegevens voor de opgegeven locatie en datum (timestamp).

Bekijk de gids voor ontwikkelaars voor meer informatie over het bouwen van verzoek URL’s en beschikbare parameters en het begrijpen van de respons.

Hieronder vindt u een voorbeeldrespons, in JSON:

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

Start met coderen met onze clientbibliotheken

Clientbibliotheken maken het ontwikkelen met de Google Maps webservice API’s eenvoudiger door eenvoudige, native implementaties te bieden van veelvoorkomende taken, zoals authenticatie, request throttling en automatische retry. De Tijdzone API is beschikbaar in de Java Client, Python Client, Go Client en Node.js Client voor Google Maps Services.

Authenticatie, quota, prijzen en beleid

Authenticatie

Om de tijdzone-API te gebruiken, moet u eerst de API inschakelen en de juiste authenticatiereferenties verkrijgen. Voor meer informatie, zie Aan de slag met Google Maps Platform.

Quota’s en prijzen

Bekijk de gebruiks- en factureringspagina voor details over de quota’s en prijzen die zijn ingesteld voor de Tijdzone-API.

Beleid

Het gebruik van de Tijdzone-API moet in overeenstemming zijn met het API-beleid.

Lees meer

In de Tijdzone-API kunt u ook een taalparameter instellen om resultaten te retourneren in andere talen dan de standaardtaal Engels. Zie de Time Zone API Developer Guide voor meer voorbeelden en andere details.