Google membekukan Places API lama pada Maret 2025. Masih berfungsi, tetapi tidak akan menerima fitur baru, dan deprecation akan datang. Bagi developer EU, keputusan migrasi lebih rumit daripada yang disarankan dokumentasi Google.
Pada Maret 2025, Google secara diam-diam merestrukturisasi platform pemetaannya dengan cara yang menciptakan urgensi nyata bagi developer, meskipun pesannya lembut. Places API lama, Directions API, dan Distance Matrix API semuanya diklasifikasikan ulang sebagai "Layanan Warisan." Masih berfungsi. Akan terus berfungsi sampai Google mengumumkan tanggal deprecation. Tetapi sudah dibekukan.
Tidak ada fitur baru. Tidak ada peningkatan arsitektur. Diskon volume dibatasi pada tingkat 100.000+, di bawah kebutuhan aplikasi yang lebih besar. Dan suatu saat di masa depan, pengumuman deprecation dengan pemberitahuan 12 bulan terlampir.
Bagi sebagian besar developer, pertanyaannya bukan apakah akan bermigrasi. Melainkan kapan, dan ke mana.
Bagi developer EU secara khusus, kalkulasinya berbeda. Keputusan migrasi tidak hanya melibatkan kompatibilitas API dan penetapan harga, tetapi juga kepatuhan GDPR, residensi data, dan risiko hukum infrastruktur AS yang tidak sepenuhnya dibahas oleh dokumentasi Google sendiri.
Panduan ini membahas apa yang berubah, apa yang melibatkan migrasi, dan pertanyaan apa yang harus ditanyakan tim EU sebelum berkomitmen pada suatu arah.
Apa yang Diubah Google pada Maret 2025
Restrukturisasi Maret 2025 memiliki dua komponen berbeda yang sering dicampur oleh banyak developer.
Restrukturisasi penetapan harga: Google mengganti kredit bulanan tetap $200/bulan dengan tingkat gratis per-SKU. Alih-alih satu kredit yang dapat diterapkan ke kombinasi API apa pun, setiap jenis API sekarang memiliki tingkat gratisnya sendiri:
- Geocoding API: 10.000 event gratis/bulan, kemudian $2-7 per 1.000
- Maps JavaScript API: 10.000 event gratis/bulan
- Places API (New): tingkat gratis per jenis permintaan
- Routes API: tingkat gratis per jenis rute
Bagi developer yang menggunakan satu API secara intensif di bawah kredit $200 lama, model baru bisa berarti membayar lebih. Bagi developer yang tersebar di beberapa jenis API, tingkat gratis per-SKU sebenarnya dapat mengurangi biaya. Satu-satunya cara untuk mengetahuinya adalah mengaudit penggunaan Anda saat ini terhadap struktur SKU baru.
Seiring dengan perubahan penetapan harga, Google meluncurkan paket langganan: Starter seharga $100/bulan (50.000 panggilan gabungan), Essentials seharga $275/bulan (100.000 panggilan gabungan), dan Pro seharga $1.200/bulan (250.000 panggilan gabungan). Paket-paket ini dimaksudkan untuk memberikan prediktabilitas pada skala tetapi menambahkan lapisan kompleksitas lain pada proyeksi biaya.
Penunjukan deprecation API: Secara terpisah, Google menunjuk tiga API sebagai Layanan Warisan:
- Places API (Legacy): digantikan oleh Places API (New)
- Directions API: digantikan oleh Routes API
- Distance Matrix API: digantikan oleh Routes API dengan computeRouteMatrix
Penunjukan Warisan berarti API-API ini tidak menerima fitur baru dan tidak memenuhi syarat untuk tingkat diskon volume yang diperluas baru. Mereka berada dalam mode pemeliharaan.
Apa yang Sebenarnya Diubah Places API (New)
Places API (New) bukan pengganti langsung. Ini memiliki format permintaan yang berbeda, struktur respons yang berbeda, dan model pemilihan field yang berbeda.
Perubahan paling signifikan adalah field masking. API lama mengembalikan struktur respons tetap. API baru mengharuskan Anda menentukan field mana yang Anda butuhkan melalui header field mask. Ini mengurangi transfer data yang tidak perlu dan berarti Anda hanya membayar untuk field yang Anda minta, tetapi juga berarti setiap panggilan API di basis kode Anda perlu diperbarui dengan field mask eksplisit.
Perbedaan utama yang dihadapi developer selama migrasi:
Format permintaan: API baru menggunakan permintaan POST dengan body JSON alih-alih permintaan GET dengan parameter kueri. Jika integrasi Anda membangun panggilan berbasis URL, setiap panggilan perlu direstrukturisasi.
Struktur respons: Nama field telah berubah. formatted_address menjadi formattedAddress (camelCase). place_id menjadi id. Objek geometry direstrukturisasi. Kode penguraian respons perlu diaudit secara menyeluruh.
Fitur baru hanya di Places API (New): Ringkasan AI generatif, field data baru untuk stasiun pengisian EV, harga bahan bakar, detail aksesibilitas, dan saran pelengkapan otomatis yang ditingkatkan. Jika Anda membutuhkan salah satu dari ini, Anda harus bermigrasi.
Penanganan foto: Format referensi foto telah berubah. URL foto yang dihasilkan oleh API lama pada akhirnya akan berhenti berfungsi, sehingga referensi foto yang di-cache perlu diregenerasi.
Google menyediakan panduan migrasi, tetapi pengalaman praktisnya adalah bahwa migrasi adalah tugas rekayasa yang berarti, bukan perubahan konfigurasi. Tim biasanya menganggarkan satu hingga empat minggu tergantung pada kompleksitas integrasi.
Migrasi Routes API (Terpisah tetapi Terkait)
Directions API dan Distance Matrix API mengikuti pola serupa. Penggantinya adalah Routes API, yang menggunakan format permintaan/respons yang berbeda dan menawarkan fitur yang tidak dimiliki API lama: perutean yang sadar lalu lintas, pengubah rute, dukungan untuk dua roda, dan optimasi efisiensi bahan bakar.
Routes API juga memiliki harga yang berbeda. Directions API lama dihargai per elemen (pasangan asal-tujuan). Routes API dihargai per permintaan rute dan per elemen dalam permintaan matriks. Untuk aplikasi yang membuat permintaan matriks dalam volume tinggi, biayanya mungkin berubah secara signifikan.
Jika Anda bermigrasi Places API, ada baiknya merencanakan migrasi Routes API pada saat yang sama alih-alih menjalankan dua migrasi terpisah. Upaya paralel lebih efisien daripada migrasi berurutan yang masing-masing memerlukan siklus pengujian dan deployment tersendiri.
Pertimbangan Khusus EU
Di sinilah keputusan migrasi menjadi lebih bernuansa bagi developer Eropa daripada yang disarankan dokumentasi Google.
GDPR dan Transfer Data Lintas Batas
Google Maps Platform adalah infrastruktur AS. Ketika browser pengguna membuat permintaan ke Places API atau memuat peta, permintaan itu melewati server berbasis AS milik Google. Di bawah GDPR, ini adalah transfer data lintas batas.
Dasar hukum saat ini untuk transfer ini adalah Kerangka Privasi Data EU-AS, yang menggantikan perjanjian Privacy Shield yang dibatalkan oleh putusan Schrems II pada tahun 2020. DPF telah ditantang secara hukum dan stabilitas jangka panjangnya tidak dijamin. Untuk perusahaan di industri yang diatur (kesehatan, fintech, layanan hukum, aplikasi terkait pemerintah), ketergantungan berkelanjutan pada infrastruktur AS adalah percakapan kepatuhan yang berkelanjutan yang memerlukan pemantauan.
Menggunakan Google Maps API juga memerlukan persetujuan cookie untuk JavaScript API dalam beberapa implementasi, karena alamat IP pengguna dan pengenal perangkat dikirim ke Google. Untuk aplikasi yang ingin memuat peta tanpa memicu banner persetujuan, infrastruktur yang di-host AS menciptakan masalah struktural.
Google memperbarui Ketentuan Layanan EEA Maps Platform pada tahun 2025 untuk diterapkan khusus pada alamat penagihan EU. Developer harus meninjau ketentuan yang diperbarui terhadap persyaratan DPA mereka.
Penyederhanaan Kepatuhan sebagai Pemicu Migrasi
Bagi banyak tim EU, perubahan Maret 2025 memberikan pemicu praktis untuk mengevaluasi ulang apakah akan tetap dalam ekosistem Google atau beralih ke alternatif yang di-host EU.
Argumen bisnis untuk evaluasi ulang sangat jelas: jika Anda akan menginvestasikan waktu rekayasa dalam migrasi (Places API lama ke Places API New), upaya tambahan yang berarti untuk bermigrasi ke penyedia yang berbeda sering kali lebih kecil dari yang terlihat. Perubahan endpoint API, pekerjaan pemetaan field, dan siklus pengujian sebagian besar sama apakah Anda bermigrasi ke API baru Google atau ke alternatif pihak ketiga. Perbedaannya ada pada apa yang Anda dapatkan saat selesai.
API pemetaan yang di-host EU sepenuhnya menghilangkan kekhawatiran transfer lintas batas GDPR. Semua permintaan tetap berada di EU. Tidak ada SCC yang perlu dinegosiasikan, tidak ada ketergantungan DPF, tidak ada persetujuan cookie yang diperlukan untuk memuat peta. Untuk perusahaan yang baru saja menyelesaikan audit GDPR atau mengantisipasi satu, penyederhanaan ini memiliki nilai organisasi yang nyata.
Mengevaluasi Apakah Bermigrasi dalam Google atau Beralih Penyedia
Kerangka jujur untuk keputusan ini memiliki empat bagian.
1. Audit penggunaan API Anda saat ini
Sebelum membuat keputusan apa pun, petakan setiap panggilan Places API, panggilan Directions API, dan panggilan Distance Matrix API dalam basis kode Anda. Hitung volume per jenis endpoint. Petakan ke model penetapan harga Places API (New) dan ke endpoint yang setara di penyedia alternatif kandidat.
Perbandingan biaya hanya masuk akal dengan data penggunaan nyata. Perkiraan kasar berdasarkan total volume permintaan tidak cukup karena API yang berbeda dalam penyedia yang sama memiliki harga yang berbeda.
2. Evaluasi eksposur GDPR
Tanyakan kepada tim hukum atau kepatuhan Anda seberapa besar risiko berkelanjutan yang ditimbulkan ketergantungan infrastruktur AS untuk konteks spesifik Anda. Untuk produk SaaS dengan pelanggan EU korporat yang memiliki DPA yang berlaku, tingkat risiko berbeda dari aplikasi konsumen yang memproses data pribadi sensitif.
Jika penyederhanaan kepatuhan berharga, tetapkan biayanya. Overhead hukum internal dalam mempertahankan SCC, memantau stabilitas DPF, dan menangani kuesioner kepatuhan pelanggan adalah pekerjaan nyata dengan biaya nyata.
3. Nilai upaya migrasi untuk setiap jalur
Bermigrasi ke Places API (New) dalam Google: perkirakan berdasarkan kompleksitas integrasi Anda. Perubahan field masking, restrukturisasi permintaan, pembaruan penguraian respons. Biasanya satu hingga empat minggu upaya rekayasa.
Bermigrasi ke alternatif pihak ketiga: cakupan rekayasa yang serupa. Perubahan URL endpoint, perbedaan parameter, perbedaan format respons. Untuk tim yang sudah menggunakan MapLibre GL JS sebagai lapisan rendering (fork open-source dari Mapbox GL JS), lapisan rendering tetap sama. Hanya panggilan geocoding, pencarian, dan perutean yang berubah.
4. Pertimbangkan apa yang Anda dapatkan di sisi lain
Places API (New) memberi Anda akses ke fitur terbaru Google: pelengkapan otomatis yang lebih baik, ringkasan AI generatif, data tempat yang diperluas. Cakupan data Google tidak tertandingi secara global.
Alternatif yang di-host EU seperti MapAtlas memberi Anda kepatuhan GDPR berdasarkan desain, residensi data EU, dan dalam beberapa kasus alat visibilitas pencarian AI yang tidak disediakan oleh API Google. Untuk aplikasi di real estat, perhotelan, atau logistik di mana kemampuan penemuan AI halaman lokasi penting, lapisan visibilitas AI adalah diferensiator yang berarti.
Tidak ada jalur yang secara universal benar. Jawaban yang tepat tergantung pada persyaratan kepatuhan Anda, sensitivitas harga, dan fitur mana yang paling penting untuk aplikasi Anda.
Yang Perlu Dilakukan Sekarang
Terlepas dari jalur migrasi mana yang Anda pilih, beberapa tindakan masuk akal segera:
Audit dan dokumentasikan permukaan API Anda saat ini: Ketahui persis endpoint lama mana yang Anda gunakan, seberapa sering, dan field data apa yang Anda andalkan. Informasi ini diperlukan untuk keputusan migrasi apa pun.
Jalankan perbandingan penetapan harga dengan angka nyata: Gunakan data penggunaan aktual Anda untuk membandingkan penetapan harga lama, penetapan harga Places API (New), dan penyedia alternatif. Lakukan ini pada volume Anda saat ini dan pada 2x volume Anda saat ini.
Periksa dokumentasi GDPR Anda: Tinjau DPA Anda saat ini dengan Google, SCC atau ketergantungan DPF Anda, dan implementasi persetujuan cookie Anda. Pahami posisi hukum Anda saat ini sebelum mengubahnya.
Jangan bermigrasi di bawah tekanan waktu: API lama masih berfungsi. Dibekukan, bukan rusak. Buat keputusan migrasi dengan data yang jelas dan runway rekayasa yang memadai daripada terburu-buru karena urgensi yang dirasakan. Pengumuman deprecation akan memberi Anda pemberitahuan 12 bulan.
Tetapkan tenggat keputusan: "Saat Google mengumumkan deprecation" bukan rencana. Tetapkan titik keputusan internal untuk jalur migrasi mana yang Anda ambil, idealnya dalam kuartal berikutnya.
Jika Anda ingin membandingkan tampilan API pemetaan yang di-host EU dalam hal permukaan API, penetapan harga, dan upaya migrasi, MapAtlas mencakup geocoding, pelengkapan otomatis alamat, perutean, dan tile peta di bawah satu model penetapan harga dengan residensi data EU. Halaman harga menampilkan struktur tingkat saat ini, dan tingkat gratis (10.000 permintaan per bulan untuk sebagian besar API, 25.000 untuk geocoding) memungkinkan Anda menguji integrasi sebelum membuat komitmen.
Pertanyaan yang Sering Diajukan
Kapan Google akan menghentikan Places API lama?
Google belum menetapkan tanggal deprecation final per awal 2026. API lama dibekukan pada Maret 2025 dan tidak lagi menerima fitur baru. Kebijakan Google adalah memberikan setidaknya 12 bulan pemberitahuan sebelum deprecation. Perlakukan migrasi sebagai mendesak tetapi bukan darurat.
Apakah Places API (New) lebih mahal daripada Places API lama?
Tergantung pada pola penggunaan Anda. Tingkat gratis per-SKU baru menguntungkan beberapa profil penggunaan dan merugikan yang lain. Petakan panggilan API Anda saat ini ke struktur SKU baru dengan data penggunaan aktual Anda sebelum menarik kesimpulan.
Apakah saya juga perlu bermigrasi dari Directions API?
Ya, jika Anda ingin fitur baru dan diskon volume yang lebih baik. Directions API dan Distance Matrix API keduanya ditetapkan sebagai Layanan Warisan pada Maret 2025. Penggantinya adalah Routes API, yang memerlukan evaluasi migrasi terpisahnya sendiri.
Apa risiko GDPR dari terus menggunakan Google Maps API sebagai developer EU?
Google Maps Platform menggunakan infrastruktur AS, yang memerlukan mekanisme transfer data lintas batas di bawah GDPR. Dasar saat ini adalah Kerangka Privasi Data EU-AS, yang telah ditantang secara hukum. Untuk industri yang diatur, ini adalah risiko kepatuhan berkelanjutan yang memerlukan pemantauan.
Berapa lama migrasi ke penyedia alternatif?
Upaya rekayasa serupa dengan bermigrasi dalam Google: satu hingga empat minggu tergantung pada kompleksitas integrasi, sebagian besar dihabiskan untuk pembaruan endpoint, perbedaan parameter, dan pengujian format respons. Tim yang menggunakan MapLibre GL JS untuk rendering memiliki jalur migrasi paling ringan karena lapisan rendering tetap sama.
Kesimpulan
Perubahan Maret 2025 menempatkan hitungan mundur pada penggunaan Places API lama tanpa memulai hitungan mundur secara resmi. API masih berfungsi. Tanggal deprecation belum diumumkan. Tetapi arahnya sudah jelas, dan migrasi akan lebih menyakitkan dengan perencanaan yang memadai daripada dengan urgensi.
Untuk developer EU, momen migrasi juga merupakan momen evaluasi. Upaya rekayasa untuk mengubah endpoint API sebagian besar sama apakah Anda tetap dalam Google atau beralih ke alternatif yang di-host EU. Perbedaan yang berarti adalah apa yang Anda bawa ke depan: kumpulan data global komprehensif dan fitur terbaru Google, atau kepatuhan GDPR berdasarkan desain, penetapan harga yang lebih sederhana, dan residensi data EU.
Itu adalah keputusan yang layak dibuat secara bijaksana, dengan data penggunaan nyata dan pandangan jelas tentang persyaratan kepatuhan Anda, daripada secara default memilih jalur hambatan paling sedikit saat ini.
Bacaan terkait:
- Alternatif Google Maps API untuk developer EU
- Panduan developer EU untuk API peta yang patuh GDPR
- Penetapan harga Google Maps API 2026: apa yang sebenarnya Anda bayar
- Beralih dari Google Maps API: apa yang dipilih developer EU
- API pelengkapan otomatis alamat: cara meningkatkan konversi checkout
Pertanyaan yang Sering Diajukan
Kapan Google akan menghentikan Places API lama?
Google belum menetapkan tanggal deprecation final untuk Places API lama per awal 2026. Namun, kebijakan resmi Google adalah memberikan setidaknya 12 bulan pemberitahuan sebelum deprecation. API lama ditetapkan sebagai 'Layanan Warisan' pada Maret 2025, artinya tidak lagi menerima fitur baru dan diskon volume dibatasi pada tingkat 100.000+. Developer harus memperlakukan migrasi sebagai mendesak meskipun tanpa tenggat waktu yang pasti.
Apakah Places API (New) lebih mahal daripada Places API lama?
Tergantung pada pola penggunaan Anda. Places API (New) menggunakan model penetapan harga berbeda dengan tingkat gratis per-SKU daripada kredit bulanan $200 yang lama. Untuk beberapa profil penggunaan, biayanya serupa atau lebih rendah. Untuk yang lain, terutama developer yang mengandalkan kredit tetap untuk mencakup beberapa jenis API, model baru bisa lebih mahal. Satu-satunya cara untuk mengetahuinya dengan pasti adalah memetakan panggilan API Anda saat ini ke struktur SKU baru dan menghitung sebelum bermigrasi.
Apakah saya juga perlu bermigrasi dari Directions API?
Ya, jika Anda ingin mengakses fitur baru dan diskon volume yang lebih baik. Google menetapkan Directions API dan Distance Matrix API sebagai Layanan Warisan bersamaan dengan Places API pada Maret 2025. Penggantinya adalah Routes API (untuk arah) dan Routes API dengan computeRouteMatrix (untuk matriks jarak). Migrasi terpisah dari migrasi Places API dan memerlukan evaluasi tersendiri.
Apa risiko GDPR dari terus menggunakan Google Maps API sebagai developer EU?
Google Maps Platform memproses data di infrastruktur AS, yang berarti penggunaannya melibatkan transfer data lintas batas di bawah GDPR. Ini memerlukan Klausul Kontraktual Standar atau ketergantungan pada Kerangka Privasi Data EU-AS. DPF telah ditantang secara hukum sebelumnya dan tetap menjadi risiko kepatuhan. Untuk developer di industri yang diatur (kesehatan, fintech, pemerintahan) atau organisasi yang baru saja menjalani audit GDPR, eksposur hukum ini adalah kekhawatiran berkelanjutan yang serius.
Berapa lama migrasi dari Google Places API ke alternatif lain?
Bermigrasi ke Places API (New) dalam ekosistem Google biasanya membutuhkan satu hingga empat minggu tergantung pada kompleksitas integrasi Anda. Bermigrasi ke alternatif pihak ketiga membutuhkan waktu yang serupa: sebagian besar dihabiskan untuk memperbarui URL endpoint, meninjau perbedaan parameter, dan menguji format respons geocoding dan pencarian. Untuk tim yang menggunakan MapLibre GL JS sebagai lapisan rendering, migrasi rendering sering menjadi bagian tercepat. Pengujian API geocoding dan pencarian adalah tempat sebagian besar upaya dilakukan.
