Ringkasan Time Zone API

Time Zone API adalah layanan yang menerima permintaan HTTP dari koordinat lintang/bujur, serta tanggal dan waktu yang diinginkan. Metode ini menampilkan data zona waktu untuk lokasi, termasuk offset untuk UTC dan waktu musim panas.

Mengapa menggunakan Time Zone API

Dengan Time Zone API, Anda dapat mengembangkan aplikasi yang memberikan ID dan nama zona waktu untuk tanggal dan waktu di lokasi tertentu pada peta. Misalnya, Anda bisa menampilkan data zona waktu berikut:

  • Nama zona waktu yang dilokalkan untuk lokasi peta dari Google Maps Platform.
  • Offset zona waktu dari UTC dan untuk waktu musim panas.

Data zona waktu dapat sangat berguna saat Anda ingin situs atau aplikasi Anda menampilkan data berbasis waktu yang relevan dengan pengguna.

Yang dapat Anda lakukan dengan Time Zone API

Dengan Time Zone API, Anda dapat meminta zona waktu untuk lokasi di permukaan bumi, dengan selisih waktu dari UTC dan untuk waktu musim panas untuk masing-masing lokasi tersebut.

Cara kerja Time Zone API

Time Zone API menerima permintaan HTTPS untuk koordinat lintang/bujur, tanggal dan waktu yang diinginkan sebagai stempel waktu, serta kode bahasa (opsional). Metode ini menampilkan data dalam format yang ditentukan oleh permintaan. Contoh berikut menunjukkan permintaan untuk Nevada, AS, dengan output yang diminta dalam JSON.

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

Resource

Tabel berikut merangkum resource yang tersedia melalui Time Zone API bersama dengan data yang ditampilkannya.

Resource data Data yang ditampilkan Format pengembalian
Zona waktu

Anda mengirimkan permintaan beserta lokasi dan stempel waktu. Lihat parameter yang diperlukan.

  • ID zona waktu.
  • Nama zona waktu, dilokalkan secara opsional
  • Offset dari UTC, dalam detik
  • Offset untuk DST, dalam detik
  • Lihat Zona Waktu untuk contoh respons spesifik.
  • JSON
  • XML

Cara menggunakan Time Zone API

1 Memulai penyiapan Mulai dengan Menyiapkan project Google Cloud dan menyelesaikan petunjuk penyiapan yang mengikuti.
2 Mencoba permintaan zona waktu Setelah memiliki kunci API, Anda dapat mulai menguji Time Zone API langsung dari browser. Lihat contoh Zona Waktu di panduan Permintaan dan respons zona waktu untuk mengetahui detailnya.
3 Memahami dasar-dasar respons Pelajari cara menggunakan data zona waktu di aplikasi atau situs Anda. Lihat respons Zona Waktu untuk mengetahui detailnya.
5 Sertakan data zona waktu ke dalam aplikasi Anda sendiri. Anda dapat menggunakan data zona waktu untuk meningkatkan kualitas aplikasi dan situs bagi pengguna di berbagai lokal berbasis waktu.

Library klien yang tersedia

Panggil API ini dalam bahasa pilihan Anda melalui salah satu library klien berikut:

Klien Java, Klien Python, Klien Go, dan Klien Node.js untuk Layanan Google Maps adalah library klien open source yang didukung komunitas berdasarkan Lisensi Apache 2.0. Download aplikasi dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.

Langkah berikutnya