The Time Zone API leverer data om tidsforskydning for steder på jordens overflade. Anmod om oplysninger om tidszonen for et bestemt længde- og breddegradspar og en bestemt dato. API’et returnerer navnet på den pågældende tidszone, tidsforskydningen fra UTC og sommertidsforskydningen.

Eksempel på anmodning og svar

Access til tidszone-API’et via en HTTPS-grænseflade, med anmodninger konstrueret som en URL-streng, der bruger bredde-/længdegradskoordinater til at angive location, en timestamp til at angive datoen og din API-nøgle.

Det følgende eksempel anmoder om tidszonedata for Washington, DC, USA, den 15. marts 2016 i JSON-format:

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

Du kan teste dette ved at indtaste URL’en i din webbrowser (sørg for at erstatte YOUR_API_KEY med din faktiske API-nøgle). Svaret indeholder tidszonedata for den angivne placering og dato (timestamp).

Se udviklerens vejledning for at få flere oplysninger om opbygning af anmodnings-URL’er og tilgængelige parametre samt forståelse af svaret.

Nedenfor vises et eksempel på et svar i JSON:

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

Begynd kodning med vores klientbiblioteker

Klientbiblioteker gør det nemmere at udvikle med Google Maps webservice-API’er ved at levere enkle, native implementeringer af almindelige opgaver såsom autentificering, begrænsning af anmodninger og automatisk gentagelse. Tidszone-API’en er tilgængelig i Java-klienten, Python-klienten, Go-klienten og Node.js-klienten for Google Maps-tjenester.

Autentifikation, kvoter, prisfastsættelse og politikker

Autentifikation

For at bruge tidszone-API’et skal du først aktivere API’et og indhente de korrekte autentifikationsoplysninger. Du kan finde flere oplysninger under Kom godt i gang med Google Maps Platform.

Kvoter og prisfastsættelse

Se siden om brug og fakturering for at få oplysninger om de kvoter og priser, der er fastsat for tidszone-API’en.

Politikker

Brug af tidszone-API’et skal være i overensstemmelse med API-politikkerne.

Lær mere

I tidszone-API’et kan du også angive en sprogparameter for at returnere resultater på andre sprog end standardsproget engelsk. Du kan se flere eksempler og andre oplysninger i Time Zone API Developer Guide.