Daftar Periksa Pra-peluncuran

Memastikan tim Anda memiliki akses ke sumber daya yang diperlukan

Simpan surat sambutan Google Maps APIs Premium Plan di tempat yang aman

Mengapa penting: Surat sambutan Anda adalah paket mulai Google Maps APIs Premium Plan dan juga merupakan alat pertolongan pertama. Surat ini berisi informasi yang sangat penting, seperti ID proyek Google API Console Anda, ID klien, dan kunci kriptografik Anda, yang diperlukan untuk mulai menggunakan Premium Plan. Surat ini juga berisi semua informasi yang Anda perlukan untuk menghubungi tim dukungan Premium Plan jika Anda mengalami masalah teknis pada Google Maps API yang mana pun.

Gunakan Google Cloud Support Portal

Mengapa penting: Portal dukungan memberi Anda akses ke informasi, seperti laporan penggunaan, umpan berita, dan sumber daya developer yang berguna. Yang lebih penting, portal dukungan memungkinkan Anda menyerahkan kasus dukungan kepada tim dukungan Premium Plan jika Anda menemui masalah teknis selama proses development atau peluncuran. Anda bisa mengakses portal dukungan di URL berikut:

https://google.secure.force.com/

Sebelum peluncuran, harap luangkan waktu untuk mengaktifkan akses ke portal dukungan bagi semua developer yang bertanggung jawab atas pengelolaan aplikasi Anda. Jika Anda mengalami masalah teknis, akses ke portal dukungan akan memberikan keuntungan ganda, yaitu mengizinkan anggota tim Anda menghubungi dukungan dan mengizinkan tim dukungan kami untuk menghubungi pemangku kepentingan yang tepat di organisasi Anda. Misalnya, tim dukungan mungkin perlu menghubungi organisasi Anda jika kami mendeteksi lalu lintas yang tidak normal atau perilaku yang berpotensi merusak aplikasi Anda. Memastikan kami dapat menghubungi developer yang tepat akan menjadi pembeda antara gangguan layanan yang tidak diduga dan mencegah gangguan layanan. Jika Anda tidak memiliki akses ke portal dukungan, harap minta akses di sini:

Minta Akun Google Cloud Support Portal

Berlangganan ke umpan notifikasi yang relevan

Mengapa penting: Untuk memastikan Anda terus mendapat kabar terbaru mengenai development dan perubahan pada Maps API, kami menyarankan agar Anda berlangganan umpan notifikasi yang relevan, seperti yang dijelaskan dalam FAQ.

Anda juga bisa berlangganan umpan RSS berikut untuk mendapatkan Pengumuman Google Maps Premier API: Gangguan, Pembaruan, dan Notifikasi Layanan:

http://google.force.com/services/xml/MapsRSS

Siapkan nomor telepon hotline dukungan

1-877-355-5787 untuk pelanggan di AS, +1 404-978-9282 untuk pelanggan di luar AS

Mengapa penting: Nomor telepon hotline ini berfungsi untuk menghubungi Google Cloud Support Portal. Harap bookmark laman ini untuk menemukan nomor telepon hotline dukungan yang terbaru. Harap perhatikan bahwa meskipun Anda boleh menggunakan hotline dukungan untuk melaporkan masalah teknis ke tim kami, nomor ini hanya diperuntukkan untuk kasus produksi yang tidak aktif atau layanan yang tidak bisa digunakan. Tingkat prioritas kami dijelaskan dalam dokumen ini:

https://support.google.com/work/answer/184028

Mengoptimalkan aplikasi Anda

Mengonfigurasi firewall untuk mengizinkan akses ke Layanan Google Maps APIs:

Mengapa penting: Layanan Google Maps APIs menggunakan berbagai domain, yang beberapa di antaranya bukan milik domain *google.com. Jika Anda berada di belakang firewall yang ketat, penting bagi Anda untuk mengizinkan akses ke domain yang digunakan oleh setiap layanan Maps API. Jika firewall Anda tidak mengizinkan akses ke domain ini, permintaan API akan gagal yang bisa mencegah fungsi aplikasi Anda. Anda bisa menemukan daftar lengkap domain yang digunakan oleh Maps API di Portal Dukungan:

  1. Masuk ke Google Cloud Support Portal.
    Portal Dukungan hanya tersedia untuk pelanggan yang memiliki lisensi Google Maps APIs Premium Plan atau Google Maps APIs for Work lama atau Google Maps for Business.
  2. Masuk ke tab Resources.
  3. Pilih list of domains used by the Google Maps APIs family. (Berikut tautan langsungnya.)
  4. Izinkan aplikasi Anda mengakses domain yang tercantum.

Kami tidak menyarankan pengelolaan pembatasan firewall berdasarkan alamat IP, karena IP yang dikaitkan dengan domain ini tidak statis.

Catatan: Layanan Google Maps APIs menggunakan porta 80 (http) dan 443 (https) untuk lalu lintas masuk dan keluar. Layanan ini juga memerlukan permintaan GET, POST, PUT, DELETE, dan HEAD. Konfigurasikan firewall Anda agar mengizinkan lalu lintas melalui porta ini dan mengizinkan permintaan, bergantung pada API dan kasus penggunaan.

Muat API melalui hostname SSL yang benar

Mengapa penting: Aplikasi yang memuat Maps API melalui SSL harus melakukannya melalui https://maps.googleapis.com, bukan hostname lawas, https://maps-api-ssl.google.com.

Otorisasi domain SSL Anda untuk digunakan bersama Google Maps JavaScript API

Mengapa penting: Saat menggunakan Google Maps JavaScript API dengan domain SSL, penting bahwa Anda telah mengotorisasi domain HTTPS Anda secara eksplisit untuk memastikan permintaan Anda tidak ditolak. Harap perhatikan bahwa mengotorisasi http://yourdomain.com tidak otomatis mengaktifkan SSL-nya yang terkait, https://yourdomain.com. Anda bisa memeriksa daftar domain yang diotorisasi di Google Cloud Support Portal dengan memilih tautan Maps: Manage Client ID dari menu navigasi di sebelah kiri. Untuk memecahkan masalah yang terkait dengan penggunaan API sisi-klien dengan domain SSL, kami sarankan Anda untuk memeriksa apakah ada elemen di laman Anda yang dimuat melalui HTTP. Harap lihat panduan tentang pemecahan masalah otorisasi.

Pilih versi API yang tepat

Mengapa penting: Sebelum mengembangkan aplikasi, penting bagi Anda untuk mengetahui versi API mana yang tidak digunakan lagi. Memilih mengembangkan aplikasi dengan API selain versi yang tidak digunakan lagi akan menghemat waktu dan biaya development setelah versi yang tidak digunakan lagi sudah tidak tersedia.

Khususnya, sangat penting untuk memahami skema pembuatan versi yang digunakan oleh Google Maps JavaScript API, sehingga Anda bisa menghindari penggunaan versi API yang tidak sesuai secara tidak sengaja di lingkungan development Anda.

Misalnya, Anda mungkin merasa sesuai menggunakan versi percobaan API di development atau lingkungan pengujian, tetapi kami sangat tidak menyarankan penggunaan versi percobaan di lingkungan produksi. SLA kami hanya berlaku untuk versi API yang stabil, sehingga Anda sangat disarankan hanya menggunakan versi stabil di lingkungan produksi Anda.

Lihat panduan tentang versi Google Maps JavaScript API.

Pilih apakah desain sisi-klien atau sisi-server

Mengapa penting: Memilih pendekatan sisi-klien atau sisi-server merupakan keputusan arsitektural dan sangat penting bagi stabilitas dan skalabilitas aplikasi Anda. Umumnya, pendekatan sisi-server harus digunakan untuk prapemrosesan dan pascapemrosesan rekaman secara offline (yaitu di luar aplikasi Anda). Atau, pendekatan sisi-klien harus digunakan untuk bagian aplikasi Anda yang berinteraksi dengan pengguna Anda (yaitu memproses permintaan yang dikirimkan pengguna secara real-time).

Menerapkan pendekatan sisi-server dalam kondisi pendekatan sisi-klien harus digunakan merupakan penyebab utama melebihi kuota dan menyebabkan aplikasi tidak berfungsi. Kami sangat menyarankan untuk mempertimbangkan strategi geocoding sebelum mendesain atau meluncurkan aplikasi yang bergantung pada panggilan sisi-server.

Optimalkan penggunaan kuota

Mengapa penting: Memahami bagaimana aplikasi Anda mengonsumsi kuota, yang disebut sebagai Kredit Maps API, membantu Anda mengurangi biaya yang harus Anda bayarkan. Misalnya, jika Anda menggunakan Google Maps JavaScript API, aplikasi Anda mengonsumsi Kredit Maps API untuk setiap pemuatan peta. Lihat panduan tentang batas dan biaya penggunaan Premium Plan.

Kelola penggunaan kuota layanan web Anda

Mengapa penting: Secara default, kuota layanan web bersama disetel ke 100.000 permintaan gratis harian. Untuk perincian kuota per API yang lebih detail, lihat panduan tentang batas penggunaan. Untuk memeriksa berapa banyak kuota yang tersedia untuk proyek Anda, harap kirimkan kasus dukungan.

Sebelum meluncurkan layanan, sangat penting bagi Anda untuk memahami berbagai kesalahan yang terkait dengan kuota (misalnya, OVER_QUERY_LIMIT, User Rate Limit Exceeded), dan menyiapkan logika yang tepat untuk aplikasi Anda agar bisa merespons kesalahan tersebut jika Anda melebihi kuota Anda. Harap mulai dengan membaca FAQ batas penggunaan. Untuk informasi tentang kode status yang dikembalikan oleh setiap API, baca panduan developer untuk API tersebut. Misalnya, lihat panduan tentang kode status Google Maps Directions API. Memahami dan mengimplementasikan konsep ini akan sangat mengurangi peluang aplikasi Anda melebihi kuota yang diperbolehkan, diblokir oleh Google, dan/atau berhenti berfungsi.

Lakukan pengujian beban pada aplikasi Anda

Mengapa penting: Lakukan pengujian beban pada aplikasi Anda untuk memastikan bisa menangani volume permintaan yang tinggi tanpa melebihi kuota Anda untuk Maps API.

Pengujian beban terhadap layanan Google secara langsung akan menyebabkan aplikasi Anda melebihi kuota yang diizinkan dan akan diblokir Google. Google Maps APIs bisa melayani volume yang sangat tinggi. Di tahun 2012, Pelacak Sinterklas melayani 1,600,000 permintaan per detik. Dengan demikian, tidak perlu melakukan pengujian beban terhadap layanan Google. Sebagai gantinya, pengujian beban aplikasi Anda harus memastikan aplikasi bisa menangani volume permintaan yang tinggi tanpa melebihi kuota untuk Maps API. Contoh: jika kuota Anda untuk Google Maps Geocoding API adalah 20 QPS (kueri per detik); pengujian beban pada aplikasi Anda akan memastikan aplikasi Anda bisa menangani 600 QPS tanpa mengirimkan lebih dari 20 QPS ke Google Maps Geocoding API.

Untuk mencapai ini dengan aman, pengujian beban harus dilakukan terhadap API tiruan (palsu)—layanan yang bisa menyerap jumlah permintaan yang tinggi dan membalasnya dengan respons yang valid, tanpa melibatkan Google Maps APIs. Dengan demikian, Anda bisa melakukan pengujian beban pada aplikasi Anda tanpa harus menanggung risiko diblokir oleh Google Maps APIs.

Harap lihat contoh API tiruan berikut, yang diimplementasikan sebagai aplikasi Google App Engine yang kecil. Anda bisa mengunggah contoh ini ke aplikasi App Engine Anda sendiri (setelah Anda mendaftarkan aplikasi di appengine.google.com) dan memerintahkan aplikasi Anda mengirimkan permintaan ke sana, bukan ke maps.googleapis.com.

Kuota default App Engine (gratis) umumnya sudah cukup untuk melakukan pengujian beban pada aplikasi Anda jauh di atas kuota Anda untuk layanan web Maps API. Harap pastikan aplikasi Anda menyetel header User-Agent dengan benar untuk mengaktifkan kompresi respons. Ini penting untuk memastikan penggunaan bandwidth secara efisien yang khususnya penting untuk aplikasi App Engine yang melayani respons teks biasa (JSON/XML) dalam volume tinggi. Jika Anda perlu kuota yang lebih tinggi untuk aplikasi App Engine, Anda juga bisa mengaktifkan penagihan, meskipun ini jarang diperlukan.

Memigrasikan aplikasi Anda dari lisensi standar ke premium

Sertakan ID klien atau kunci API di permintaan API

Mengapa penting: Salah satu hal paling penting yang bisa Anda lakukan untuk aplikasi Anda adalah memastikan Anda menyertakan ID klien Anda (gme-yourclientid) atau kunci API (yang tampak seperti ini: AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0) di permintaan API Anda. ID klien atau kunci API mengidentifikasi permintaan Anda sebagai permintaan Google Maps APIs Premium Plan.

Anda harus menyertakan ID klien atau kunci API di aplikasi Anda untuk memanfaatkan fitur khusus di Premium Plan. Menyertakan ID klien atau kunci API Anda juga diperlukan untuk menerima dukungan teknis dan untuk memastikan aplikasi Anda tercakup SLA kami.

Untuk sebagian besar API, Anda bisa memilih menggunakan ID klien atau kunci API. ID klien Anda disertakan dalam surat sambutan yang dikirimkan ke kontak utama organisasi Anda. Anda bisa membuat kunci API Anda sendiri di Google API Console.

Detailnya berada dalam panduan tentang autentikasi dan otorisasi.

Sertakan salah satu kunci API atau ID klien di permintaan API, tetapi jangan sertakan keduanya.

Mengapa penting: Agar Google Maps JavaScript API dimuat dengan benar, atau untuk mengirim permintaan ke Google Maps API lainnya, Anda harus menyertakan salah satu dari ID klien atau kunci API Anda, tetapi bukan keduanya sekaligus. Jika Anda memilih menggunakan ID klien, Anda harus membuang semua parameter key. Jika permintaan Anda menyertakan kunci API dan ID klien sekaligus, permintaan akan gagal.

Ikuti petunjuk tentang autentikasi dan otorisasi untuk informasi selengkapnya tentang bagaimana memformat permintaan Premium Plan dengan benar per API.

Jika menggunakan ID klien, otorisasi domain Anda untuk digunakan dengan Google Maps JavaScript API

Mengapa penting: Untuk mencegah situs yang tidak diotorisasi agar tidak menggunakan ID klien Anda, Google Maps JavaScript API mengharuskan Anda mengotorisasi semua domain dengan tim dukungan kami untuk semua situs yang akan menggunakan ID klien Anda. (Pendaftaran URL tidak diperlukan jika Anda menggunakan kunci API, sebagai ganti ID klien.) Jika tidak ada kecocokan antara URL yang diotorisasi untuk menggunakan ID klien Anda dan situs yang mencoba menggunakan ID klien Anda, situs Anda tidak dapat menggunakan API dengan ID klien Anda. Anda bisa mengotorisasi domain kapan saja, jadi pastikan Anda telah mengotorisasi domain untuk semua situs Anda terlebih dulu sebelum peluncuran.

Anda bisa memeriksa daftar domain yang diotorisasi di Google Cloud Support Portal dengan memilih tautan Maps: Manage Client ID dari menu navigasi di sebelah kiri.

Untuk masalah otorisasi, kami sarankan agar Anda meninjau panduan tentang otorisasi pemecahan masalah sebelum mengirimkan kasus.

Saat menggunakan ID klien, tanda tangani permintaan layanan web menggunakan tanda tangan yang dibuat dengan kunci kriptografik privat Anda.

Mengapa penting: Kunci kriptografik privat Anda digunakan untuk membuat tanda tangan digital yang memberi tahu Google bahwa permintaan Anda berasal dari sumber yang dipercaya. Web Service API kami mengharuskan Anda agar menambahkan tanda tangan digital ke permintaan Anda, jika Anda menggunakan ID klien untuk autentikasi. Ini menambahkan lapisan keamanan pada permintaan Anda yang lebih melindungi kuota yang terkait dengan ID klien Anda. Kunci kriptografik Anda (misalnya, vNIXE0xscrmjlyV-12Nj_BvUPaw=) disertakan di surat sambutan yang dikirimkan ke kontak utama organisasi Anda.

Catatan: Kunci kriptografik digunakan untuk membuat tanda tangan. Jangan tambahkan kunci ini ke permintaan sebagai tanda tangan itu sendiri. Kunci kriptografik mirip dengan nomor PIN ATM Anda. Kunci ini digunakan sebagai sarana autentikasi untuk mengakses akun Anda dan harus tidak dibagikan secara terbuka dengan atau terlihat oleh sumber yang tidak dipercaya. Permintaan layanan web Premium Plan yang tidak ditandatangani dengan benar akan ditolak oleh server kami, sehingga penting bagi aplikasi Anda untuk menandatangani permintaan dengan benar sebelum diluncurkan. Lihat panduan tentang autentikasi dan otorisasi.

Lacak pemakaian aplikasi

Mengapa penting: Sebagai pelanggan Premium Plan, Anda memiliki akses ke laporan detail tentang penggunaan aplikasi Anda, termasuk permintaan yang dibuat, kredit yang dikonsumsi, kesalahan yang dikembalikan, dan lebih banyak lagi. Lihat panduan tentang laporan.

Parameter channel adalah parameter opsional yang memungkinkan Anda melacak penggunaan yang menggunakan ID klien Anda dengan menetapkan saluran terpisah ke setiap aplikasi Anda. Parameter saluran tidak perlu didaftarkan ke ID klien Anda. Dengan menambahkan parameter saluran ke permintaan API, hasil penggunaan per saluran akan mulai muncul di laporan penggunaan portal dukungan Anda 1 sampai 2 hari setelah implementasi. Anda bisa menentukan di mana saluran Anda akan diimplementasikan dan demikian juga, bagaimana penggunaan Anda digabungkan. Harap putuskan sebelum peluncuran apakah aplikasi Anda akan mengintegrasikan parameter saluran untuk melacak penggunaan aplikasi Anda.

Parameter channel harus menggunakan format berikut:

  • Harus berupa string alfanumerik ASCII.
  • Karakter titik (.), setrip bawah (_) dan garis pemisah (-) diperbolehkan.
  • Parameter channel peka huruf besar/kecil; parameter channel huruf besar, campuran huruf besar/kecil dan huruf kecil digabungkan ke parameter huruf kecil yang setara. Misalnya, penggunaan pada saluran CUSTOMER dikombinasikan dengan penggunaan pada saluran customer.

Anda bisa mengimplementasikan hingga 2.000 saluran berbeda per ID klien.

Untuk menggunakan parameter channel, sertakan di URL permintaan bersama dengan parameter client yang digunakan untuk meneruskan ID klien.

Harap perhatikan bahwa parameter channel harus berupa nilai yang ditetapkan secara statis per aplikasi. Parameter harus tidak dibuat secara dinamis dan digunakan untuk melacak pengguna individual.