Daftar Isi
NS Google Places API mendukung pencarian tempat, pelengkapan otomatis, penemuan tempat terdekat, detail bisnis, dan fitur berbasis lokasi lainnya. Tantangan sesungguhnya adalah menentukan layanan Places mana yang sesuai untuk tugas tersebut, bidang data mana yang layak diminta, dan bagaimana pilihan-pilihan tersebut memengaruhi biaya.
Langkah Google menuju Places API (Baru) mengubah cara pengembang menangani permintaan, pemilihan kolom, data respons, dan penagihan. Pola implementasi lama tidak selalu dapat diterapkan dengan mulus, terutama ketika masker kolom dan penetapan harga berbasis SKU mulai diterapkan.
The right setup depends on what you are building. A location search inside an app may only need a small set of place details. A team using the Google Places API for lead generation across many cities may need a different workflow. Treating both use cases the same can add unnecessary cost and extra API work.
Sebelum memilih titik akhir (endpoint) atau memperkirakan penggunaan bulanan, ada baiknya memahami bagaimana Google menyusun fitur pencarian Places, pemilihan bidang, penagihan, dan kuota. Keputusan-keputusan tersebut juga memudahkan untuk mengetahui kapan API Places resmi cocok untuk kebutuhan tersebut dan kapan alur kerja data bisnis yang terpisah lebih masuk akal.
Jawaban Singkat: Cara Kerja API Google Places
- Cari tempat menggunakan Pencarian Teks atau Pencarian di Sekitar.
- Lihat detail, foto, dan ID Tempat untuk lokasi tertentu.
- Gunakan fitur Autocomplete untuk menampilkan saran lokasi saat pengguna mengetik.
- Siapkan proyek Google Cloud, pengaturan penagihan, dan kunci API dengan batasan akses.
- Gunakan masker kolom untuk mengontrol data yang ditampilkan dan penagihan.
- Biaya bergantung pada jenis layanan, bidang yang diminta, dan pemakaian.
- Untuk data bisnis dalam jumlah besar atau kolom kontak tambahan, alur kerja data yang berbeda mungkin lebih sesuai.
Apa Itu Google Places API?
Google Places API merupakan bagian dari Google Maps Platform. API ini memberikan pengembang akses secara terprogram ke informasi mengenai bisnis, tempat-tempat penting, alamat, lokasi geografis, dan tempat-tempat lain yang terdaftar dalam basis data tempat milik Google.
Google saat ini menyatakan API Tempat (Baru) menyediakan data lokasi untuk lebih dari 200 juta tempat. Para pengembang dapat memanfaatkannya untuk menambahkan fitur pencarian tempat, penemuan tempat terdekat, pelengkapan otomatis, detail tempat, dan foto ke situs web, aplikasi seluler, serta perangkat lunak lainnya.
Permintaan yang umum dimulai dengan kueri pencarian, wilayah geografis, atau Place ID yang diketahui. Google menampilkan informasi tempat yang terstruktur berdasarkan jenis permintaan dan bidang-bidang yang dipilih oleh pengembang.
Misalnya, sebuah aplikasi pencari restoran dapat menggunakan fitur Pencarian di Sekitar untuk menemukan restoran-restoran di sekitar lokasi pengguna. Setelah pengguna memilih sebuah restoran, aplikasi tersebut dapat meminta Detail Tempat untuk mendapatkan informasi seperti alamat, peringkat, jam buka, nomor telepon, atau ulasan.
Data Apa Saja yang Dapat Dikembalikan oleh Google Places API?
Kolom yang tersedia bergantung pada permintaan dan kolom yang tercantum dalam masker kolom. Places API (Baru) dapat mengembalikan informasi seperti:
| Tipe Data | Contoh Kolom | Apa yang Dijelaskan di Sini |
|---|---|---|
| Identitas | Nama tempat, ID tempat, jenis tempat | Menunjukkan lokasi dan kategorinya. |
| Lokasi | Alamat, koordinat geografis | Menunjukkan di mana lokasi tempat tersebut berada. |
| Rincian Bisnis | Status usaha, nomor telepon, situs web, jam operasional | Menyediakan informasi operasional dan kontak. |
| Informasi Pelanggan | Peringkat, ulasan, informasi harga | Menyediakan data terkait penilaian, ulasan, dan harga. |
| Media | Foto-foto | Menampilkan gambar-gambar yang tersedia yang terkait dengan tempat tersebut. |
| Aksesibilitas | Informasi Aksesibilitas | Menjelaskan fitur-fitur aksesibilitas yang didukung. |
| Pilihan Layanan | Pengiriman, makan di tempat, pengambilan di tepi jalan | Menampilkan opsi layanan yang tersedia jika didukung. |
Google mengelompokkan kolom-kolom ini ke dalam tingkat harga yang berbeda-beda. Beberapa kolom dasar termasuk dalam SKU dengan biaya lebih rendah, sedangkan kolom seperti penilaian, jam operasional, dan ulasan dapat menyebabkan penerapan SKU dengan harga lebih tinggi. Google menjelaskan hubungan antara kolom dan penagihan dalam Dokumentasi bidang data Places API. Pilih hanya kolom-kolom yang dibutuhkan oleh aplikasi, karena pemilihan kolom dapat mengubah SKU penagihan.
API Places (Baru) juga mengharuskan adanya masker bidang untuk permintaan Detail Tempat, Pencarian Teks, dan Pencarian di Sekitar. Setidaknya satu bidang harus ditentukan. Permintaan tanpa masker bidang akan menghasilkan kesalahan.
Bagaimana Places API Terintegrasi ke dalam Google Maps Platform
API Places mengelola informasi mengenai lokasi, namun API ini hanyalah salah satu bagian dari Google Maps Platform.
Seorang pengembang dapat menggunakan Places API untuk mencari sebuah bisnis, lalu menggunakan layanan Google Maps Platform lainnya untuk tugas yang berbeda. Misalnya, Geocoding API dapat mengubah alamat menjadi koordinat, sedangkan layanan perutean dapat menghitung petunjuk arah atau waktu tempuh antar lokasi.
Di dalam Places API itu sendiri, layanan-layanan utama menangani berbagai bagian dari proses pencarian lokasi:
- Pencarian Teks mencari lokasi berdasarkan permintaan tertulis.
- Pencarian di Sekitar menemukan lokasi-lokasi di dalam wilayah geografis yang telah ditentukan.
- Detail Lokasi mengambil informasi mengenai suatu tempat yang sudah dikenal.
- Pengisian Otomatis menampilkan saran lokasi saat pengguna mengetik.
- Letakkan Foto mengambil gambar-gambar yang tersedia yang terkait dengan suatu tempat.
Google menyarankan untuk menggunakan Detail Lokasi ketika ID Tempat sudah diketahui, karena tidak perlu menjalankan permintaan pencarian lain untuk tempat yang sama.
Pencarian bisnis di seluruh kota, kotak pelengkapan otomatis, dan permintaan detail mengenai satu lokasi tertentu masing-masing memerlukan metode Places API yang berbeda.
Cara Kerja API Google Places
API Google Places menggunakan metode yang berbeda-beda, tergantung pada data masukan yang sudah Anda miliki dan jenis data lokasi yang Anda butuhkan.
Permintaan tertulis, sekumpulan koordinat, dan ID Tempat yang diketahui masing-masing memerlukan metode yang berbeda. Places API (Baru) saat ini menyediakan Pencarian Teks, Pencarian di Sekitar, Detail Tempat, Pelengkapan Otomatis, dan Foto Tempat untuk tugas-tugas tersebut.
Pencarian Teks
Pencarian Teks menemukan tempat berdasarkan kueri tertulis, seperti nama bisnis, kategori, alamat, atau frasa seperti pizza in New York.
Pencarian Teks (Baru) menggunakan permintaan HTTP POST dan mengembalikan objek Tempat yang sesuai. Parameter opsional dapat mempersempit hasil pencarian berdasarkan lokasi, jenis tempat, status operasional, peringkat, atau kisaran harga.
Saat ini, Google menampilkan hingga 60 hasil di seluruh halaman dan menyebutkan bahwa permintaan yang sama tidak selalu menghasilkan daftar yang sama.
Pencarian di Sekitar
Pencarian di Sekitar mencari tempat-tempat di dalam wilayah geografis tertentu.
Permintaan tersebut menggunakan koordinat lintang, bujur, dan jari-jari, lalu menyaring hasil berdasarkan satu atau lebih jenis tempat. Misalnya, sebuah aplikasi dapat mencari restoran yang berada dalam jarak tertentu dari sebuah hotel.
Pencarian di Sekitar (Baru) juga menggunakan HTTP POST dan memerlukan masker kolom untuk data yang dikembalikan.
Detail Lokasi
Fitur Detail Lokasi mengambil informasi mengenai satu lokasi yang diketahui berdasarkan ID Lokasinya.
Alur yang umum adalah:
- Temukan tempat dengan fitur Pencarian Teks, Pencarian di Sekitar, atau Pelengkapan Otomatis.
- Pertahankan ID Lokasinya.
- Mintalah hanya informasi yang diperlukan oleh aplikasi tersebut.
Hal ini mencegah dilakukannya pencarian lagi ketika lokasi tersebut sudah teridentifikasi.
Pengisian Otomatis
Fitur autocomplete menampilkan saran lokasi saat pengguna mengetik di kolom pencarian.
Token sesi dapat mengelompokkan permintaan pengguna ke dalam satu sesi pencarian untuk keperluan penagihan. Setiap pencarian baru harus menggunakan token baru, dan sesi tersebut harus diakhiri dengan permintaan Place Details atau Address Validation yang kompatibel.
Foto Lokasi dan ID Lokasi
Fitur "Foto Tempat" menampilkan gambar-gambar yang terkait dengan suatu tempat ketika photos bidang tersebut ditampilkan oleh Pencarian Teks, Pencarian di Sekitar, atau Detail Tempat.
ID Lokasi berfungsi untuk mengidentifikasi lokasi tertentu sehingga lokasi tersebut dapat dirujuk kembali di seluruh layanan Google Maps Platform yang didukung.
Misalnya, sebuah aplikasi dapat menemukan sebuah bisnis melalui Pencarian Teks, menyimpan Place ID-nya, dan kemudian meminta Detail Tempat tanpa perlu mengulangi pencarian awal.
API Places (Baru) vs. API Places (Lama)
Google telah menetapkan API Places versi asli ke status Legacy pada tanggal 1 Maret 2025. Proyek-proyek yang sudah ada masih dapat menggunakannya, namun proyek-proyek Cloud baru tidak dapat mengaktifkan layanan Legacy.
Places API (Baru) kini menjadi versi yang direkomendasikan Google untuk pengembangan baru. Perubahan tersebut mencakup metode permintaan, pemilihan bidang, struktur respons, otentikasi, dan penagihan.
Apa yang Berubah di Places API (Baru)?
Pencarian Teks dan Pencarian di Sekitar Sekarang menggunakan HTTP POST, bukan pola berbasis GET yang digunakan oleh versi lama.
API Places (Baru) juga mendukung kunci API dan OAuth, mengembalikan respons dalam format JSON, serta memerlukan masker bidang untuk Detail Tempat, Pencarian Teks, dan Pencarian di Sekitar.
Find Place tidak memiliki versi baru yang langsung tersedia. Google mengalihkan pencarian tersebut ke Text Search.
Masker Bidang dan Perubahan Respons
Masker bidang merupakan salah satu perbedaan utama antara Places API (Baru) dan API versi lama.
Untuk Detail Lokasi, Pencarian Teks, dan Pencarian di Sekitar, permintaan harus menentukan setidaknya satu bidang yang akan ditampilkan. Jika masker bidang tidak dicantumkan, permintaan akan gagal.
Pemilihan kolom juga memengaruhi penagihan karena Google menetapkan kolom data lokasi ke berbagai SKU. Bagian mengenai harga yang akan dibahas nanti dalam artikel ini menjelaskan hubungan tersebut secara lebih rinci.
Objek respons juga telah berubah. Places API (Baru) menggunakan nama bidang dalam format camelCase, bukan nama-nama dalam format snake_case yang banyak ditemukan pada respons versi lama.
Contohnya antara lain:
alamat_terformatmenjadialamat yang telah diformatstatus_bisnismenjadistatus bisnisnomor_telepon_yang_diformatmenjadinomorTeleponNasionalgeometri.lokasimenjadilokasi
Pencarian Teks dan Pencarian di Sekitar juga menampilkan hasil dalam bentuk tempat array, bukan Legacy hasil array. Informasi status dan kesalahan kini menggunakan kode dan pesan respons HTTP standar, bukan lagi bidang-bidang lama seperti status dan pesan_kesalahan.
Perubahan ini penting jika aplikasi yang ada menganalisis respons Legacy atau bergantung pada nama bidang yang lebih lama.
Hal-hal yang Perlu Diketahui Pengguna API Lama Mengenai Migrasi
Migrasi biasanya tidak hanya sekadar mengganti titik akhir. Google menyediakan sebuah Panduan Migrasi API Places membahas perbedaan utama antara Legacy API dan Places API (Baru).
Periksa dulu bagian-bagian berikut ini:
- Pindahkan pencarian "Temukan Tempat" ke "Pencarian Teks (Baru)".
- Ubah permintaan Pencarian Teks dan Pencarian di Sekitar dari GET menjadi POST.
- Tambahkan masker kolom yang wajib diisi.
- Perbarui kode yang membaca bidang respons Legacy.
- Periksa SKU yang digunakan oleh setiap permintaan.
Pastikan juga bahwa Places API (Baru) telah diaktifkan di proyek tersebut dan diizinkan oleh batasan kunci API.
Jika permintaan Legacy dan New perlu dijalankan secara bersamaan selama pengujian, pisahkan kedua alur tersebut. Google merekomendasikan penggunaan kunci API yang terpisah selama proses migrasi.
Integrasi Legacy yang sudah ada dapat tetap berjalan untuk saat ini, tetapi proyek-proyek baru sebaiknya menggunakan Places API (Baru).
Tutorial API Google Places: Pengaturan dan Permintaan Pertama Anda
Untuk menggunakan Places API (Baru), Anda harus terlebih dahulu memiliki proyek Google Cloud yang terhubung ke akun penagihan. Proyek tersebut harus telah mengaktifkan Places API (Baru) sebelum permintaan yang terotentikasi dapat dikirim.
Untuk permintaan layanan web dasar, proses penyiapannya terdiri dari lima langkah: pilih proyek Cloud, aktifkan API, buat kunci API, batasi akses kunci tersebut, dan kirim permintaan dengan kolom-kolom yang ingin Anda terima hasilnya.
Buat atau Pilih Proyek Google Cloud
Setiap permintaan Google Maps Platform tergabung dalam sebuah proyek Google Cloud.
Anda dapat membuat proyek baru atau menggunakan proyek yang sudah ada. Proyek yang dipilih juga harus memiliki akun penagihan yang aktif. Google menggunakan proyek tersebut untuk melacak akses API, penggunaan, kuota, dan biaya.
Memisahkan proyek-proyek juga bisa menjadi pilihan yang tepat ketika lingkungan pengembangan, pengujian, dan produksi memerlukan kredensial atau kontrol penggunaan yang berbeda.
Setelah proyek yang tepat dipilih, Places API (Baru) dapat diaktifkan dari Google Cloud Console.
Aktifkan Places API (Baru)
API Places (Baru) harus diaktifkan untuk proyek tersebut sebelum aplikasi dapat memanggil metode layanan webnya.
Di Google Cloud Console:
- Pilih proyek yang ingin Anda gunakan.
- Membuka API & Layanan.
- Temukan API Tempat (Baru) di Perpustakaan API.
- Aktifkan fitur ini untuk proyek tersebut.
Perbedaan ini penting bagi proyek-proyek lama karena Places API (Legacy) dan Places API (New) merupakan layanan yang terpisah. Sebuah proyek yang sebelumnya menggunakan API Legacy mungkin masih perlu mengaktifkan Places API (New) agar titik akhir yang lebih baru dapat berfungsi.
Pengaturan dan Batasan Kunci API
Kunci API mengidentifikasi proyek Google Cloud yang mengirimkan permintaan tersebut.
Google mewajibkan agar fitur penagihan diaktifkan terlebih dahulu sebelum Places API (Baru) dapat digunakan untuk permintaan langsung. Jika Anda hanya mengikuti proses penyiapan dan belum ingin menghubungkan akun penagihan, Anda dapat menghentikan proses sebelum membuat kunci dan kembali ke langkah ini nanti.
Jika fitur penagihan diaktifkan, buatlah kunci API di Google Cloud Console dan batasi aksesnya sebelum menggunakannya dalam suatu aplikasi.
Untuk permintaan Places API di sisi server, pembatasan alamat IP dapat membatasi penggunaan kunci tersebut hanya pada server yang disetujui. Anda juga dapat membatasi kunci tersebut agar hanya berfungsi dengan Places API (Baru) dan layanan Google Maps Platform lainnya yang benar-benar dibutuhkan oleh aplikasi.
Google juga mewajibkan agar permintaan layanan web Places API menggunakan HTTPS. Kunci yang hilang, pembatasan yang salah, atau konfigurasi yang tidak didukung dapat mengakibatkan respons berupa REQUEST_DENIED tanggapan.
Contoh Google Places API: Membuat Permintaan Pencarian Teks Pertama Anda
Pencarian Teks adalah contoh sederhana dari Google Places API untuk memahami format permintaan, header kunci API, dan masker bidang.
API Places (Baru) mengirimkan permintaan Pencarian Teks ke:
https://places.googleapis.com/v1/places:searchText
Permintaan ini menggunakan metode HTTP POST. Teks pencarian dimasukkan ke dalam isi JSON, sedangkan kunci API dan masker bidang dapat dikirim melalui header permintaan.
Permintaan dasar bisa terlihat seperti ini:
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: YOUR_API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.formattedAddress" \
-d '{ "textQuery": "dentists in Chicago" }' \
"https://places.googleapis.com/v1/places:searchText"
Permintaan ini mencari dentists in Chicago dan meminta Google untuk hanya menampilkan:
- ID Tempat
- nama tampilan
- alamat yang telah diformat
Respons yang berhasil akan mengembalikan objek Place yang cocok di dalam sebuah places array. Kolom-kolom yang tercantum dalam setiap hasil bergantung pada masker kolom yang digunakan dalam permintaan.
Penggunaan masker bidang terbatas membuat hasil respons lebih mudah dibaca dan mencegah permintaan data yang tidak diperlukan oleh aplikasi.
Untuk mengetahui parameter permintaan terkini, bidang yang didukung, kuota, dan perubahan API, silakan lihat situs resmi Dokumentasi Google Places API.
Contoh Google Places API: Mengambil Detail Tempat
Hasil Pencarian Teks dapat menampilkan ID Tempat untuk setiap lokasi yang cocok. Setelah aplikasi mengetahui ID Tempat tersebut, aplikasi dapat menggunakan Detail Tempat untuk meminta informasi mengenai tempat spesifik tersebut tanpa perlu melakukan pencarian lagi.
Permintaan tersebut mengikuti pola berikut:
https://places.googleapis.com/v1/places/PLACE_ID
Misalnya:
curl -X GET -H "Content-Type: application/json" -H "X-Goog-Api-Key: YOUR_API_KEY" -H "X-Goog-FieldMask: id,displayName,formattedAddress" "https://places.googleapis.com/v1/places/PLACE_ID"
Ganti PLACE_ID dengan ID yang dihasilkan oleh Pencarian Teks, Pencarian di Sekitar, atau metode Places lain yang didukung.
Perhatikan bahwa masker kolom Detail Lokasi menggunakan id, displayNamedan formattedAddress daripada places.id, places.displayNamedan places.formattedAddress. Fungsi `Place Details` mengembalikan satu objek `Place`, sedangkan fungsi `Text Search` mengembalikan objek-objek `Place` yang terdapat di dalam sebuah places array.
Pilih Kolom yang Anda Butuhkan
Detail Lokasi, Pencarian Teks, dan Pencarian di Sekitarnya memerlukan masker bidang di Places API (Baru). Jika tidak ada bidang yang ditentukan, permintaan tersebut akan menghasilkan kesalahan.
Untuk Pencarian Teks, contoh masker bidang mungkin terlihat seperti berikut:
places.displayName,places.formattedAddress
Jika aplikasi tersebut juga memerlukan situs web dan penilaian, tampilan bidang dapat diperluas:
places.displayName,places.formattedAddress,places.websiteUri,places.rating
Google juga mendukung * sebagai karakter pengganti untuk semua kolom yang tersedia, namun penggunaan karakter pengganti tersebut tidak disarankan dalam lingkungan produksi. Meminta kolom yang tidak diperlukan dapat meningkatkan jumlah data yang dikembalikan dan menyebabkan permintaan tersebut masuk ke dalam SKU penagihan yang lebih tinggi.
Pastikan masker bidang hanya mencakup data yang benar-benar digunakan oleh aplikasi. Pemilihan bidang memengaruhi baik respons maupun biaya permintaan.
Bagian penetapan harga di bawah ini menjelaskan bagaimana pilihan kolom tersebut dipetakan ke SKU Google Places API.
Gunakan Outscraper Pengikis Google Maps untuk mengumpulkan data bisnis melalui alur kerja tanpa kode tanpa perlu mengatur permintaan Places API satu per satu.
Harga dan Batas Penggunaan Gratis Google Places API
Google Places API menggunakan sistem penagihan bayar sesuai penggunaan. Setiap permintaan ditagihkan berdasarkan SKU tertentu, dan biayanya bergantung pada metode yang digunakan, bidang data yang diminta, serta jumlah peristiwa yang dapat ditagihkan setiap bulan.
Google tidak lagi menggunakan sistem kredit Maps Platform $200 yang lama. Model saat ini memberikan batas penggunaan gratis bulanan tersendiri untuk setiap SKU. Batas-batas tersebut diatur ulang pada awal setiap bulan.
Cara Kerja SKU Google Places API
SKU adalah kategori penagihan yang dilampirkan pada permintaan Places API.
Places API (Baru) membagi banyak permintaan ke dalam tingkatan harga seperti Essentials, Pro, dan Enterprise. Bidang-bidang yang diminta dapat menyebabkan suatu permintaan masuk ke dalam SKU dengan harga lebih tinggi.
Sebagai contoh, Detail Lokasi dapat ditagih dengan SKU yang berbeda-beda, tergantung pada bidang-bidang yang diminta:
- Detail Lokasi: Hal-hal Penting termasuk batas penggunaan gratis bulanan sebesar 10.000 peristiwa.
- Batas penggunaan gratis bulanan untuk Detail Lokasi Pro adalah 5.000 acara.
- Untuk Detail Lokasi Perusahaan, batas penggunaan gratis bulanan adalah 1.000 peristiwa.
Setelah batas penggunaan gratis tercapai, tarif akan dikenakan per 1.000 peristiwa dan semakin murah seiring meningkatnya volume bulanan.
Pencarian Teks dan Pencarian di Sekitar memiliki struktur yang serupa.
Untuk tingkatan penggunaan berbayar pertama, Google saat ini mencantumkan tarif berikut di situs resmi Halaman harga Google Maps Platform:
*Angka-angka ini berlaku untuk tingkatan harga pertama yang ditampilkan di halaman harga global Google. Semakin tinggi volume bulanan, semakin rendah tarif per 1.000.
Google juga menawarkan beberapa SKU yang hanya berbasis ID dengan penggunaan gratis tanpa batas, termasuk Place Details Essentials (Hanya ID) dan Text Search Essentials (Hanya ID).
Batas Penggunaan Gratis Saat Ini
Penggunaan gratis terkait dengan masing-masing SKU, bukan dengan satu kredit dolar bersama.
Misalnya:
- Permintaan Autocomplete: 10.000 acara gratis per bulan
- Rincian Tempat: Hal-hal Penting: 10.000
- Rincian Lokasi Pro: 5.000
- Text Search Pro: 5.000
- Nearby Search Pro: 5.000
- Rincian Lokasi Perusahaan: 1.000
- Text Search Enterprise: 1,000
- Nearby Search Enterprise: 1,000
Some IDs-only services have unlimited free usage.
This makes cost estimates more dependent on the exact request than under the older credit system. Two applications making the same number of Places API calls can have different bills if they request different fields or use different methods.
How Requested Fields Affect Billing
Field masks control more than the size of the response.
For Place Details, Text Search, and Nearby Search, Google bills the request according to the highest SKU represented by the requested fields. If the field mask includes fields from both Essentials and Pro, the request is billed at the Pro level.
For example, an application that only needs a Place ID and address may not need the same fields as one requesting ratings, opening hours, reviews, and additional place attributes.
This makes field selection part of the cost calculation.
Avoid requesting every available field by default. Start with the fields required by the feature and add others only when they serve a clear purpose.
How Autocomplete Sessions Affect Billing
Autocomplete can be billed per request or as part of a session.
Without a session token, each Autocomplete request is billed separately under the Autocomplete Requests SKU.
A session groups a user’s Autocomplete requests with the request that completes the selection. A typical session begins with one or more Autocomplete calls and ends with Place Details (New) or Address Validation. Each new user search should use a new session token.
For sessions that end with Place Details Essentials, Google currently bills the first 12 Autocomplete requests individually. Requests after the 12th are billed under Autocomplete Session Usage, which has no charge. The terminating Place Details request is still billed under its own SKU.
Abandoned sessions do not receive that session treatment. If the user never completes the session with Place Details or Address Validation, the Autocomplete calls revert to per-request pricing.
How to Estimate Google Places API Costs
A useful cost estimate starts with the actual request flow rather than the total number of users.
Periksa:
- Which Places API method will be called.
- How many times the method is called during one user action.
- Which fields are included in the field mask.
- Which SKU those fields trigger.
- How many billable events are expected each month.
- How much of that usage falls inside the SKU’s free monthly cap.
- Whether Autocomplete requests are grouped into properly completed sessions.
For example, an application making 20,000 monthly Place Details Essentials requests would first use the 10,000-event monthly free cap. The remaining 10,000 events would fall into the paid pricing tier.
At the current first-tier rate of $5 per 1,000 events, those 10,000 paid requests would cost about $50 before taxes or any other Maps Platform usage is included.
The calculation changes if the field mask triggers a Pro or Enterprise SKU, so the expected fields should be part of the cost estimate from the beginning.
When Google Places API Is and Isn't the Right Tool
Google Places API works well when place information is part of an application feature. A search box, store locator, travel app, delivery interface, or nearby-business feature can request place information when the user needs it.
The requirements change when the main goal is building a business dataset. Collecting records across many categories, cities, or regions is a different workflow from looking up places inside an application.
For a deeper comparison of official API access and large-scale data extraction, see Google Maps API vs. web scraping.
When Google Places API Works Well
Google designed Places API (New) around location-aware application features.
It is a strong fit when an application needs to:
- search for places from user input
- find nearby businesses or points of interest
- suggest places while someone types
- retrieve details about a known place
- display place photos
- use Place IDs across supported Google Maps Platform services
For example, a hotel-booking app could show restaurants near a selected property. A delivery app could use Autocomplete to help a customer enter a destination. A store locator could retrieve details about a specific branch after the user selects it.
These requests usually happen as part of an interaction inside the application. The developer controls which method is called, which fields are returned, and how the results appear to the user.
Google’s documentation describes Places API (New) around these types of place search, lookup, autocomplete, and location-aware application features.
When You Need Business Data in Bulk
Some projects need a dataset rather than a place-search feature.
Daripada bertanya:
Restoran apa saja yang berada di dekat pengguna ini?
a research team may need:
Restoran mana saja yang beroperasi di 50 kota ini?
The same pattern appears across different teams:
- Developers may need place search or details inside an application.
- Marketers may need businesses by category and location for market research.
- Sales teams may need business records that match geographic or company criteria.
- Data professionals may need structured records for analysis, dashboards, or internal systems.
When the work involves collecting hundreds or thousands of business records, the process shifts from individual place lookup to data collection.
For market research, see what Google Maps business data to collect for market analysis before deciding which fields belong in your dataset.
A No-Code Option for Business Data Collection
Teams that do not need to build a place-search feature can use Outscraper Pengikis Google Maps to collect business records without setting up Google Cloud requests or writing API code.
Users can search by category and location, run the collection through the web interface, and export the results for research, prospecting, or analysis.
For developers and data teams that need programmatic access, Outscraper Google Maps Places API is a separate service from Google’s API Tempat (Baru). It supports bulk business-data collection. See the Dokumentasi API Outscraper for request details.
An application that needs nearby place search has a different data requirement from a team building a reusable business dataset.
Gunakan Outscraper Google Maps Places API when you need business records across multiple categories or locations for research, sales, analysis, or another data workflow.
When You Need Additional Business or Contact Data
Google Places API can return addresses, phone numbers, websites, ratings, reviews, opening hours, business status, and other place fields.
For prospecting or market research, that may still leave gaps. Teams may also need email addresses, contact details, social profiles, or other company information before a record is ready to use.
If you need to add contact and company information after collecting place data, see the guide to Google Maps Places data enrichment.
A typical workflow is:
- Find businesses by category and location.
- Keep the fields needed for targeting.
- Add contact or company data.
- Export the records for sales, research, or another system.
Outscraper supports business-data collection through both no-code and API workflows, with additional enrichment options for emails, contacts, and social profiles.
Google Places API fits place search and place details inside applications. Business-data workflows that need contact data, enrichment, or export usually require additional tools.
Google Places API Limits, Quotas, and Billing Risks
A Places API setup can work in testing and still run into cost, quota, or access problems once usage increases.
Google applies quotas by API method and project rather than through one shared daily limit. Usage, quotas, errors, and billing can be checked in Google Cloud Console.
Request Only the Fields You Need
Field masks affect both the response and the billing SKU.
If a request includes Pro-level fields, Google can bill the request at the Pro rate even when lower-cost fields are also included. Keep the field mask limited to data the application actually uses.
Use the Right Search Method
Text Search works from a written query. Nearby Search works from a defined geographic area and place-type criteria.
Misalnya:
kedai kopi di Bostonfits Text Search.- restaurants within a set radius fit Nearby Search.
Choosing the right method reduces unnecessary requests and extra filtering.
Manage Autocomplete Sessions Correctly
Autocomplete can generate several requests while a user types.
Use a new session token for each search session and complete the session with a compatible Place Details or Address Validation request. Abandoned or incorrectly configured sessions can be billed as separate requests.
Keep Legacy and New Requests Separate
Places API (Legacy) and Places API (New) use different request formats, field names, and response structures.
Do not mix Autocomplete session tokens between Legacy and New requests. Check older integrations before moving production traffic to Places API (New).
Restrict Your API Keys
Google recommends restricting API keys by application and API.
For server-side requests, IP restrictions can limit where the key is used. API restrictions can limit the same key to Places API (New) and other required services.
An incorrectly configured key can also cause PERMINTAAN_DITOLAK errors, so restrictions should be tested before production use.
Set Quotas and Billing Alerts
Google Cloud Console can track traffic, errors, quotas, and spending.
Set quota limits and billing alerts before request volume grows. Billing alerts warn you when spending reaches selected thresholds, but they do not automatically stop API usage.
Final Checklist: Before You Use the Google Places API
- Choose the Places API method that matches the task.
- Use Places API (New) and request only the fields you need.
- Check the SKU, free usage cap, and expected monthly cost.
- Restrict the API key and set quotas or billing alerts.
- Decide whether you need app-based place lookup or bulk business-data collection.
Menggunakan Outscraper Google Maps Places API to collect business records across multiple locations or categories.
FAQ
Pertanyaan dan jawaban paling sering
API Google Places tidak sepenuhnya gratis. Google menerapkan sistem pembayaran sesuai penggunaan (pay-as-you-go) dengan batas penggunaan gratis bulanan untuk setiap SKU. Sebagai contoh, Permintaan Autocomplete dan Place Details Essentials saat ini mencakup 10.000 peristiwa gratis per bulan, sedangkan SKU lainnya memiliki batas yang lebih rendah.
API Places digunakan untuk mencari tempat dan memperoleh informasi mengenai bisnis, landmark, serta lokasi lainnya. API Geocoding terutama digunakan untuk mengubah alamat menjadi koordinat atau sebaliknya, dari koordinat menjadi alamat. Keduanya dapat menggunakan Place ID, namun masing-masing menangani tugas-tugas data lokasi yang berbeda.
Places API menyediakan data lokasi melalui permintaan HTTP. Maps JavaScript API digunakan untuk menambahkan peta interaktif dan fitur peta berbasis browser ke situs web. Perpustakaan Places-nya juga dapat menyediakan fitur pencarian lokasi dan pelengkapan otomatis di dalam aplikasi web.
Ya. Sebuah proyek Places API untuk produksi memerlukan proyek Google Cloud yang terhubung ke akun penagihan. Proyek tersebut juga harus mengaktifkan layanan Places API yang diperlukan serta memiliki kredensial otentikasi yang valid.
Place ID adalah pengenal berupa teks untuk suatu tempat dalam basis data Google Places dan Google Maps. Place ID dapat digunakan di berbagai layanan Google Maps Platform, termasuk Places API, Geocoding API, Maps JavaScript API, dan Routes API. Google menyatakan bahwa Place ID dapat berubah seiring waktu dan menyarankan untuk memperbarui ID yang telah disimpan dan berusia lebih dari 12 bulan.
Places API (Baru) adalah versi terkini untuk pengembangan baru. Beberapa metode Legacy secara langsung sesuai dengan metode yang lebih baru, sementara yang lain telah berubah. Misalnya, Text Search (Baru) menggantikan Find Place (Legacy). Proyek-proyek Legacy yang sudah ada masih didukung, tetapi proyek Cloud baru tidak dapat mengaktifkan layanan Legacy.
Tidak ada kolom alamat email bisnis yang muncul dalam daftar kolom data lokasi (place-data) API Places Google saat ini (Baru). API tersebut dapat menampilkan kolom seperti nomor telepon dan URL situs web, namun alamat email bisnis tidak tercantum sebagai kolom lokasi yang didukung.
