Laporan Penggunaan Premium Plan

Catatan: Premium Plan Google Maps Platform tidak lagi tersedia untuk pendaftar atau pelanggan baru.

Halaman ini hanya untuk pelanggan dengan Premium Plan Google Maps Platform versi baru, yang telah tersedia pada Januari 2016.

Punya Premium Plan atau lisensi sebelumnya?
Untuk mengetahui lisensi yang Anda miliki:
> Di Portal Dukungan Google Cloud, klik Maps: Laporan Penggunaan di sebelah kiri.
> Apakah ID di bagian atas laporan memiliki format berikut?
   gme-[company] & proj-[number] ([type])
Jika ya, Anda memiliki Premium Plan.
Jika tidak, berarti Anda memiliki lisensi sebelumnya (Maps API for Work atau Maps API for Business).

Ringkasan

Sebagai pelanggan Premium Plan, Anda dapat menggunakan alat Laporan Penggunaan Google Maps untuk melacak penggunaan aplikasi Google Maps Platform dan pemakaian Kredit Maps API. Dengan alat ini, Anda dapat melihat laporan detail harian dan bulanan tentang semua API yang disertakan bersama Premium Plan Google Maps Platform. Data laporan tersedia untuk permintaan API yang menyertakan client ID atau project ID.

Catatan: Alat Laporan Penggunaan menyediakan informasi sama seperti yang digunakan Google untuk menentukan penggunaan aplikasi Anda untuk tujuan penagihan.

Jenis laporan

Laporan Permintaan yang Berhasil

Laporan ini menunjukkan jumlah permintaan aplikasi per hari atau per bulan untuk masing-masing API. Gunakan laporan ini untuk membandingkan penggunaan pada periode waktu yang berbeda untuk mengidentifikasi tren dan waktu pemakaian puncak. Selain itu, Anda dapat menggunakan Laporan Permintaan yang Berhasil untuk menampilkan data berikut:

  • Error permintaan: Untuk masing-masing API, laporan harian juga menunjukkan jumlah permintaan yang berhasil dan gagal (error); untuk Web Service API yang diakses aplikasi Anda menggunakan client ID, laporan ini juga menunjukkan kode error, yang berguna untuk memecahkan masalah.
  • Data saluran: Jika Anda menyertakan parameter saluran dalam permintaan, Anda dapat membuat Laporan Permintaan yang Berhasil yang menunjukkan pengelompokan permintaan API aplikasi Anda di berbagai aplikasi yang menggunakan client ID yang sama (seperti akses untuk eksternal vs. akses untuk internal). Dengan menggunakan saluran, Anda dapat membuat laporan dengan data yang lebih detail tentang cara penggunaan aplikasi.

Laporan Kredit Maps API

Laporan ini menunjukkan jumlah pemakaian kredit aplikasi Anda per hari atau per bulan untuk semua gabungan API. Gunakan laporan ini untuk menentukan berapa banyak kredit yang akan dibeli. Untuk informasi tentang cara pemakaian kredit di aplikasi Anda, lihat Tarif dan Batas Penggunaan.

Fitur laporan

  • Grafik yang mudah dibaca: Laporan harian menyediakan grafik untuk membantu Anda memvisualisasikan tren penggunaan dari waktu ke waktu. Anda dapat melihat detail laporan dengan mengarahkan kursor ke atas grafik.

  • Data historis: Menampilkan laporan untuk setiap periode waktu dalam satu tahun terakhir.
  • Data yang dapat didownload: Mendownload permintaan bulanan dan total kredit ke file (CSV) nilai yang dipisahkan koma untuk analisis lebih lanjut menggunakan spreadsheet atau alat business intelligence, atau untuk berbagi data dengan orang lain.
  • Lihat perincian data: Mengakses laporan harian langsung dari laporan bulanan, dengan mengklik total bulanan atau judul kolom dalam laporan. Contoh:

Mengakses Laporan Penggunaan

Untuk mengakses Laporan Penggunaan Google Maps:

  1. Login ke Portal Dukungan Google Cloud.
  2. Di panel sebelah kiri, klik Maps: Laporan Penggunaan.

Membuat laporan

Laporan default adalah laporan Permintaan yang Berhasil bulanan selama 12 bulan terakhir. Untuk membuat laporan yang berbeda, gunakan filter laporan:

Filter Deskripsi
Client ID
Hanya tersedia jika Anda memiliki beberapa client ID. Pilih client ID yang ingin Anda tampilkan laporannya.
ID saluran
Hanya tersedia untuk laporan Permintaan yang Berhasil. Pilih saluran yang ingin Anda lihat data penggunaannya. Atau pilih Tampilkan semua untuk melihat data penggunaan bagi semua saluran.
Dari / Hingga Pilih rentang tanggal hingga 1 tahun untuk laporan. Klik Update untuk membuat laporan baru.
Jenis laporan
Pilih laporan Permintaan yang Berhasil atau Kredit Maps API.
Pilih granularitas waktu Pilih laporan Bulanan atau Harian. Laporan bulanan juga berisi link ke laporan harian. Laporan harian menampilkan permintaan yang berhasil dan gagal serta kode error.
Jenis API Hanya tersedia untuk laporan harian. Pilih API yang ingin Anda lihat laporannya.

Pertanyaan Umum (FAQ)

Laporan Permintaan yang Berhasil

Berapa lama waktu yang dibutuhkan untuk menampilkan data penggunaan pada laporan?

Data laporan tidak tersedia secara real-time. Data penggunaan untuk permintaan yang menggunakan client ID diproses setiap hari. Karena tanggal laporan didasarkan pada Waktu Standar Pasifik, Anda mungkin mengalami keterlambatan hingga dua hari. Data untuk permintaan yang menggunakan kunci API memerlukan pemrosesan tambahan, dan bisa memakan waktu hingga empat hari untuk muncul pada laporan.

Apa yang dimaksud dengan beban peta Maps JavaScript API? Apa perbedaannya dengan kunjungan halaman?

Dengan Premium Plan Google Maps Platform, penggunaan Maps JavaScript API ditentukan oleh beban peta—yaitu, saat peta benar-benar ditampilkan di halaman. Beban peta berbeda dengan kunjungan halaman, yang digunakan untuk menghitung penggunaan Maps JavaScript API dengan lisensi Maps API for Business atau Maps API for Work sebelumnya. Untuk informasi selengkapnya, lihat Tarif dan Batas Penggunaan.

Mengapa jumlah beban peta tidak cocok dengan statistik akses pada server web kami?

Berikut adalah beberapa alasan mengapa jumlah beban peta pada halaman berbeda dengan jumlah hit ke URL tersebut di log server web Anda:

  • Penggunaan Maps dapat bervariasi pada halaman: Beban peta dihasilkan setiap kali objek google.maps.Map dibuat pada halaman. Saat membandingkan laporan beban peta dengan statistik akses server web Anda, analisis penggunaan peta pada setiap halaman web dengan cermat untuk mencari penyebab perbedaan, seperti:
    • Halaman memiliki lebih dari satu peta, sehingga beberapa objek Map dibuat.
    • Halaman tidak menampilkan peta, tetapi objek Map masih tetap dibuat. Hal ini dapat terjadi, misalnya, jika objek Map melekat pada elemen div HTML yang tersembunyi.
    • Halaman mewajibkan pengguna melakukan tindakan (seperti klik tombol) untuk menampilkan peta. Jika pengguna tidak melakukan tindakan tersebut, objek Map tidak dibuat.
    • Halaman tidak memiliki peta apa pun, sehingga objek Map tidak dibuat.
  • Zona waktu berbeda: Laporan berasal dari log yang ditetapkan ke Zona Waktu Pasifik. Anda dapat menganalisis log server berdasarkan Zona Waktu Pasifik untuk mengurangi offset karena memasukkan zona waktu lokal.
  • HTML di-cache: Beban peta tidak di-cache. Jika pengguna memuat ulang halaman Anda, pemuatan ulang akan menghasilkan beban peta lain untuk mendapatkan token sesi. Namun, dalam kasus ini, browser mungkin memuat HTML dari cache, sehingga menyebabkan jumlah beban peta lebih tinggi dari jumlah hit di log server Anda.
Mengapa permintaan lebih tinggi dari yang diharapkan untuk Distance Matrix API?

Laporan Distance Matrix API menampilkan jumlah elemen (pasangan asal-tujuan) dan bukan permintaan. Untuk detail tentang elemen, lihat panduan developer.

Error permintaan

Bagaimana cara menampilkan error permintaan aplikasi saya?

Buat laporan harian Permintaan yang Berhasil, lalu pilih API dari daftar jenis API. Anda akan melihat grafik dan tabel yang menunjukkan jumlah permintaan yang berhasil dan gagal yang dibuat aplikasi; untuk Web Service API yang diakses aplikasi menggunakan client ID, Anda juga akan melihat kode status dikembalikan oleh permintaan tersebut:

Apa arti dari kode status?

Alat laporan penggunaan menunjukkan kode status untuk Web Service API yang diakses aplikasi Anda menggunakan client ID. Anda dapat menemukan deskripsi kode dalam panduan developer untuk masing-masing API:

Geolocation API, Places API, dan Roads API selalu memerlukan kunci API. Untuk API ini dan API lainnya yang diakses aplikasi Anda menggunakan kunci, periksa Konsol Developer Anda untuk kode statusnya.

Apakah error akan memakai Kredit Maps API?

Tidak, permintaan yang menerima kode error tidak akan memakai kredit. Namun, permintaan yang menerima kode OK atau ZERO_RESULTS akan memakai kredit.

Data saluran

Apa yang dimaksud dengan saluran?

Untuk melacak penggunaan di berbagai aplikasi menggunakan client ID atau kunci API yang sama, Anda dapat menggunakan parameter channel dengan permintaan API. Dengan menetapkan nilai channel yang berbeda untuk berbagai aspek aplikasi, Anda dapat menentukan dengan tepat cara aplikasi digunakan.

Misalnya, situs eksternal Anda mungkin mengakses API menggunakan channel yang ditetapkan ke customer, sementara departemen pemasaran internal Anda mungkin menggunakan channel yang ditetapkan ke mkting. Laporan Anda akan memerinci penggunaan API menurut nilai saluran tersebut.

API mana saja yang mendukung saluran?

Pelaporan saluran tersedia untuk aplikasi yang menggunakan Maps JavaScript API, Maps Static API, Street View Static API, dan layanan web Google Maps Platform. Saluran tidak tersedia untuk Geolocation API, Places API, Roads API, dan Maps Mobile SDK.

Berapa banyak saluran yang dapat saya gunakan?

Anda dapat menggunakan hingga 2.000 saluran yang berbeda per client ID atau kunci API.

Bagaimana cara mempersiapkan saluran untuk permintaan aplikasi saya?

Pastikan nilai channel dalam permintaan Anda memenuhi persyaratan berikut:

  • Harus berupa string alfanumerik ASCII.
  • Dapat menyertakan karakter garis bawah (_) dan tanda hubung (-).
  • Tidak peka huruf besar/kecil: Parameter channel huruf besar dan huruf besar/kecil digabung menjadi setara dengan huruf kecil. Misalnya, penggunaan pada saluran CUSTOMER akan digabungkan dengan penggunaan pada saluran customer.
  • Harus statis dan ditetapkan per instance aplikasi (tidak dapat dihasilkan secara dinamis). Misalnya, Anda tidak dapat menggunakan nilai saluran untuk melacak pengguna perorangan.

Menambahkan parameter saluran ke permintaan Anda, sebagai berikut:

API sisi klien

Tambahkan parameter saluran ke nilai src dari tag skrip Anda:

<script src="https://maps.googleapis.com/maps/api/js?v=3
&client=gme-yourclientid
&channel=your_channel"></script>

Maps Static API dan Street View Static API

Sertakan parameter saluran ini di URL permintaan:

https://maps.googleapis.com/maps/api/staticmap
?center=15.800513,-47.91378
&zoom=11
&size=300x300
&client=gme-yourclientid
&channel=your_channel
&signature=your_signature

Web service

Sertakan parameter saluran ini di URL permintaan:

https://maps.googleapis.com/maps/api/geocode/json
?address=101+Main+St
&client=gme-yourclientid
&channel=your_channel
&signature=your_signature

Laporan Kredit Maps API

Apa yang dimaksud dengan Kredit Maps API?

Permintaan aplikasi Anda ke API akan memakai Kredit Maps API dari paket kredit yang Anda beli dengan Premium Plan Google Maps Platform. Untuk informasi selengkapnya tentang kredit dan cara pemakaiannya di aplikasi Anda, lihat Tarif dan Batas Penggunaan.

Berapa lama waktu yang dibutuhkan untuk menampilkan data kredit pada laporan?

Data pemakaian kredit untuk Laporan Penggunaan Google Maps membutuhkan pemrosesan dan perlu waktu hingga 3 hari untuk muncul pada laporan.