Referensi cepat Places API (Baru)

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:

Places API (Baru): penyiapan

Paket Places API (Baru) resmi:

  • npm: @googlemaps/places
  • pypi: google-maps-places
  • go: cloud.google.com/go/maps

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 fields atau $fields, atau header X-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 PlacesService pada project tanpa mengaktifkan API lama akan gagal dengan LegacyApiNotActivatedMapError. 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 400 INVALID_ARGUMENT. Perbaikan: Perbarui ID tempat tersimpan yang berusia lebih dari 12 bulan dengan permintaan Place Details (New) yang hanya meminta kolom id (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

Places API (Baru): Places