Ringkasan Time Zone API

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

Alasan menggunakan Time Zone API

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

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

Data zona waktu bisa sangat berguna ketika Anda ingin memiliki situs atau aplikasi Anda menampilkan data berbasis waktu yang relevan dengan pengguna Anda.

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 berbagai lokasi tersebut.

Cara kerja Time Zone API

Time Zone API menerima permintaan HTTPS garis lintang/bujur tanggal dan waktu yang diinginkan sebagai stempel waktu, dan jika perlu, kode bahasa. Fungsi ini menampilkan data dalam format yang ditentukan oleh permintaan. Contoh berikut menunjukkan permintaan untuk Nevada, Amerika Serikat, dengan output yang diminta di JSON.

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

Resource

Tabel berikut meringkas sumber daya yang tersedia melalui Time Zone API beserta data yang ditampilkan.

Resource data Data yang dikembalikan Format pengembalian
Zona waktu

Anda memberikan permintaan Anda beserta lokasi dan stempel waktu. Lihat wajib diisi parameter.

  • 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 tertentu.
  • JSON
  • XML

Cara menggunakan Time Zone API

1 Melakukan penyiapan Mulailah dengan Menyiapkan Project Google Cloud dan selesaikan penyiapan petunjuk yang mengikutinya.
2 Mencoba permintaan zona waktu Setelah memiliki kunci API, Anda dapat mulai menguji Time Zone API secara langsung dari browser Anda. 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 seluruh lokalitas berbasis waktu yang berbeda.

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 Google Maps Layanan adalah library klien yang didukung komunitas, yang bersifat open source di bawah Lisensi Apache 2.0. Download semuanya dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.

Langkah berikutnya