Google Maps Usage Reports

Laman ini hanya untuk pelanggan yang memiliki versi baru Google Maps APIs Premium Plan, yang tersedia pada Januari 2016.

Apakah sebelumnya sudah memiliki Maps APIs for Work atau lisensi Maps API for Business? Lihat panduan Lisensi Maps APIs for Work kami. Untuk menentukan apakah Anda memiliki lisensi sebelumnya: Di Google Cloud Support Portal, klik Maps: Usage Report di sebelah kiri. Jika ID di bagian atas laporan ada dalam format berikut, berarti Anda memiliki Premium Plan baru:
gme-[perusahaan] & proj-[nomor] ([tipe])
jika tidak, berarti Anda memiliki lisensi sebelumnya.

Ringkasan

Alat (bantu) Google Maps Usage Reports membantu Anda melacak penggunaan aplikasi dari Google Maps APIs dan pemakaian Kredit Maps API. Dengan alat (bantu) ini, Anda bisa menampilkan laporan detail harian dan bulanan pada semua API yang disertakan bersama Google Maps APIs Premium Plan. Data laporan tersedia untuk permintaan API yang menyertakan ID klien atau ID proyek.

Catatan: Alat (bantu) Usage Reports menyediakan informasi sama seperti yang digunakan Google untuk menentukan penggunaan aplikasi Anda untuk tujuan penagihan.

Tipe laporan

Laporan Permintaan Sukses

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 bisa menggunakan laporan Permintaan Sukses untuk menampilkan data berikut:

  • Kesalahan permintaan: Untuk setiap API, laporan harian juga menunjukkan jumlah permintaan sukses dan gagal (kesalahan); untuk Web Service API yang diakses aplikasi Anda menggunakan ID klien, laporan ini juga menunjukkan kode kesalahan, yang berguna untuk memecahkan masalah.
  • Data saluran: Jika Anda menyertakan parameter saluran dalam permintaan, Anda bisa menghasilkan laporan Permintaan Sukses yang menunjukkan perincian dari permintaan API aplikasi Anda di aplikasi berbeda yang menggunakan ID klien yang sama (seperti akses hadap eksternal vs. akses hadap internal). Dengan menggunakan saluran, Anda bisa menghasilkan laporan dengan data yang lebih detail tentang bagaimana aplikasi digunakan.

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 aplikasi Anda menggunakan kredit lihat Batas dan Biaya Penggunaan.

Fitur laporan

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

  • Data historis: Menampilkan laporan untuk setiap periode waktu dalam satu tahun terakhir.
  • Data dapat diunduh: Mengunduh permintaan bulanan dan jumlah kredit ke file (CSV) nilai-terpisah koma untuk analisis lebih lanjut menggunakan spreadsheet atau alat intelijen bisnis, atau untuk berbagi data dengan orang lain.
  • Data drill-down: Mengakses laporan harian secara langsung dari laporan bulanan, dengan mengeklik jumlah bulanan atau judul kolom dalam laporan. Misalnya:

    <img src="/maps/premium/reports/images/usage_rep_mo_total.png" width="200px" /" style="float: left; width: 30%; margin-right: 1%; margin-bottom: 0.5em;"><img src="/maps/premium/reports/images/usage_rep_mo_heading.png" width="200px" /" style="float: left; width: 30%; margin-right: 1%; margin-bottom: 0.5em;">

Mengakses Usage Reports

Untuk mengakses Google Maps Usage Reports:

  1. Masuk ke Google Cloud Support Portal.
  2. Pada panel sebelah kiri, klik Maps: Usage Report.

Menghasilkan laporan

Laporan default adalah laporan Permintaan Sukses tiap bulan selama 12 bulan terakhir. Untuk menghasilkan laporan yang berbeda, gunakan filter laporan:

Filter Keterangan
Client ID
Hanya tersedia jika Anda memiliki beberapa ID klien. Pilih ID klien yang ingin Anda tampilkan laporannya.
Channel ID
Hanya tersedia untuk laporan Permintaan Sukses. Pilih saluran yang ingin Anda lihat data penggunaannya. Atau pilih Show all untuk melihat data penggunaan semua saluran.
From / To Pilih rentang tanggal hingga 1 tahun untuk laporan. Klik Update untuk menghasilkan laporan baru.
Type of report
Pilih laporan Successful Requests atau Maps APIs Credits .
Pilih granularitas waktu Pilih laporan Monthly atau Daily . Laporan bulanan juga berisi tautan ke laporan harian. Laporan harian menampilkan kedua permintaan sukses dan gagal dan kode kesalahan.
API type Hanya tersedia untuk laporan harian. Pilih API yang ingin Anda lihat laporannya.

Pertanyaan Umum (FAQ)

Laporan Permintaan Sukses

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

Data laporan tidak tersedia secara real-time. Data penggunaan untuk permintaan yang menggunakan ID klien diproses setiap hari. Karena tanggal laporan didasarkan pada Pacific Standard Time, Anda mungkin mengalami keterlambatan 1 atau 2 hari. Data untuk permintaan yang menggunakan kunci API memerlukan pengolahan tambahan dan bisa memakan waktu hingga 3 hari untuk muncul pada laporan.

Apa yang dimaksud dengan pemuatan peta Google Maps JavaScript API? Apa yang membedakan mereka dari penayangan laman?

Dengan Google Maps APIs Premium Plan, penggunaan Google Maps JavaScript API ditentukan oleh pemuatan peta—yaitu, ketika peta benar-benar ditampilkan pada laman. Pemuatan peta berbeda dari penayangan laman, yang digunakan untuk menghitung penggunaan Maps JavaScript API dengan Maps API for Business sebelumnya atau lisensi Maps APIs for Work. Untuk informasi selengkapnya, lihat Batas dan Biaya Penggunaan.

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

Berikut adalah beberapa alasan mengapa jumlah pemuatan peta pada laman berbeda dari jumlah kunjungan ke URL dalam log server web Anda:

  • Penggunaan peta bisa bervariasi dalam sebuah laman: Pemuatan peta dihasilkan setiap kali objek google.maps.Map dibuat pada laman. Ketika membandingkan laporan pemuatan peta dengan statistik akses server web Anda, lakukan analisis penggunaan peta pada setiap laman web dengan saksama untuk mencari penyebab perbedaan, seperti:
    • Laman memiliki lebih dari satu peta, sehingga dibuat beberapa objek Map.
    • Laman tidak menampilkan peta, namun objek Map masih tetap dibuat. Ini bisa terjadi, misalnya, jika objek Map melekat pada elemen div HTML yang tersembunyi.
    • Laman mengharuskan pengguna untuk melakukan aksi (seperti klik tombol) untuk menampilkan peta. Jika pengguna tidak melakukan aksi tersebut, objek Map tidak dibuat.
    • Laman tidak memiliki peta apa pun, sehingga objek Map tidak dibuat.
  • Zona waktu yang berbeda: Laporan berasal dari log yang disetel ke Pacific Time Zone. Anda bisa menganalisis log server berdasarkan Pacific Time Zone untuk mengurangi offset karena memasukkan zona waktu lokal.
  • HTML di-cache: Pemuatan peta tidak di-cache. Jika pengguna memuat ulang laman Anda, pemuatan ulang akan menghasilkan pemuatan peta lain untuk mendapatkan token sesi. Namun, dalam kasus ini, browser mungkin memuat HTML dari cache, menyebabkan jumlah pemuatan peta lebih tinggi dari jumlah kunjungan dalam log server Anda.
Mengapa permintaan lebih tinggi dari yang diperkirakan untuk Google Maps Distance Matrix API?

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

Kesalahan permintaan

Bagaimana cara menampilkan kesalahan permintaan aplikasi saya?

Hasilkan laporan harian Permintaan Sukses, lalu pilih API dari daftar API type. Anda akan melihat grafik dan tabel yang menunjukkan jumlah permintaan sukses dan gagal yang dibuat aplikasi; untuk Web Service API yang diakses aplikasi menggunakan ID klien, 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 ID klien. Anda bisa menemukan keterangan tentang kode dalam panduan developer untuk setiap API:

Geolocation API, Places API, dan Roads API selalu membutuhkan kunci API. Untuk API ini dan lainnya yang diakses aplikasi Anda menggunakan kunci, periksa Developers Console untuk kode status.

Apakah kesalahan mengonsumsi Kredit Maps API?

Tidak, permintaan yang menerima kode kesalahan tidak mengonsumsi kredit. Namun, permintaan yang menerima kode OK atau ZERO_RESULTS memang mengonsumsi kredit.

Data saluran

Apa yang dimaksud dengan saluran?

Untuk melacak penggunaan berbagai aplikasi yang berbeda menggunakan ID klien yang sama, Anda bisa menggunakan parameter channel bersama permintaan API. Dengan menetapkan nilai channel yang berbeda untuk berbagai aspek aplikasi, Anda bisa menentukan secara tepat bagaimana aplikasi digunakan.

Misalnya, situs web eksternal mungkin mengakses API menggunakan channel yang disetel ke customer, sementara departemen pemasaran internal mungkin menggunakan channel yang disetel ke mkting. Laporan Anda akan memecah penggunaan API dengan nilai saluran tersebut.

API mana yang mendukung saluran?

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

Berapa banyak saluran yang bisa saya gunakan?

Anda bisa menggunakan hingga 2.000 saluran yang berbeda per ID klien.

Bagaimana cara mempersiapkan saluran untuk permintaan aplikasi saya?

Pastikan nilai channel dalam permintaan Anda memenuhi persyaratan berikut:

  • Harus berupa string alfanumerik ASCII.
  • Bisa menyertakan karakter titik (.), setrip bawah (_) dan tanda hubung (-).
  • Memperhatikan kapitalisasi: Huruf-besar dan huruf-campuran parameter channel akan dikombinasikan menjadi huruf-kecil yang ekuivalen. Misalnya, penggunaan pada saluran CUSTOMER akan dikombinasikan dengan penggunaan saluran customer.
  • Harus statis dan ditetapkan per instance aplikasi (tidak dapat dihasilkan secara dinamis). Misalnya, Anda tidak bisa menggunakan nilai saluran untuk melacak pengguna individu.

Menambahkan parameter saluran ke permintaan Anda, sebagai berikut:

Client-side API

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>

Static Maps dan Street View 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 memakai Kredit Maps API dari paket kredit yang Anda beli dengan Google Maps APIs Premium Plan. Untuk informasi selengkapnya tentang kredit dan bagaimana aplikasi Anda memakainya, lihat Batas dan Biaya Penggunaan.

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

Data pemakaian kredit untuk Google Maps Usage Reports memerlukan pengolahan dan bisa memakan waktu hingga 3 hari untuk muncul pada laporan.