Places API (Lama) tidak dapat lagi diaktifkan untuk project Google Cloud baru mulai Oktober 2026. Project yang ada tetap didukung sepenuhnya. Untuk fitur baru dan peningkatan performa, lakukan migrasi ke Places API (New).
Places API (Lama): fakta penting
- Produk: Places API (Lama)
- Juga dikenal sebagai: Places API (layanan web lama), layanan web Places API (maps/api/place)
- Kategori: Tempat
- Platform: Layanan web (REST)
- Berjalan di: Server (kode backend)
- Tahap peluncuran: GA
- Siklus proses: Lama
- Digantikan oleh: Places API (Baru)
- Ringkasan: Ringkasan Places API (Lama)
Places API (Lama): kapan harus menggunakannya
Gunakan Places API (Lama) jika:
- Anda mengelola project yang sudah ada dan telah mengaktifkan Places API (Lama) serta memanggil endpoint
maps.googleapis.com/maps/api/place. - Anda memerlukan panggilan Find Place, Nearby Search, Text Search, Details, Photos, atau Autocomplete (Lama) yang sudah ada agar tetap berfungsi saat Anda bermigrasi.
Jangan gunakan Places API (Lama) jika:
- Anda memulai project Google Cloud baru. Mulai Oktober 2026, Places API (Lama) tidak dapat diaktifkan untuk project baru. Gunakan Places API (Baru).
- Anda memerlukan fitur baru, autentikasi OAuth, atau mask kolom di Nearby Search dan Text Search agar Anda hanya membayar kolom yang Anda minta. Gunakan Places API (Baru).
- Anda memerlukan Find Place (Lama) atau Query Autocomplete (Lama) dalam kode baru. Text Search (Baru) dan Autocomplete (Baru) menggantikannya. Gunakan Places API (Baru).
Places API (Lama): penyiapan
- Layanan yang akan diaktifkan:
places-backend.googleapis.com - Autentikasi: Kunci API
- Harga: Penggunaan dan penagihan Places API (Lama)
- Kebijakan: Kebijakan Places API (Lama)
Places API (Lama): kesalahan umum
- Masalah: Jika permintaan Place Details (Lama) tidak menyertakan parameter
fieldsatau tidak menentukan kolom, API akan menampilkan semua kolom dan menagih Anda untuk semua kolom tersebut. Perbaikan: Selalu tetapkan parameterfields, atau migrasikan ke Place Details (New) dengan masker kolom. Lihat /maps/documentation/places/web-service/legacy/details. - Masalah: Nearby Search (Lama) dan Text Search (Lama) tidak mendukung penentuan kolom yang akan ditampilkan. Metode ini selalu menampilkan kumpulan kolom tetap (subset kolom Place Details) dan memicu SKU Basic Data, Contact Data, dan Atmosphere Data. Perbaikan: Migrasikan ke Nearby Search (Baru) atau Text Search (Baru) dengan mask kolom, atau gunakan Find Place (Lama) dengan parameter
fieldsuntuk meminta dan membayar hanya kolom yang Anda perlukan. Lihat /maps/billing-and-pricing/sku-details/legacy#places_nearby-search-legacy-pro-sku. - Masalah:
photo_referencetidak dapat di-cache dan dapat habis masa berlakunya, sehingga referensi yang disimpan berhenti berfungsi. Perbaikan: Dapatkanphoto_referencebaru dari respons Place Details, Find Place, Nearby Search, atau Text Search sebelum Anda meminta foto. Lihat /maps/documentation/places/web-service/legacy/photos. - Masalah: Panggilan ke Places API (Lama) dari project yang tidak mengaktifkannya akan menampilkan
REQUEST_DENIEDdengan pesan error "You're calling a legacy API, which is not enabled for your project..." (LegacyApiNotActivatedMapError). Mulai Oktober 2026, Places API (Lama) tidak dapat diaktifkan untuk project baru. Perbaikan: Gunakan Places API (New) untuk project baru dan migrasikan aplikasi yang ada. Saat bermigrasi, Anda dapat meminta aktivasi jangka pendek API lama melalui formulir masukan di halaman lama. Lihat /maps/legacy#LegacyApiNotActivatedMapError.
Places API (Lama): fitur lama dan yang tidak digunakan lagi
- Kolom respons
permanently_closed: Tidak digunakan lagi sejak 26-05-2020. Pengganti: Kolombusiness_status. Lihat panduan migrasi. - Kolom respons
reference: Tidak digunakan lagi sejak 03-09-2019. Pengganti: Kolomplace_id. Lihat panduan migrasi. - Parameter permintaan Nearby Search (Lama)
name: Tidak digunakan lagi. Penggantian: Parameterkeyword. Lihat panduan migrasi.