Mulai

Time Zone API menyediakan data selisih waktu untuk lokasi di permukaan bumi. Minta informasi zona waktu untuk tanggal dan pasangan lintang/bujur tertentu. API menampilkan nama zona waktu tersebut, selisih waktu dari UTC, dan pergeseran 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 ditetapkan 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'

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

Lihat panduan developer untuk informasi selengkapnya tentang membuat URL permintaan dan parameter yang tersedia dan memahami responsnya.

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 Google Maps Web Service API dengan menyediakan implementasi native tugas umum seperti autentikasi, permintaan throttling dan percobaan ulang otomatis. Time Zone API tersedia di Klien Java, Klien Python, Klien Go, dan Klien Node.js untuk Layanan Google Maps.

Autentikasi, kuota, harga, dan kebijakan

Autentikasi

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

Kuota dan harga

Meninjau 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 menetapkan parameter bahasa untuk menampilkan hasil dalam bahasa selain bahasa Inggris. Lihat API Zona Waktu Panduan Developer untuk melihat contoh dan detail lainnya.

Panduan Developer Time Zone API ditujukan untuk situs dan seluler developer yang ingin menyertakan data waktu pada peta yang disediakan oleh salah satu platform Google Maps Platform Google Cloud Platform. Panduan ini berisi pengantar tentang cara menggunakan API dan materi referensi pada parameter.