
Time Zone API adalah layanan yang menerima permintaan HTTP koordinat lintang/bujur serta tanggal dan waktu yang diinginkan. Metode ini menampilkan data
zona waktu untuk lokasi tersebut, termasuk offset untuk UTC dan waktu musim
panas.
Alasan menggunakan Time Zone API
Dengan Time Zone API, Anda dapat mengembangkan aplikasi yang memberikan ID zona waktu dan nama untuk tanggal dan waktu di lokasi tertentu pada peta. Misalnya, Anda dapat menampilkan data zona waktu berikut:
- 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 dapat sangat berguna jika Anda ingin situs atau aplikasi menampilkan data berbasis waktu yang relevan kepada 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 waktu musim panas untuk setiap lokasi tersebut.
Cara kerja Time Zone API
Time Zone API menerima permintaan HTTPS koordinat lintang/bujur, tanggal dan waktu yang diinginkan sebagai stempel waktu, dan secara opsional, kode bahasa. 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 ×tamp=1331161200 &key=YOUR_API_KEY
Referensi
Tabel berikut merangkum resource yang tersedia melalui Time Zone API beserta data yang ditampilkan.
Resource data | Data yang ditampilkan | Format pengembalian |
---|---|---|
Zona waktu
Anda memberikan permintaan Anda bersama dengan lokasi dan stempel waktu. Lihat parameter yang diperlukan. |
|
|
Cara menggunakan Time Zone API
1 | Memulai persiapan | Mulailah dengan Menyiapkan project Google Cloud Anda dan selesaikan petunjuk penyiapan yang mengikutinya. |
2 | Coba 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 | Gabungkan data zona waktu ke dalam aplikasi Anda sendiri. | Anda dapat menggunakan data zona waktu untuk meningkatkan kualitas aplikasi dan situs bagi pengguna di berbagai lokalitas berbasis waktu. |
Library klien yang tersedia
Panggil API ini dalam bahasa pilihan Anda melalui salah satu library klien berikut:
- Klien Java untuk Layanan Google Maps
- Klien Python untuk Layanan Google Maps
- Klien Go untuk Layanan Google Maps
- Klien Node.js untuk Layanan Google Maps
Klien Java, Klien Python, Klien Go, dan Klien Node.js untuk Layanan Google Maps adalah library klien yang didukung komunitas, dan merupakan open source berdasarkan Lisensi Apache 2.0. Download dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.
Langkah berikutnya
- Pelajari cara membuat permintaan Zona Waktu: Buka Permintaan dan respons Zona Waktu.
- Ikuti praktik terbaik: Buka Praktik Terbaik Layanan Web.