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:
- Login ke Portal Dukungan Google Cloud.
- 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.
- Penggunaan Maps dapat bervariasi pada halaman: Beban peta dihasilkan setiap kali objek
- 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
atauZERO_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 nilaichannel
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 kecustomer
, sementara departemen pemasaran internal Anda mungkin menggunakanchannel
yang ditetapkan kemkting
. 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 saluranCUSTOMER
akan digabungkan dengan penggunaan pada salurancustomer
. - 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.