Time Zone API menyediakan data offset waktu untuk lokasi di permukaan bumi. Meminta informasi zona waktu untuk pasangan garis lintang/bujur dan tanggal tertentu. API menampilkan nama zona waktu tersebut, selisih waktu dari UTC, dan selisih waktu musim panas.
Contoh permintaan dan respons
Akses Time Zone API melalui antarmuka HTTPS, dengan
permintaan 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 ×tamp=1733428634 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1733428634&key=YOUR_API_KEY'
Anda dapat mengujinya dengan memasukkan URL ke browser 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 mengetahui informasi selengkapnya tentang cara membuat URL permintaan dan parameter yang tersedia serta cara 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 sederhana untuk tugas umum seperti autentikasi, pembatasan 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 artikel Memulai Google Maps Platform.
Kuota dan harga
Tinjau halaman penggunaan dan penagihan untuk mengetahui detail 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 default. Lihat Panduan Developer Time Zone API untuk mengetahui contoh lainnya dan detail lainnya.
Panduan Developer Time Zone API ditujukan bagi developer situs dan aplikasi seluler yang ingin menyertakan data waktu pada peta yang disediakan oleh salah satu API Google Maps Platform. Dokumen ini memberikan pengantar tentang penggunaan API dan materi referensi tentang parameter yang tersedia.