Mulai

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Time Zone API memberikan data perbedaan waktu untuk lokasi di permukaan bumi. Meminta informasi zona waktu untuk pasangan garis lintang/bujur tertentu dan tanggalnya. API ini menampilkan nama zona waktu tersebut, selisih waktu dari UTC, dan perbedaan waktu musim panas.

Contoh permintaan dan respons

Akses Time Zone API melalui antarmuka HTTPS, dengan permintaan yang dibuat sebagai string URL, menggunakan koordinat lintang/bujur untuk menentukan location, timestamp untuk menentukan tanggal, dan kunci API Anda.

Kueri berikut ini melakukan permintaan zona waktu untuk Nevada, AS. Stempel waktu disetel ke 8 Maret 2012.

URL

https://maps.googleapis.com/maps/api/timezone/json
  ?location=39.6034810%2C-119.6822510
  &timestamp=1331161200
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY'

JavaScript

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY',
  headers: { }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Python

import requests

url = "https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY")
  .method("GET", body)
  .build();
Response response = client.newCall(request).execute();

Ruby

require "uri"
require "net/http"

url = URI("https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body

Go

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1331161200&key=YOUR_API_KEY"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Tukang Pos

Spesifikasi OpenAPI juga tersedia sebagai koleksi Postman.

Berjalan di Postman

Anda dapat mengujinya dengan memasukkan URL ke browser web (pastikan untuk mengganti YOUR_API_KEY dengan kunci API Anda yang sebenarnya). Responsnya mencakup data zona waktu untuk lokasi dan tanggal yang ditentukan (timestamp).

Lihat panduan developer untuk mengetahui informasi selengkapnya tentang cara membuat URL permintaan dan parameter yang tersedia serta memahami respons.

Di bawah ini adalah contoh respons, dalam JSON:

JSON

{
  "dstOffset": 0,
  "rawOffset": -28800,
  "status": "OK",
  "timeZoneId": "America/Los_Angeles",
  "timeZoneName": "Pacific Standard Time",
}

XML

<TimeZoneResponse>
 <status>OK</status>
 <raw_offset>-28800.0000000</raw_offset>
 <dst_offset>0.0000000</dst_offset>
 <time_zone_id>America/Los_Angeles</time_zone_id>
 <time_zone_name>Pacific Standard Time</time_zone_name>
</TimeZoneResponse>

Memulai pengkodean dengan pustaka klien kami

Library klien mempermudah pengembangan dengan API layanan web Google Maps dengan menyediakan implementasi native yang sederhana dari tugas umum seperti autentikasi, throttling permintaan, dan percobaan ulang otomatis. Time Zone API tersedia di Java Client, Python Client, Go Client, dan Node.js Client untuk Layanan Google Maps.

Autentikasi, kuota, harga, dan kebijakan

Autentikasi

Untuk menggunakan Time Zone API, Anda harus mengaktifkan API terlebih dahulu dan mendapatkan kredensial autentikasi yang tepat. Untuk informasi selengkapnya, lihat Memulai Google Maps Platform.

Kuota dan harga

Tinjau halaman penggunaan dan penagihan untuk mengetahui detail tentang kuota dan harga yang ditetapkan untuk Time Zone API.

Kebijakan

Penggunaan Time Zone API harus sesuai dengan kebijakan API.

Pelajari lebih lanjut

Di Time Zone API, Anda juga dapat menyetel parameter bahasa untuk menampilkan hasil dalam bahasa selain bahasa Inggris default. Lihat Panduan Developer Time Zone API untuk contoh dan detail lainnya.

Panduan Developer Time Zone API ditujukan untuk developer situs dan seluler yang ingin menyertakan data waktu pada peta yang disediakan oleh salah satu API Google Maps Platform. Bagian ini menyediakan pengantar tentang penggunaan API dan materi referensi tentang parameter yang tersedia.