Pelaporan Google Maps Platform

Anda harus memantau angka penggunaan, kuota, dan penagihan Google Maps Platform secara berkala. Memantau semua angka ini dapat membantu Anda melacak permintaan yang dibuat oleh project, tetap berada dalam batas konsumsi yang telah ditentukan, dan mengontrol biaya melalui anggaran terencana. Pemantauan ini juga dapat mendeteksi interaksi tak terduga yang mungkin terjadi antara project Anda dan layanan Google Maps Platform.

Cloud Console

Memantau angka penggunaan, kuota, dan penagihan Google Maps Platform Anda menggunakan Google Cloud Console (disebut juga sebagai Cloud Console).

API & Layanan

API & Layanan Cloud Console menyediakan metrik penggunaan untuk semua API yang diaktifkan untuk project Anda: Google Maps Platform API dan SDK-nya serta Google API dan layanannya yang lain.

API & Layanan

Untuk mengakses API & Layanan:

  1. Buka Cloud Console.
  2. Pilih project.
  3. Klik tombol menu menu lalu klik API & Layanan.

Google Maps Platform

Google Maps Platform Cloud Console menyediakan metrik penggunaan dan kuota hanya untuk Google Maps Platform API dan SDK-nya (selanjutnya disebut sebagai Google Maps Platform API atau API saja).

Dasbor Google Maps

Untuk mengakses Google Maps Platform:

  1. Buka Cloud Console.
  2. Pilih project.
  3. Klik tombol menu menu, scroll ke bawah ke PRODUK GOOGLE LAINNYA, lalu klik Google Maps Platform.

Penagihan

Penagihan Cloud Console menyediakan informasi penagihan dan biaya terkait untuk project yang Anda pilih.

Dasbor penagihan

Untuk mengakses Penagihan:

  1. Buka Cloud Console.
  2. Pilih project.
  3. Klik tombol menu menu lalu klik Penagihan.
  4. Jika Anda memiliki beberapa akun penagihan, klik Buka akun penagihan yang ditautkan.
    Anda akan diarahkan ke halaman Ringkasan untuk akun penagihan yang ditautkan.
  5. Di menu kiri, klik Laporan.
    Anda akan diarahkan ke halaman Laporan penagihan untuk akun penagihan yang ditautkan.

Laporan penggunaan

Penggunaan didasarkan pada jumlah permintaan yang dibuat oleh project Anda ke Google Maps Platform API menggunakan kredensial yang dikaitkan dengan project Anda. Permintaan mencakup permintaan yang berhasil, permintaan yang menyebabkan error server, dan permintaan yang menyebabkan error klien. Kredensial mencakup kunci API dan client ID (untuk project Premium Plan dan Premium Plan yang dimigrasikan).

Metrik penggunaan ditampilkan dalam tabel (Permintaan, Error, dan Latensi) dan grafik (Traffic, Error, dan Latensi). Untuk tujuan pelacakan:

  • Metrik penggunaan untuk semua API dapat difilter menurut jangka waktu dan API; Anda juga dapat melihat traffic, error, dan latensi yang dikelompokkan berdasarkan kode respons, API, dan kredensial.
  • Metrik penggunaan untuk API tertentu dapat difilter menurut jangka waktu dan versi, kredensial, dan metode API; Anda juga dapat melihat traffic, error, dan latensi yang dikelompokkan menurut kode respons, metode dan versi API, serta kredensial.

Halaman Dasbor API & Layanan

Halaman Dasbor API & Layanan menyediakan ringkasan metrik penggunaan untuk semua API yang diaktifkan untuk project Anda (Google Maps Platform API serta API dan layanan lainnya).

Halaman Dasbor menampilkan tiga grafik dan satu tabel. Anda dapat memfilter penggunaan yang ditampilkan dalam grafik dan tabel dengan memilih jangka waktu (dari 1 jam hingga 30 hari terakhir).

Grafik Traffic menampilkan penggunaan dalam kueri per detik (QPS) per API. Grafik Error menampilkan persentase permintaan yang mengakibatkan error per API. Grafik Latensi menampilkan latensi median permintaan per API.

Di bawah grafik, tabel mencantumkan API dan layanan yang diaktifkan. Permintaan adalah jumlah permintaan (untuk jangka waktu yang dipilih). Error adalah jumlah permintaan yang mengakibatkan error. Latensi (latensi sedang dan persentil) adalah latensi untuk permintaan ini.

Untuk informasi selengkapnya, lihat Memantau Penggunaan API.

memantau API

Halaman Ringkasan Google Maps

Halaman Ringkasan Google Maps menyertakan tabel yang mencantumkan API yang diaktifkan dan permintaan penggunaan selama 30 hari terakhir. Permintaan oleh API juga ditampilkan dalam bentuk grafik. Grafik penagihan menampilkan tagihan Anda saat ini dan total penggunaan selama 3 bulan terakhir.

Catatan: Jika mengklik nama API yang diaktifkan, Anda akan diarahkan ke halaman Metrik Google Maps untuk API tersebut.

ringkasan

Halaman Google Maps Platform API

Halaman API Google Maps berisi dua tabel. Tabel API yang Diaktifkan menampilkan jumlah permintaan, jumlah error, dan latensi rata-rata untuk setiap API yang diaktifkan selama 30 hari terakhir. Tabel API Tambahan mencantumkan API yang belum diaktifkan (oleh karena itu, tidak ada penggunaan yang dilaporkan).

Catatan: Jika mengklik nama API yang diaktifkan, Anda akan diarahkan ke halaman Metrik Google Maps untuk API tersebut.

API

Halaman Metrik Google Maps

Halaman Metrik Google Maps menampilkan tiga grafik: Traffic, Error, dan Latensi Median. Data penggunaan dalam grafik dapat dikelompokkan berdasarkan Kode Respons, API, metode API, atau Kredensial.

Di bawah grafik, halaman Metrik menyertakan tabel API yang menampilkan permintaan, error, dan latensi untuk API yang telah Anda pilih.

Dengan menggunakan drop-down API di bagian atas, dan opsi pemfilteran di panel kanan, Anda dapat memfilter metrik penggunaan yang ditampilkan dengan memilih satu atau beberapa API, Kredensial, dan/atau Kode Respons. Anda juga dapat memilih jangka waktu (dari 1 jam hingga 30 hari terakhir) dan perincian (per detik atau per hari) untuk metrik penggunaan yang ditampilkan.

metrik

Grafik kode respons

Grafik Traffic menurut kode respons dan Grafik Error menurut kode respons akan membagi penggunaan menurut class kode respons. Tabel di bawah ini menampilkan pemetaan antara status respons dan class kode respons Google Maps Platform API:

Status Respons Class Kode Respons
(2xx, 3xx, 4xx, 5xx)
Catatan
OK 2xx Respons yang berhasil.

Ini adalah permintaan yang dapat ditagih dan akan menghabiskan kuota.
OK 3xx Respons yang berhasil.

Ini adalah permintaan yang dapat ditagih dan akan menghabiskan kuota.

Misalnya, permintaan Place Photo yang berhasil akan menampilkan pengalihan 302 ke gambar yang direferensikan.
DATA_NOT_AVAILABLE 2xx Respons yang berhasil menunjukkan bahwa tidak ada data yang tersedia untuk lokasi input.

Ini adalah permintaan yang dapat ditagih dan akan menghabiskan kuota.
ZERO_RESULTS 2xx Respons yang berhasil tidak memberikan hasil.

Ini adalah permintaan yang dapat ditagih dan akan menghabiskan kuota.
NOT_FOUND 2xx Untuk Directions API, ini menunjukkan bahwa setidaknya salah satu lokasi yang ditentukan dalam asal, tujuan, atau titik jalan permintaan tidak dapat di-geocode.

Untuk Places API ini menunjukkan bahwa lokasi yang direferensikan (place_id) tidak ditemukan dalam database Tempat.

Ini adalah permintaan yang dapat ditagih dan akan menghabiskan kuota.
INVALID_REQUEST (nilai parameter tidak valid),
MAX_WAYPOINTS_EXCEEDED,
MAX_ROUTE_LENGTH_EXCEEDED, dsb.
2xx Error disebabkan oleh nilai parameter yang tidak valid, terlalu banyak nilai yang diberikan, dsb. Periksa respons API untuk detail selengkapnya.

Ini adalah permintaan yang dapat ditagih dan akan menghabiskan kuota.
REQUEST_DENIED 4xx Error klien disebabkan oleh error autentikasi, error akses, dll. Periksa respons API untuk detail selengkapnya.
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
rateLimitExceeded,
dailyLimitExceeded,
userRateLimitExceeded
4xx Error klien disebabkan oleh terlalu banyak permintaan per jangka waktu yang diizinkan. Coba kirim kembali permintaan di lain waktu. Periksa respons API untuk detail selengkapnya.
INVALID_REQUEST (parameter tidak valid, parameter tidak ada, error penguraian permintaan) 4xx Error klien disebabkan oleh permintaan yang tidak valid. Periksa respons API untuk detail selengkapnya.
NOT_FOUND (404) 4xx Untuk Geolocation API, ini menunjukkan bahwa input tidak cukup untuk menghasilkan estimasi lokasi.

Untuk Roads API, ini menunjukkan bahwa input tidak dapat dipaskan ke jalan secara wajar.

Ini adalah permintaan yang dapat ditagih dan akan menghabiskan kuota.
UNKNOWN_ERROR 5xx Error server yang menunjukkan bahwa permintaan tidak dapat diproses: error internal, layanan kelebihan beban, tidak tersedia, waktu habis, dsb.

Untuk informasi selengkapnya tentang kode status dan pesan error, lihat dokumentasi respons untuk API yang Anda minati (misalnya, Respons Geocoding atau Respons Rute).

Parameter solusi Google Maps Platform

Google Maps Platform menyediakan banyak jenis kode contoh untuk membantu Anda memulai dan menjalankan dengan cepat. Misalnya, Anda dapat menggunakan Quick Builder di Cloud Console, mengikuti panduan penerapan solusi industri, dan mempelajari codelab.

Untuk memahami penggunaan dan cara meningkatkan solusi kami, Google menyertakan parameter kueri solution_channel dalam panggilan API untuk mengumpulkan informasi tentang penggunaan kode contoh:

  • Parameter kueri solution_channel disertakan secara default di kode contoh solusi.
  • Parameter kueri menampilkan analisis anonim tentang penggunaan solusi pada Google untuk meningkatkan kualitas solusi pada iterasi mendatang.
  • Anda dapat memilih tidak ikut menggunakan dengan menghapus parameter kueri solution_channel dan nilainya dari kode contoh.
  • Anda tidak diwajibkan untuk tetap menggunakan parameter tersebut. Menghapus parameter kueri tidak akan memengaruhi performa.
  • Parameter kueri hanya digunakan untuk pelaporan penggunaan kode contoh.
  • Parameter kueri bukan bagian dari analisis dan pelaporan spesifik per API. Itu berarti menghapus parameter dari kode contoh solusi tidak akan menonaktifkan pelaporan Maps JavaScript API internal.

Laporan kuota

Kuota menetapkan batas jumlah permintaan yang dapat diajukan oleh project Anda ke API Google Maps Platform. Permintaan dapat dibatasi dengan tiga cara: per hari, per menit, dan per pengguna per menit. Hanya permintaan yang berhasil dan permintaan yang menyebabkan error server yang akan mengurangi kuota. Permintaan yang gagal autentikasi tidak mengurangi kuota.

Penggunaan kuota ditampilkan dalam grafik pada halaman Kuota di Cloud Console dan dapat dikelompokkan dalam permintaan per menit. Batas kuota saat ini untuk API yang dipilih ditampilkan dalam tabel di bawah grafik penggunaan kuota.

Gunakan kalkulator ini untuk mendapatkan nilai kuota per menit untuk produk GMP API apa pun.

Halaman Kuota Google Maps

Halaman Kuota Google Maps menampilkan batas kuota dan pemakaian kuota untuk API tertentu yang Anda pilih.

Diagram penggunaan kuota di Google Cloud Console menampilkan total traffic untuk kunci API dan client ID Anda. Traffic Client ID juga tersedia di diagram Metrik pada Cloud Console. Untuk informasi selengkapnya, lihat Masalah 158809616.

Halaman ini hanya menampilkan permintaan yang mengurangi kuota: permintaan yang berhasil (OK, ZERO_RESULTS, DATA_NOT_AVAILABLE) dan permintaan yang menyebabkan error server (NOT_FOUND, INVALID_REQUEST/INVALID_VALUE (nilai parameter tidak valid), UNKNOWN_ERROR).

Permintaan yang menyebabkan error klien — error autentikasi/otorisasi/argumen tidak valid (REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST (parameter tidak valid, error penguraian permintaan)) — tidak mengurangi kuota dan tidak ditampilkan.

Unit kuota adalah permintaan untuk sebagian besar API Google Maps Platform (Static Maps API, Street View Static API, Geocoding API, Directions API, Places API, Timezone API, Geolocation API, dan Elevation API). Namun ada beberapa pengecualian:

  • Untuk Distance Matrix API, unit kuota adalah elemen yang merupakan pasangan asal-tujuan.
  • Untuk Maps JavaScript API, unit kuota adalah beban peta.
  • Untuk Maps SDK for Android dan Maps SDK for iOS, unit kuota adalah permintaan Street View/beban Panorama (Beban peta gratis dan tidak menghabiskan kuota).
kuota

Unit kuota

Tabel di bawah ini menampilkan unit kuota untuk Google Maps Platform API.

Google Maps Platform API Unit Kuota
Maps
Maps SDK for Android 1 Panorama
Maps SDK for iOS 1 Panorama
Maps Static API 1 Permintaan
Maps JavaScript API 1 Beban Peta
Street View Static API 1 Permintaan
Maps Embed API 1 Beban Peta
Rute
Directions API 1 Permintaan
Distance Matrix API 1 Elemen (pasangan asal-tujuan)
Roads API 1 Permintaan
Tempat
Places API 1 Permintaan
Geocoding API 1 Permintaan
Geolocation API 1 Permintaan
Time Zone API 1 Permintaan

Laporan penagihan

Melihat laporan penagihan

Laporan penagihan untuk penggunaan produk Google Maps Platform tersedia di Google Cloud Console (lihat Penagihan).

Cara membaca diagram laporan penagihan

Laporan penagihan mengilustrasikan biaya dari waktu ke waktu sebagai diagram garis bertumpuk. Tampilan default menampilkan biaya khusus penggunaan harian pada bulan ini yang dikelompokkan menurut project (untuk semua produk), termasuk kredit khusus penggunaan yang diterapkan, serta total perkiraan biaya untuk seluruh bulan berjalan. Setiap baris dalam diagram (dan baris dalam tabel ringkasan) merujuk ke project, yang diberi peringkat dari biaya terbesar hingga biaya terkecil. Pelajari lebih lanjut cara menafsirkan diagram laporan penagihan.

laporan penagihan
Gambar 1: Laporan penagihan yang menampilkan diagram dan tabel yang menggunakan tampilan preset default.

Tips: Analisis penggunaan dan biaya berdasarkan SKU

Untuk lebih memahami detail model harga bayar sesuai penggunaan dan pengaruhnya terhadap penerapan Anda, lihat penggunaan dan biaya menurut SKU.

Laporan penagihan yang dikelompokkan menurut SKU
Gambar 2: Tabel penagihan yang menampilkan item baris penggunaan dan biaya menurut SKU.
Filter laporan penagihan
Gambar 3: Filter laporan penagihan.
Untuk mengubah tampilan laporan guna menampilkan item baris menurut SKU:
  1. Pada panel di sebelah kanan diagram, perluas filter Kelompokkan menurut.
  2. Pilih SKU.

Filter laporan penagihan lain yang tersedia mencakup Rentang waktu, Project, Produk, SKU, dan Lokasi yang memungkinkan Anda memfilter menurut tempat asal penayangan permintaan API.

Untuk mengategorikan sumber penggunaan Anda selain produk, laporan penagihan grup dikelompokkan menurut salah satu nilai yang tercantum. Tiga kunci yang berkaitan dengan Google Maps Platform API adalah goog-maps-api-key-suffix (empat karakter terakhir dari kunci API), goog-maps-platform-type (platform: Android, iOS, JavaScript, atau NETWORK), dan goog-maps-channel (kumpulan nilai saluran numerik dari kueri API). Informasi selengkapnya tentang pemfilteran dan pengelompokan.

Anda dapat mengubah tampilan diagram untuk mengecualikan kredit khusus penggunaan dengan menghapus centang pada kotak Sertakan kredit dalam biaya di panel kanan.

Memantau dan membatasi konsumsi

Untuk membantu merencanakan anggaran dan mengontrol biaya, Anda dapat melakukan hal berikut:

  • Tetapkan pemberitahuan anggaran, untuk mengetahui saat pembelanjaan mendekati jumlah tertentu. Menetapkan anggaran tidak membatasi penggunaan API, tetapi hanya memberi tahu Anda saat jumlah pembelanjaan Anda mendekati jumlah yang ditentukan.
  • Batasi penggunaan API harian, untuk mengelola biaya penggunaan API yang dapat ditagih. Dengan menetapkan batas pada permintaan per hari, Anda dapat membatasi pembelanjaan Anda. Gunakan persamaan sederhana untuk menentukan batas harian, bergantung pada jumlah yang ingin Anda belanjakan. Contoh: (Pembelanjaan bulanan / harga per satuan SKU) / 30 = batas permintaan per hari (untuk satu API). Perhatikan bahwa penerapan Anda mungkin menggunakan beberapa API yang dapat ditagih, jadi sesuaikan persamaan menurut kebutuhan. Ingat, kredit Google Maps Platform senilai $200 USD tersedia setiap bulan, jadi pastikan Anda memasukkannya dalam perhitungan.

Pelacakan penggunaan per saluran

Untuk melacak penggunaan melalui saluran numerik, Anda harus menambahkan parameter 'saluran' ke permintaan API. Satu-satunya nilai saluran yang dapat diterima adalah angka dari 0-999. Berikut beberapa contohnya:

  • Geocoding Web Service API

    https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1
  • Maps JavaScript API

    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
    async defer></script>

Pantau penggunaan saluran Anda secara langsung di Laporan Penagihan. Saluran akan ditampilkan di bagian Label sebagai kunci 'goog-maps-channel'.

Filter menurut Label
Gambar 4: Filter menurut SKU dan Saluran
Untuk memfilter laporan penagihan menurut SKU dan saluran
  1. Gunakan filter SKU Kelompokkan menurut.
  2. Klik tanda sisipan Label.
  3. Klik menu drop-down Kunci lalu pilih goog-maps-channel
  4. Klik menu drop-down Nilai lalu pilih saluran numerik yang ingin Anda filter

Klik tombol Kelompokkan menurut Label goog-maps-channel jika ingin melihat biaya yang dihasilkan oleh setiap saluran.

Setelah Anda menerapkan data penggunaan saluran dalam permintaan Anda, mungkin akan ada sedikit keterlambatan (hingga 24 jam) sebelum data tersebut ditampilkan dalam laporan penagihan.

Mengekspor data penagihan ke BigQuery

Anda juga dapat mengekspor data penagihan ke BigQuery.

BigQuery Export memungkinkan Anda mengekspor data Penagihan Cloud yang mendetail (seperti data estimasi penggunaan dan biaya) secara otomatis sepanjang hari ke set data BigQuery yang Anda tentukan. Kemudian, Anda dapat mengakses data penagihan dari BigQuery untuk analisis yang mendetail. Hal ini memberikan lapisan perincian tambahan dalam memahami sumber penggunaan Google Maps Platform.

Jika Anda ingin memulai ekspor BigQuery dan membuat kueri data, Anda dapat mencoba contoh kueri di bawah ini. Sebelum menjalankan kueri ini, Anda harus:

  • Mengaktifkan penagihan dan ekspor penagihan BigQuery di akun Anda.
  • Format tabelnya adalah PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID dengan:
    • PROJECT_ID adalah project ID Anda yang sebenarnya (misalnya, "my-project-123456").
    • DATASET_NAME adalah nama set data yang Anda buat (misalnya "SampleDataSet").
    • BILLING_ACCOUNT_ID adalah referensi ID Akun Penagihan Anda, yang diawali dengan "gcp_billing_export_v1_", dan mengubah tanda hubung (-) menjadi garis bawah (_). Misalnya, ID akun penagihan 123456-7890AB-CDEF01 akan menjadi gcp_billing_export_v1_123456_789AB_CDEF01.

Catatan: Saat Anda membuat Set Data baru, ini akan langsung muncul di antarmuka, tetapi Tabel untuk kueri tidak akan langsung muncul. Tabel akan dibuat secara otomatis setelah beberapa jam. Selanjutnya, perlu waktu sekitar 24 jam untuk melihat data Anda. Set data BigQuery Anda hanya mencerminkan data penggunaan dan biaya yang dikenakan dari tanggal penyiapan ekspor penagihan, dan setelahnya. Dengan kata lain, data penagihan tidak ditambahkan secara retroaktif, sehingga Anda tidak akan melihat data penagihan sebelum mengaktifkan BigQuery Export.

  #standardSQL
  SELECT   Date(usage_start_time, "America/Los_Angeles") AS billing_day,
           invoice.month                                 AS invoice_month,
           service.description                           AS service,
           sku.description                               AS sku,
           (
                  SELECT l.value
                  FROM   Unnest(labels) AS l
                  WHERE  l.KEY = 'goog-maps-channel' ) AS goog_maps_channel,
           Round(Sum(usage.amount), 2)                 AS usage_amount,
           usage.unit                                  AS usage_unit,
           Round(Sum(cost), 2)                         AS cost,
           cost_type,
           currency
  FROM     `PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID`
  WHERE    invoice.month = '202002' -- Change the invoice month with the same format as the example.
  GROUP BY billing_day,
           invoice_month,
           service,
           sku,
           goog_maps_channel,
           usage_unit,
           cost_type,
           currency
  ORDER BY billing_day,
           service,
           sku
  

Penagihan Cloud:

Google Maps Platform:

Status dan laporan respons

Tabel di bawah ini mencantumkan status respons dan class kode respons, serta menunjukkan apakah permintaan yang sesuai muncul dalam laporan Penggunaan, Kuota, dan/atau Penagihan.

Status Respons Class Kode Respons
(2xx, 3xx, 4xx, 5xx)
Laporan Penggunaan Laporan Kuota Laporan Penagihan
OK 2xx,
3xx
Ya Ya Ya
ZERO_RESULTS,
DATA_NOT_AVAILABLE,
NOT_FOUND
2xx Ya Ya Ya
INVALID_REQUEST (nilai parameter tidak valid),
MAX_WAYPOINTS_EXCEEDED,
MAX_ROUTE_LENGTH_EXCEEDED,
dsb.
2xx Ya Ya Ya
REQUEST_DENIED 4xx Ya Tidak Tidak
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
dailyLimitExceeded,
rateLimitExceeded,
userRateLimitExceeded
4xx Ya Tidak Tidak
INVALID_REQUEST (parameter tidak valid, error penguraian permintaan) 4xx Ya Tidak Tidak
NOT_FOUND (Geolocation dan Roads API) 4xx Ya Ya Ya
UNKNOWN_ERROR 5xx Ya Ya Tidak