Menyiapkan Time Zone API

Dokumen ini menjelaskan langkah-langkah yang Anda perlukan untuk mulai menggunakan Time Zone API.

Prasyarat

Prosedur ini memandu Anda menyiapkan Akun Google Cloud dan project Google Cloud dengan penagihan yang diaktifkan. Anda juga harus memahami cara penagihan untuk penggunaan Time Zone API.

1. Tinjau penagihan dan biaya penggunaan di Penggunaan dan Penagihan Time Zone API.

2. Pastikan Anda memiliki Akun Google Cloud.

   Login ke Konsol Google Cloud
   Catatan: Jika Anda adalah pengguna baru dan tidak memiliki Akun Google Cloud, yang berarti Anda tidak dapat login ke konsol, lihat Memulai Google Maps Platform.

3. Pastikan Anda memiliki project Google Cloud dengan penagihan yang diaktifkan.

   Buka halaman Penagihan
   Catatan: Jika Anda adalah pengguna baru dan tidak memiliki project Google Cloud, lihat Memulai Google Maps Platform.
1. Pilih project Anda untuk membuka halaman Billing.

2. Di halaman Penagihan:

   • Jika penagihan telah diaktifkan untuk project yang dipilih, dan Anda hanya memiliki satu akun penagihan, halaman Billing akan terbuka.
   • Jika Anda memiliki beberapa akun penagihan, pilih Go to linked billing account untuk melihat detail tentang akun penagihan yang terkait dengan project.
   • Jika sudah memiliki akun penagihan, tetapi belum dikaitkan dengan project, Anda akan diminta untuk menautkan akun penagihan dengan project.
   • Jika belum memiliki akun penagihan, atau Anda ingin membuat akun penagihan baru, pilih Manage Billing Accounts untuk membuat akun penagihan baru. Untuk mengetahui informasi selengkapnya, lihat Membuat akun Penagihan Cloud layanan mandiri baru.

Mengaktifkan API

Sebelum dapat menggunakan Time Zone API, Anda harus menggunakan Konsol Google Cloud atau perintah gcloud untuk mengaktifkannya di project Google Cloud Anda.

Catatan: Setelah mengaktifkan API, Anda mungkin harus menunggu beberapa menit sebelum dapat membuat permintaan ke API tersebut.

Untuk mengaktifkan API:

Konsol

1. Buka halaman produk di Konsol Google Cloud:

   Mengaktifkan Time Zone API

2. Klik tombol Enable.

   Catatan: Jika API sudah diaktifkan, Anda akan melihat tombol Manage, bukan Enable.

gcloud

gcloud services enable \
    --project "PROJECT" \
    "timezone-backend.googleapis.com"

Baca selengkapnya tentang Google Cloud SDK, Penginstalan Cloud SDK, dan perintah berikut:

• gcloud services enable
• gcloud services disable

Mendapatkan kunci API untuk digunakan dengan Time Zone API

Produk Google Maps Platform dilindungi dari penggunaan yang tidak sah dengan mewajibkan panggilan API menyertakan kunci API.

Kunci API adalah string alfanumerik unik yang mengaitkan akun Penagihan Cloud dan project Google Cloud Anda dengan permintaan yang dibuat aplikasi Anda ke API atau SDK Google Maps Platform. Untuk membuat kunci baru atau menambahkan API atau SDK ke kunci yang ada, ikuti petunjuk berikut.

Konsol

1. Buka halaman Google Maps Platform > Keys & Credentials.

   Buka halaman Keys & Credentials

2. Jika diminta, pilih project Anda.

3. Lakukan salah satu hal berikut:

   • Buat kunci baru:

     1. Klik Create credentials > API key.
     2. Di panel Buat kunci API, buka daftar Pilih batasan API.
     3. Hapus API yang tidak diperlukan oleh kunci ini, dan pastikan Time Zone API tetap dipilih.
     4. Klik Buat. Panel akan menampilkan kunci API baru Anda.

   • Menggunakan kunci yang ada:

     1. Klik nama kunci.
     2. Dalam daftar Select API restrictions, pilih Time Zone API.
     3. Klik Simpan.

   Memilih API di sini tidak akan mengaktifkannya. Pastikan Time Zone API diaktifkan di halaman Library API-nya.

4. Untuk melihat string kunci nanti, buka halaman Keys & Credentials, lalu klik Show key untuk kunci tersebut.

Jika konsol terlihat berbeda dari langkah-langkah ini, lihat Membuat kunci API dan Menambahkan pembatasan API dalam dokumentasi Google Cloud.

gcloud

Ganti PROJECT_ID dengan project ID Anda dalam perintah berikut.

• Buat kunci baru: Jalankan perintah berikut, dan ganti DISPLAY_NAME dengan nama untuk kunci.

  gcloud services api-keys create \
      --project="PROJECT_ID" \
      --display-name="DISPLAY_NAME" \
      --api-target=service=timezone-backend.googleapis.com

  Baca selengkapnya tentang Google Cloud SDK, Penginstalan Cloud SDK, dan perintah berikut:

  • gcloud services api-keys create

• Gunakan kunci yang ada: Jalankan perintah berikut, dan ganti KEY_ID dengan ID kunci. Flag --append mempertahankan API yang sudah diizinkan oleh kunci. Tanpa parameter ini, perintah akan menggantinya.

  gcloud services api-keys update KEY_ID \
      --project="PROJECT_ID" \
      --append \
      --api-target=service=timezone-backend.googleapis.com

  Baca selengkapnya tentang Google Cloud SDK, Penginstalan Cloud SDK, dan perintah berikut:

  • gcloud services api-keys update
  • gcloud services api-keys list

  ID kunci bukanlah string kunci atau nama tampilan. Untuk menemukannya, jalankan gcloud services api-keys list --project="PROJECT_ID". ID adalah bagian terakhir dari kolom name: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

Untuk melihat string kunci, jalankan gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID".

Membuat permintaan API

Buat permintaan API Time Zone untuk menampilkan respons JSON yang berisi informasi zona waktu untuk Nevada, Amerika Serikat. Stempel waktu ditetapkan ke 5 Desember 2024. Anda harus menyertakan string alfanumerik kunci API Anda dengan setiap permintaan dan menggunakan HTTPS untuk permintaan yang menyertakan kunci API.

1. Klik API_KEY dalam kode di bawah untuk menyisipkan string alfanumerik kunci:

   curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1733428634&key=YOUR_API_KEY'
   

2. Klik ikon salin di contoh kode, , untuk menyalin perintah curl.
3. Tempel perintah di jendela terminal dan jalankan perintah.

Responsnya adalah objek JSON dalam bentuk:

{
   "dstOffset" : 0,
   "rawOffset" : -28800,
   "status" : "OK",
   "timeZoneId" : "America/Los_Angeles",
   "timeZoneName" : "Pacific Standard Time"
}

Menerapkan pembatasan kunci API

Perhatian: Kunci API yang tidak dibatasi dapat digunakan untuk membuat permintaan ke semua layanan Google Maps Platform, termasuk Time Zone API. Anda bertanggung jawab secara finansial atas tagihan yang disebabkan oleh penyalahgunaan kunci API yang tidak dibatasi.

Google sangat menyarankan agar Anda membatasi penggunaan kunci API hanya untuk API dan aplikasi yang memerlukannya. Membatasi kunci API akan meningkatkan keamanan aplikasi Anda dengan melindunginya dari permintaan yang tidak sah. Kunci API mendukung dua jenis pembatasan:

• Pembatasan API menentukan SDK dan API mana yang dapat dipanggil menggunakan kunci API. Konsol dan gcloud CLI memerlukan setidaknya satu pembatasan API saat Anda membuat kunci.
• Pembatasan aplikasi menentukan situs, alamat IP, atau aplikasi mana yang dapat menggunakan kunci API.

Untuk mengetahui informasi selengkapnya tentang cara menerapkan pembatasan, lihat Membatasi kunci API Anda.

Langkah berikutnya

Setelah Anda mengaktifkan Time Zone API dan berhasil membuat permintaan, lihat Permintaan dan respons Time Zone untuk mempelajari lebih lanjut cara menggunakan API ini.