Pengantar
Places API memungkinkan Anda menelusuri dan mengambil informasi untuk berbagai jenis tempat menggunakan string teks atau berdasarkan kedekatan. Places API (Lama) adalah versi lama dari Places API (Baru).
Tabel berikut mencantumkan versi yang sesuai dari kedua API. Gunakan panduan ini untuk memahami perbedaan utama antara keduanya dan bermigrasi ke Places API (Baru).
| Places API (Lama) | Places API (Baru) | Catatan |
|---|---|---|
| Find Place (Lama) | Penelusuran Teks (Baru) | Tidak ada versi baru Find Place (Legacy). Text Search (Baru) telah menggantikannya. |
| Penelusuran di Sekitar (Lama) | Nearby Search (Baru) | Semua permintaan menggunakan API lama yang menyertakan kueri teks harus menggunakan Text Search (Baru) karena Nearby Search (Baru) tidak mendukung input teks. |
| Penelusuran Teks (Lama) | Penelusuran Teks (Baru) | |
| Detail Tempat (Lama) | Detail Tempat (Baru) | |
| Foto Tempat (Lama) | Foto Tempat (Baru) | |
| Place Autocomplete (Lama) | Pelengkapan Otomatis (Baru) | |
| Pelengkapan Otomatis Kueri (Lama) | Pelengkapan Otomatis (Baru) | Kemampuan yang ditambahkan ke Pelengkapan Otomatis (Baru). |
Bermigrasi ke API baru
Untuk bermigrasi ke API baru, lihat panduan migrasi berikut:
- Bermigrasi ke Nearby Search (Baru)
- Bermigrasi ke Penelusuran Teks (Baru)
- Bermigrasi ke Place Details (Baru)
- Bermigrasi ke Foto Tempat (Baru)
- Bermigrasi ke Autocomplete (Baru)
Fitur utama yang ditambahkan ke Places API (Baru)
Bagian ini membahas fitur utama yang ditambahkan ke Places API (Baru).
Diimplementasikan di platform standar Google Cloud
Places API (Baru) diimplementasikan di infrastruktur layanan di Google Cloud. Penerapan ini menghadirkan platform yang lebih aman dan tepercaya dengan opsi keamanan yang ditingkatkan seperti OAuth. Desain API standar ini menghadirkan tingkat konsistensi di seluruh API yang meningkatkan efisiensi pengembangan dengan Places API (Baru).
Peningkatan performa
Places API (Baru) memberikan performa yang lebih baik, sehingga layak untuk menggantikan aplikasi yang menggunakan Places API yang ada.
Harga yang disederhanakan
Harga disederhanakan dengan Places API (Baru) sehingga Anda hanya membayar data yang Anda gunakan. Penetapan harga yang disederhanakan diimplementasikan menggunakan masker kolom.
Dengan Place Details (Baru), Nearby Search (Baru), dan Text Search (Baru), Anda menggunakan mask kolom untuk mengontrol daftar kolom yang akan ditampilkan dalam respons. Kemudian, Anda hanya akan ditagih untuk data yang diminta. Penggunaan penyamaran kolom merupakan praktik desain yang baik untuk memastikan Anda tidak meminta data yang tidak diperlukan. Cara ini akan membantu Anda menghindari waktu pemrosesan dan biaya penagihan yang tidak perlu.
Data respons yang konsisten untuk suatu tempat
Dengan API lama, API Place Details (Lama), Nearby Search (Lama), dan Text Search (Lama) menampilkan data respons yang berbeda untuk suatu tempat. Places API (Baru) menstandardisasi respons sehingga semua API ini menampilkan data yang sama untuk suatu tempat.
Jenis tempat yang diperluas
Respons API kini dapat berisi jenis utama tempat. Setiap tempat dapat memiliki satu nilai jenis yang ditentukan sebagai jenis utama tempat, seperti yang tercantum dalam Tabel A.
API baru ini juga mencakup beberapa jenis baru. Anda dapat menggunakan jenis baru ini, dan jenis yang ada, dalam penelusuran dengan Nearby Search (Baru) dan Text Search (Baru). Semua jenis baru disertakan dalam Tabel A.
Data tempat dinamis
Places API (Baru) mendukung data respons dinamis, seperti ketersediaan SPKLU atau harga bahan bakar terbaru untuk SPBU. Gunakan kolom respons ini untuk menciptakan pengalaman pengguna yang dinamis.