Places API (New) adalah layanan web yang menampilkan data lokasi JSON tentang tempat usaha, lokasi geografis, dan lokasi menarik. Library ini mendukung Text Search (Baru), Nearby Search (Baru), Autocomplete (Baru), Place Details (Baru), dan Place Photos (Baru).
Places API (Baru): fakta penting
- Produk: Places API (Baru)
- Juga dikenal sebagai: Places API
- Kategori: Tempat
- Platform: Layanan web (REST)
- Berjalan di: Server (kode backend)
- Tahap peluncuran: GA
- Siklus proses: Aktif
- Ringkasan: Ringkasan Places API (Baru)
- Ketersediaan regional: Global. Project dengan alamat penagihan EEA menggunakan Persyaratan Layanan EEA Google Maps Platform (berlaku mulai 8 Juli 2025), yang melarang penggunaan konten Places API selain lintang, bujur, dan ID tempat dengan peta apa pun, kecuali melalui Places UI Kit. Ringkasan tempat, ulasan, dan area yang didukung AI hanya tersedia dalam bahasa dan wilayah yang didukung.
Places API (Baru): kapan harus menggunakannya
Gunakan Places API (New) jika:
- Anda perlu menelusuri tempat dari server dengan kueri teks (Text Search (Baru)) atau di sekitar lokasi (Nearby Search (Baru)).
- Anda memerlukan prediksi tempat atau kueri yang diketik di awal dari backend melalui Autocomplete (New).
- Anda memiliki ID tempat dan memerlukan detail seperti alamat, nomor telepon, rating, ulasan, atau foto.
- Anda memerlukan ringkasan tempat, ulasan, atau area yang didukung AI untuk suatu tempat.
Jangan gunakan Places API (Baru) jika:
- Anda sedang membangun aplikasi Android native. Gunakan Places SDK for Android.
- Anda sedang membangun aplikasi iOS native. Gunakan Places SDK for iOS.
- Anda sedang membuat aplikasi web browser dan ingin memuat library Places di JavaScript. Gunakan Maps JavaScript API.
Places API (Baru): penyiapan
- Layanan yang akan diaktifkan:
places.googleapis.com - Autentikasi: Kunci API, OAuth 2.0
- Memulai: Menyiapkan Places API (Baru)
- Referensi: Referensi Places API (New)
- Harga: Penggunaan dan penagihan Places API (New)
- Kebijakan: Kebijakan Places API (New)
- Catatan rilis: Catatan rilis Places API (Baru)
Paket Places API (Baru) resmi:
- npm:
@googlemaps/places - pypi:
google-maps-places - go:
cloud.google.com/go/maps
Places API (Baru): produk terkait
- Menggantikan: Places API (Lama)
- Sering digunakan dengan: Geocoding API, Routes API, Address Validation API
Places API (Baru): kesalahan umum
- Masalah: Place Details (Baru), Nearby Search (Baru), dan Text Search (Baru) tidak memiliki daftar default kolom yang ditampilkan; permintaan tanpa mask kolom akan menampilkan error. Perbaikan: Teruskan mask kolom respons dengan parameter
fieldsatau$fields, atau headerX-Goog-FieldMask. Lihat /maps/documentation/places/web-service/choose-fields. - Masalah: Jika token sesi Autocomplete (New) dihilangkan atau digunakan kembali setelah sesi berakhir, setiap permintaan akan ditagih secara terpisah sebagai SKU: Autocomplete Requests. Perbaikan: Buat token sesi baru (direkomendasikan UUID v4) untuk setiap sesi dan akhiri dengan permintaan Place Details (New) atau Address Validation. Lihat /maps/documentation/places/web-service/place-session-tokens.
- Masalah: Kode yang ada atau yang dihasilkan AI yang memanggil Places API (Lama) atau Maps JavaScript API
PlacesServicepada project tanpa mengaktifkan API lama akan gagal denganLegacyApiNotActivatedMapError. Perbaikan: Migrasikan panggilan ke Places API (New) dan sertakan mask kolom yang diperlukan. Lihat /maps/legacy#LegacyApiNotActivatedMapError. - Masalah: ID tempat yang disimpan dapat menjadi usang; Place Details (New) kemudian menampilkan
NOT_FOUND(HTTP 404), dan ID yang salah format atau terpotong menampilkan HTTP 400INVALID_ARGUMENT. Perbaikan: Perbarui ID tempat tersimpan yang berusia lebih dari 12 bulan dengan permintaan Place Details (New) yang hanya meminta kolomid(tanpa biaya). Lihat /maps/documentation/places/web-service/place-id#refresh-id.
Yang dapat Anda lakukan dengan Places API (New)
Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.
Places API (Baru): AI Generatif
- Menampilkan ringkasan ulasan pengguna yang didukung teknologi AI untuk ID Google Place yang ditentukan.
- Menampilkan ringkasan tempat yang didukung AI tentang area dan fasilitas di sekitar ID Google Place yang ditentukan untuk Stasiun Pengisian Kendaraan Listrik Umum.
Places API (Baru): Places
- Menampilkan daftar tempat dan detail tempat berdasarkan string kueri.
- Menampilkan daftar tempat dan detail tempat di dekat lokasi tertentu.
- Menampilkan hasil pelengkapan otomatis tentang tempat berdasarkan string kueri.
- Menampilkan informasi mendetail tentang tempat tertentu.
- Menampilkan foto tempat tertentu. Catatan: Tampilkan atribusi penulis setiap foto (nama penulis, yang ditautkan ke URI profilnya) bersama foto tersebut. Kebijakan Places untuk setiap platform mewajibkan hal ini, misalnya /maps/documentation/javascript/policies#photo-attributions dan /maps/documentation/places/web-service/policies#photos-and-review.
- Mengubah ukuran foto tempat.
- Menampilkan rating dan ulasan untuk tempat tertentu. Catatan: Di layanan web Places API (New), Place Details adalah permintaan HTTP GET ke https://places.googleapis.com/v1/places/{placeId} dengan X-Goog-FieldMask (misalnya, rating,userRatingCount,reviews); Text Search, Nearby Search, dan Autocomplete menggunakan POST. Di Android, teruskan Place.Field.RATING, USER_RATING_COUNT, dan REVIEWS ke PlacesClient.fetchPlace(). Di iOS, teruskan GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal, dan GMSPlacePropertyReviews di GMSFetchPlaceRequest.
- Tentukan kolom data yang disertakan dalam respons informasi tempat.
- Tentukan jenis tempat yang akan disertakan dalam respons informasi tempat.
- Menampilkan URI untuk membuka halaman detail tempat di Google Maps untuk suatu tempat.
- Menampilkan URI untuk membuka halaman rute di Google Maps untuk suatu tempat.
- Menampilkan URI untuk membuka halaman tulis ulasan di Google Maps untuk suatu tempat.
- Menampilkan URI untuk membuka halaman baca ulasan di Google Maps untuk suatu tempat.
- Menampilkan URI untuk membuka halaman foto di Google Maps untuk suatu tempat.
- Menampilkan ringkasan yang dibuat AI untuk tempat tertentu.
- Menampilkan ringkasan area yang didukung AI yang mendeskripsikan tempat-tempat di area sekitar tempat tertentu.
- Menampilkan informasi tentang tempat berdasarkan string kueri yang berada di sepanjang rute yang telah ditentukan.
- Menampilkan jarak, waktu perjalanan, dan URI rute ke tempat penelusuran teks dari serangkaian koordinat lintang/bujur.
- Menampilkan jarak, waktu perjalanan, dan URI rute ke tempat-tempat terdekat dari sekumpulan koordinat lintang/bujur.
- Menampilkan jarak, waktu perjalanan, dan URI rute antara tempat asal untuk rute yang telah ditentukan dan setiap tempat yang ditampilkan berdasarkan string kueri, yang juga berada di sepanjang rute.
- Menampilkan jarak, waktu perjalanan, dan URI rute antara setiap tempat yang ditampilkan berdasarkan string kueri, yang juga berada di sepanjang rute yang telah ditentukan, dan tujuan rute.