Pelaporan Google Maps Platform

Pelaporan di Google Maps Platform memberikan kumpulan laporan visual standar yang memungkinkan Anda melihat penggunaan, kuota, dan informasi penagihan API dasar di Google Cloud Console dengan mudah. Anda dapat dengan cepat mengetahui jumlah panggilan API, melihat sisa kuota penggunaan API, serta memantau penggunaan dan penagihan dari waktu ke waktu.

Jenis laporan meliputi:

  • Laporan penggunaan: Melaporkan jumlah permintaan yang dibuat oleh project Anda ke Google Maps Platform API menggunakan kredensial yang dikaitkan dengan project Anda.
  • Laporan kuota: Melaporkan penggunaan kuota dalam grafik yang dapat dikelompokkan dalam permintaan per menit. Batas kuota saat ini untuk API yang dipilih ditampilkan dalam tabel di bawah grafik penggunaan kuota.
  • Laporan penagihan: Melaporkan biaya dari waktu ke waktu sebagai diagram garis bertumpuk. Melihat penggunaan kuota bulan ini, termasuk kredit khusus penggunaan yang diterapkan, serta perkiraan total biaya untuk seluruh bulan berjalan.

Lihat Status dan laporan respons di bawah untuk mengetahui daftar lengkap status respons dan kode respons yang menentukan apakah permintaan muncul di laporan Penggunaan, Kuota, dan/atau Penagihan.

Lihat laporan penggunaan, kuota, dan penagihan Google Maps Platform menggunakan Cloud Console.

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.

monitoring api

Untuk mengakses halaman APIs & Services Dashboard:

  1. Buka halaman Project selector di Cloud Console:

    Halaman Project selector

  2. Pilih project Anda. Halaman APIs & Services Dashboard akan muncul.

    Jika halaman tidak muncul, pilih tombol menu menu lalu pilih APIs & Services.

Untuk informasi selengkapnya, lihat Memantau Penggunaan 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.

Screenshot Diagram Ringkasan yang menampilkan tabel yang mencantumkan API yang diaktifkan dan permintaan API selama 30 hari terakhir.

Untuk mengakses halaman Ringkasan Google Maps Platform:

  1. Buka halaman Google Maps Platform di Cloud Console:

    Buka halaman Google Maps Platform

  2. Di menu kiri, pilih Overview.

Halaman Google Maps Platform API

Halaman APIs Google Maps berisi dua tabel. Tabel Enabled APIs menampilkan jumlah permintaan, jumlah error, dan latensi rata-rata untuk setiap API yang diaktifkan selama 30 hari terakhir. Tabel Additional APIs mencantumkan API yang belum diaktifkan.

api

Untuk mengakses halaman API Google Maps Platform:

  1. Buka halaman Google Maps Platform di Cloud Console:

    Buka halaman Google Maps Platform

  2. Di menu sebelah kiri, pilih APIs.

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 Metrics menyertakan tabel API yang menampilkan permintaan, error, dan latensi untuk API yang telah Anda pilih.

Menggunakan menu 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, Kode Respons, dan/atau Platform. Anda juga dapat memilih jangka waktu (dari satu jam hingga 30 hari terakhir) dan tingkat perincian (per detik atau per hari) untuk metrik penggunaan yang ditampilkan.

metrik

Untuk mengakses halaman Metrik Google Maps Platform API:

  1. Buka halaman Google Maps Platform di Cloud Console:

    Buka halaman Google Maps Platform

  2. Di menu sebelah kiri, pilih Metrics.

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 Metrics pada Cloud Console.

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 (parameter value 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 Google Maps Platform API (Maps Static API, Street View Static API, Geocoding API, Directions API, Places API, Time Zone 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 mengurangi kuota).

Screenshot halaman Quotas Maps di Google Cloud Console. Halaman ini menampilkan kuota berdasarkan API menggunakan pemilih, lalu menampilkan Beban Peta yang dibandingkan dengan kuota yang ditetapkan untuk API yang dimaksud.

Untuk mengakses halaman Kuota Google Maps Platform:

  1. Buka halaman Google Maps Platform di Cloud Console:

    Buka halaman Google Maps Platform

  2. Di menu sebelah kiri, pilih Quotas.
  3. Pilih API dari menu drop-down API.

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).

Untuk mengakses laporan penagihan:

  1. Buka halaman Project selector di Cloud Console:

    Halaman Project selector

  2. Pilih project.
  3. Pilih tombol menu menu lalu pilih Billing.
  4. Jika Anda memiliki beberapa akun penagihan, pilih Go to linked billing account untuk membuka halaman Overview untuk akun penagihan yang ditautkan.
  5. Di menu kiri, pilih Reports untuk membuka halaman Reports penagihan untuk akun penagihan yang ditautkan.

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.

Screenshot laporan penagihan yang menampilkan diagram dan tabel yang menggunakan tampilan preset default
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.
Screenshot 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 Time range, Projects, Products, SKUs, dan Locations 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 webservice), 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 Include credits in cost di panel kanan.

Memantau dan membatasi konsumsi

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

  • Tetapkan pemberitahuan anggaran, untuk melacak pengeluaran yang mendekati jumlah tertentu. Menetapkan anggaran tidak membatasi penggunaan API, tetapi hanya memberi tahu Anda saat jumlah pengeluaran 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 pengeluaran. Gunakan persamaan sederhana untuk menentukan batas harian, bergantung pada jumlah yang ingin Anda keluarkan. Contoh: (Pembelanjaan bulanan/harga per satuan SKU)/30 = batas permintaan per hari (untuk satu API). Perhatikan bahwa penerapan mungkin menggunakan beberapa API yang dapat ditagih, jadi sesuaikan persamaan seperlunya. 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 Labels 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 Group by.
  2. Pilih tanda sisipan Labels.
  3. Pilih menu drop-down Key lalu pilih goog-maps-channel.
  4. Pilih menu drop-down Value lalu pilih saluran numerik yang ingin Anda filter.

Klik tombol Group by 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.

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_exportv1BILLING_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_exportv1", dan mengubah tanda hubung (-) menjadi garis bawah (_). Misalnya, ID akun penagihan 123456-7890AB-CDEF01 akan menjadi gcp_billing_export_v1_123456_789AB_CDEF01.

  #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