Panduan Migrasi Google Maps Platform

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

Panduan ini menunjukkan cara bermigrasi ke model harga bayar sesuai penggunaan Google Maps Platform kepada pelanggan Premium Plan.

Poin utama

  • Mulai 1 November 2018, pelanggan Premium Plan dapat bermigrasi ke model harga bayar sesuai penggunaan Google Maps Platform setelah kontrak Premium Plan yang sedang mereka gunakan berakhir. Hanya kontrak yang berakhir pada tanggal 1 November 2018 atau setelahnya, yang dapat bermigrasi ke Google Maps Platform. Kontrak yang berakhir sebelum tanggal 1 November 2018 harus diperpanjang dengan Premium Plan.
  • Pelanggan yang sudah menggunakan Premium Plan tidak perlu melakukan perubahan kode saat migrasi (misalnya, tidak perlu mengubah Client ID atau Kunci API).
  • Untuk mempersiapkan migrasi, Anda harus menyiapkan akun penagihan yang akan ditautkan ke project API. Setelah tanggal akhir kontrak Premium Plan, project API Anda akan "terbuka", sehingga akun penagihan baru dapat dikaitkan dalam Cloud Console.
  • Jika penggunaan API Anda melebihi 500.000 panggilan API/bulan, Anda dapat menggunakan harga berbasis volume. Sebaiknya Anda bekerja sama dengan partner Google Maps. Lihat Halaman Harga dan matriks penggunaan dan harga untuk mengetahui detail selengkapnya tentang harga.

Proses migrasi

Premium Plan ke Sub-penagihan reseller di Google Maps Platform

Sebelum masa kontrak berakhir

  • Pelanggan: Tanda tangani kontrak perpanjangan dengan Partner yang mencakup Persyaratan Layanan Google Maps Platform.
  • Partner: Ajukan permintaan diskon harga volume untuk pelanggan. Sebaiknya lakukan langkah ini setidaknya 2 minggu sebelum perpanjangan kontrak untuk memproses permintaan tersebut.
  • Partner: Siapkan akun sub-penagihan di akun penagihan reseller.
  • Partner: Tetapkan izin dan peran bagi pelanggan untuk mengakses akun penagihan mereka.
  • Pelanggan: Pastikan Anda memiliki akses ke project Premium Plan. Jika Anda tidak dapat mengaksesnya, lihat petunjuk selengkapnya di bawah.

Pada beberapa hari pertama setelah kontrak Premium berakhir

  • Dalam waktu tiga hari setelah tanggal akhir kontrak Premium Plan, project Anda akan "terbuka" sehingga akun penagihan baru dapat dikaitkan.
  • Pastikan untuk menautkan project ke akun sub-penagihan yang dibuat oleh partner Anda sesegera mungkin. Untuk melakukannya, ikuti langkah-langkah berikut:
    • Buka Cloud Console, pilih project Premium Plan (misalnya, "Google Maps -INT"), lalu pilih Penagihan dari menu navigasi di kiri atas.
    • Pilih Kelola akun penagihan dan klik tab Project saya.
    • Pilih nama project, klik tiga titik vertikal, lalu pilih Ubah akun penagihan.
    • Klik Pilih akun, lalu pilih akun penagihan reseller dari daftar. Lalu, pilih TETAPKAN AKUN.
    • Untuk mengetahui detail selengkapnya, lihat panduan contoh.
  • Sebaiknya aktifkan penagihan di akun baru dalam waktu 7 hari. Setelah penagihan diaktifkan, penggunaan layanan selama periode sementara ini akan ditagihkan ke akun penagihan baru.
  • Jika sub-penagihan tidak diaktifkan dalam waktu 30 hari setelah tanggal akhir kontrak Premium Plan, penggunaan Google Maps Platform API akan diblokir.

Premium Plan ke Penagihan online di Google Maps Platform

Sebelum masa kontrak berakhir

Pada beberapa hari pertama setelah kontrak Premium berakhir

  • Dalam waktu tiga hari setelah tanggal akhir kontrak Premium Plan, project Anda akan "terbuka" sehingga akun penagihan baru dapat dikaitkan. Pastikan untuk menambahkan metode pembayaran online pada akun penagihan Anda. Sebaiknya tambahkan metode pembayaran dan aktifkan penagihan dalam waktu 7 hari. Setelah penagihan diaktifkan, penggunaan layanan selama periode sementara ini akan ditagihkan ke akun penagihan baru.
  • Jika penagihan tidak diaktifkan dalam waktu 30 hari setelah tanggal akhir kontrak Premium Plan, penggunaan Maps API akan diblokir.

Premium Plan ke Penagihan offline di Google Maps Platform

Hubungi Account Manager Google Anda.

Pertanyaan umum (FAQ)

Umum

Bagaimana cara memigrasikan aplikasi saya yang saat ini menggunakan client ID?

Untuk mempermudah proses migrasi, kami akan otomatis membuat pemetaan antara Client ID dan project Premium Plan. Dengan demikian, Anda tidak perlu melakukan perubahan coding.

Apakah kami dapat memperoleh bantuan dalam mengoptimalkan penggunaan?

Ya, kami memberikan dukungan deployment untuk pelanggan. Hubungi Account Manager dan/atau partner Anda. Lihat Panduan Pengoptimalan untuk mempelajari lebih lanjut.

Siapa yang dapat mengakses akun penagihan dan memberikan akses kepada orang lain?

Siapa saja yang memiliki peran Administrator Akun Penagihan dapat mengakses dan memberikan akses kepada orang lain (lihat Ringkasan peran Penagihan di IAM). Tinjau akun penagihan dan pastikan peran telah ditetapkan sesuai kebutuhan. Jika sub-penagihan reseller dimigrasikan, beri partner kontak pelanggan yang akan mendapatkan izin untuk mengakses akun sub-penagihan.

Saya memiliki beberapa SKU. Bagaimana praktik terbaik untuk mengelolanya?

Jika Anda memiliki beberapa SKU (misalnya, Maps-INT, Maps-OEM), beberapa akun penagihan telah dibuat berdasarkan SKU (yakni, Maps-INT dan Maps-OEM masing-masing memiliki akun terpisah). Sebaiknya gabungkan semuanya ke dalam satu akun penagihan.

Apakah pelanggan Premium Plan di India dapat bermigrasi ke model harga bayar sesuai penggunaan setelah tanggal 1 November?

Model harga bayar sesuai penggunaan akan tersedia di India pada tanggal 18 November 2019. Kami akan menghubungi Anda sebelum model tersebut tersedia di area Anda. Sementara itu, harga Premium Plan tidak akan berubah.

Dukungan

Bagaimana cara menghubungi dukungan teknis setelah bermigrasi ke model harga bayar sesuai penggunaan?

Pelanggan dan Partner dapat mengunjungi halaman dukungan Google Maps Platform di Google Cloud Console untuk melihat opsi dukungan yang tersedia. Jika pelanggan berafiliasi dengan partner, partner akan menjadi kontak utama untuk dukungan teknis.

Pelanggan yang memiliki Dukungan Gold di lisensi Premium Plan akan tetap memiliki akses ke fungsi yang setara dengan Dukungan Gold (termasuk dukungan 24/7) selama 12 bulan setelah bermigrasi ke model harga bayar sesuai penggunaan. Pengguna tersebut harus terus menggunakan Portal Dukungan agar dapat mengajukan kasus dukungan.

Saya tidak dapat mengakses akun penagihan atau project Premium Plan saya, apa yang harus saya lakukan?

Anda harus bisa mengakses project Premium Plan agar dapat mengaktifkan penagihan dan menghindari gangguan layanan saat melakukan perpanjangan. Meski hanya menggunakan Client ID, Anda akan memerlukan akses ke project agar dapat mengaktifkan penagihan.

Jika Anda tidak dapat mengakses project Premium Plan, tanyakan kepada rekan kerja apakah ada yang dapat mengakses project Anda (jika ada, mereka mungkin dapat memberikan akses kepada Anda). Jika Anda tetap tidak dapat memulihkan akses ke project Premium Plan, hubungi dukungan.

Jika tidak dapat mengakses akun penagihan Premium Plan, ini bukan masalah serius, Anda cukup beralih ke akun penagihan baru. Setelah kontrak Premium Plan berakhir, Anda akan dapat mengaitkan project ke akun penagihan baru.

Jika client ID Anda sudah tidak berlaku, beberapa link tidak akan muncul lagi di menu kiri. Untuk mengaksesnya, ikuti link ini.

Produk

Dapatkah saya terus melihat penggunaan saya yang dikelompokkan menurut saluran?

Pelanggan dengan lisensi Premium Plan kini dapat menggunakan parameter channel dengan Kunci API atau Client ID. (Perubahan ini hanya berlaku untuk API yang telah mendukung penggunaan parameter channel dengan Client ID; untuk contoh, lihat Maps JavaScript API.)

Pelanggan yang telah bermigrasi ke model harga bayar sesuai penggunaan Google Maps Platform harus menggunakan Google Cloud Platform Console untuk melihat penggunaan yang dikelompokkan menurut saluran di laporan penagihan Maps. Setelah penagihan diaktifkan di project, Anda juga akan dapat mengakses data saluran dengan mengekspor aktivitas penagihan ke BigQuery (lihat contoh di bawah).

Contoh berikut menunjukkan cara mengakses data saluran dengan mengekspor aktivitas penagihan ke BigQuery. 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 tanda hubung (-) diubah 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 = '201906' -- 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

Berapa banyak saluran yang akan didukung di Google Cloud Console?

Kami akan terus mendukung saluran untuk permintaan Client ID dan akan dapat diakses dari ekspor penagihan di konsol. Kami mendukung 1.000 saluran di konsol.

Apakah saya akan tetap dapat mengakses fitur khusus Premium Plan, seperti Static Maps yang besar?

Fitur khusus untuk Premium Plan akan tetap dapat diakses dari ID Premium Plan yang sudah ada (Client ID atau project ID). Fitur tersebut tidak dapat diakses dari project baru yang mungkin Anda buat.

Apakah saya dapat membuat project baru dan mengaitkannya dengan akun penagihan saya?

Anda dapat membuat project baru, sesuai kuota. Project baru tidak akan dapat mengakses beberapa fitur khusus Premium Plan seperti Static Maps yang besar.

Haruskah saya berhenti menggunakan Client ID?

Meski kami tidak berencana untuk menghentikan penggunaan Client ID dalam waktu dekat, sebaiknya Anda mengupdate aplikasi untuk menggunakan autentikasi Kunci API, bukan autentikasi Client ID. Kunci API memiliki fungsi yang setara dengan Client ID, dan didukung sepenuhnya di konsol.

Di mana saya dapat mengelola Client ID saya?

Anda harus terus menggunakan Portal Dukungan Google Cloud untuk mengelola client ID: daftarkan URL resmi dan dapatkan kunci penandatanganan kriptografis pribadi.

Apakah kuota khusus saya tetap bisa digunakan?

Ya. Jika saat ini Anda memperoleh peningkatan QPS lebih dari batas default Premium Plan Maps, Anda tetap dapat menggunakan QPS dengan batas yang ditingkatkan tersebut di Maps Platform (pada API apa pun).

Untuk Maps JavaScript API, QPS di layanan JavaScript (geocoding, rute, dll.) akan tetap tidak terbatas.

Pengecualian: Places API (Layanan Web dan JavaScript). Setelah kontrak Premium Plan berakhir, Places Library, JavaScript API dan Places API akan menggunakan batas QPS yang sama, dengan default sebesar 100 QPS (selama dalam Premium Plan, layanan Places JavaScript memberikan QPS tanpa batas, dan Layanan Web dibatasi secara terpisah dengan default sebesar 50 QPS). Untuk memastikan bahwa batas QPS bersama di Tempat cukup, kami menganalisis traffic bersama Anda, dan memberikan batas QPS bersama yang akan mencakup total traffic (dibulatkan ke atas ke ratusan QPS terdekat). Ke depannya, Anda harus memastikan bahwa batas QPS bersama ditetapkan cukup tinggi untuk mengantisipasi peningkatan. Hubungi Dukungan jika Anda perlu meningkatkan batas ini.

Apakah saya masih dapat mengakses laporan penggunaan Portal Dukungan?

Laporan penggunaan Portal Dukungan tersedia selama 12 bulan setelah Anda bermigrasi ke model harga bayar sesuai penggunaan.

Apakah saya dapat melihat penggunaan untuk Client ID Premium Plan saya di Google Cloud Platform Console?

Penggunaan Client ID Anda kini muncul di Google Cloud Platform Console. Untuk informasi selengkapnya, lihat Pelaporan Google Maps Platform.

Laporan Penggunaan
Anda dapat melihat penggunaan yang terkait dengan client ID di halaman METRIK Google Maps di konsol. Di beberapa diagram (Traffic/Error/Latensi berdasarkan kredensial), Anda akan melihat grafik yang terkait dengan penggunaan Client ID yang dianotasikan dengan label "project_number: 12345678". Legenda di bawah grafik mungkin tidak selalu memiliki ruang yang cukup pada layar untuk menampilkan label tersebut - jika ini terjadi, cukup arahkan kursor ke grafik untuk melihat keseluruhan label.

Fitur ini tersedia untuk semua API yang saat ini mendukung autentikasi client ID, kecuali Places Library, JavaScript API.

Anda dapat mengakses halaman METRIK dengan memilih salah satu API atau SDK yang diaktifkan yang tercantum di dasbor Ringkasan Google Maps atau dasbor API Google Maps pada konsol.

Laporan Kuota
Traffic client ID tidak terikat oleh batas kuota pada project Premium Plan Anda, sehingga tidak disertakan dalam laporan Kuota di konsol. Traffic Client ID terikat oleh batas kuota yang tidak dapat divisualisasikan di Konsol.

Laporan Penagihan
Laporan Penagihan di konsol kini menyertakan penggunaan Client ID.

Di mana saya dapat melihat penagihan saya?

Untuk mengetahui informasi tentang penagihan, lihat Penagihan Google Maps Platform.

Referensi