Cara Menggunakan Google Places API dan Mendapatkan Kunci API

Apa itu Google Places API

Ada lima jenis permintaan yang tersedia dalam API. Mereka adalah:

• Pencarian Tempat yang mengembalikan daftar tempat berdasarkan lokasi pengguna atau kata kunci pencarian.
• Detail Tempat yang memberikan informasi rinci tentang suatu tempat tertentu, dengan ulasan pengguna disertakan.
• Foto Tempat memberikan akses ke jutaan foto terkait tempat yang tersimpan dalam basis data Place milik Google.
• <strong>Ulasan Tempat</strong> memungkinkan Anda menjangkau dan <a href=”http://elfsight.id/blog/how-to-embed-google-reviews-on-website/”>menyematkan ulasan Google</a> dari platform.
• Pelengkapan Otomatis Tempat ada untuk secara otomatis mengisi nama atau alamat suatu tempat saat pengguna mengetik.
• Saran Kueri menyediakan layanan prediksi kueri untuk pencarian geografis berbasis teks, menampilkan saran kueri saat pengguna mengetik.

Cara membuat kunci API Google Places

Kunci API adalah pengenal unik yang ada untuk mengautentikasi permintaan yang terkait dengan proyek Anda untuk keperluan penggunaan dan penagihan. Dengan menggunakan kunci API untuk mengautentikasi permintaan, Anda dapat:

• Kelola API Anda di Google Cloud Console.
• Akses data penggunaan waktu nyata dan 30 hari data penggunaan historis di Konsol Google Cloud Platform.
• Lihat laporan penggunaan yang berisi info lebih dari 30 hari di Portal Dukungan Google Cloud.

Anda selalu bebas mencoba cara alternatif untuk menambahkan ulasan pelanggan ke situs Anda. Misalnya, ada widget Ulasan Google dari Elfsight – Anda tidak perlu repot mendapatkan kunci API atau belajar coding.

Dapatkan Kunci API Places Anda dan tambahkan ke permintaan Anda

Untuk mendapatkan kunci API Anda, lakukan langkah-langkah berikut:

• Buka Konsol Google Cloud Platform.
• Klik pada daftar drop-down proyek dan pilih proyek yang dibuat untuk Anda. Namanya seharusnya diawali dengan Google Maps APIs for Business atau Google Maps for Work atau Google Maps.
• Kemudian klik tombol menu dan pilih API & Layanan > Kredensial.
• Di halaman Kredensial, pilih Buat kredensial > Kunci API. Di sana Anda akan melihat dialog pembuatan kunci API yang menampilkan kunci yang baru Anda buat.
• Tutup tab ini. Kunci API baru Anda terdaftar di halaman kredensial pada bagian Kunci API.

Selanjutnya Anda harus menambahkan kunci API ke setiap permintaan Places API. Gunakan contoh berikut, cukup ganti YOUR_API_KEY dengan kunci API Anda:

https://maps.googleapis.com/maps/api/place/nearbysearch/json
  ?location=-33.8670522,151.1957362
  &radius=500
  &types=food
  &name=harbour
  &key=YOUR_API_KEY

Perlu diingat bahwa Google sangat menyarankan Anda untuk membatasi kunci API Anda. Pembatasan tersebut meningkatkan keamanan dan membantu memastikan hanya permintaan yang berwenang yang dilakukan dengan kunci API Anda.

Cara membatasi kunci Google Places API

• Pembatasan Aplikasi. Fitur ini memungkinkan Anda membatasi penggunaan kunci API ke situs web, server web, atau aplikasi seluler. Hanya ada satu pembatasan dari kategori ini yang bisa dipilih.
• Pembatasan API. Jenis pembatasan ini membatasi penggunaan kunci API ke satu atau lebih API atau SDK.

Untuk membatasi kunci API Anda, Anda perlu:

• Buka Google Cloud Console.
• Klik dropdown proyek, lalu pilih proyek yang berisi kunci API yang ingin Anda amankan.
• Klik tombol menu dan pilih APIs & Layanan > Kredensial.
• Klik nama kunci API yang perlu diamankan pada halaman Kredensial.
• Tentukan pembatasan pada halaman Batasi dan Ubah Nama Kunci API.

Setelah pembatasan diterapkan, yang perlu dilakukan hanyalah mengklik tombol Simpan.

Menggunakan Google Places API: contoh-contoh

Ada beberapa cara menggunakan Google Places API. Mari kita lihat beberapa di antaranya.

Pencarian Tempat

Seperti yang telah disebutkan di atas, Places API memungkinkan Anda mencari informasi tempat menggunakan banyak kategori. Contoh Google Places API berikut menunjukkan permintaan Find Place untuk “Museum of Contemporary Art Australia”:

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=photos,formatted_address,name,rating,opening_hours,geometry&key=YOUR_API_KEY

Rincian Lokasi

Setelah Anda mendapatkan place_id dari Pencarian Google Places, Anda dapat memperoleh informasi lebih lanjut tentang suatu tempat atau objek minat tertentu dengan mengajukan permintaan Rincian Tempat. Di sini kita bisa melihat permintaan rincian tempat berdasarkan place_id:

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name,rating,formatted_phone_number&key=YOUR_API_KEY

Foto Tempat

Layanan ini memungkinkan Anda menambahkan konten foto ke aplikasi Anda. Ini memberi akses ke jutaan foto yang disimpan dalam database Places. Berikut contoh permintaan:

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photoreference=CnRtAAAATLZNl354RwP_9UKbQ_5Psy40texXePv4oAlgP4qNEkdIrkyse7rPXYGd9D_Uj1rVsQdWT4oRz4QrYAJNpFX7rzqqMlZw2h2E2y5IKMUZ7ouD_SlcHxYq1yL4KbKUv3qtWgTK0A6QbGh87GB3sscrHRIQiG2RrmU_jF4tENr9wGS_YxoUSSDrYjWmrNfeEHSGSc3FyhNLlBU&key=YOUR_API_KEY

Autocomplete Lokasi

Layanan web ini mengembalikan prediksi tempat sebagai respons terhadap permintaan HTTP. Layanan ini bisa digunakan untuk menyediakan fungsi pelengkapan otomatis untuk pencarian geografi berbasis teks. Berikut contoh permintaan untuk tempat usaha:

https://maps.googleapis.com/maps/api/place/autocomplete/xml?input=Amoeba&types=establishment&location=37.76999,-122.44696&radius=500&key=YOUR_API_KEY

Pencarian Otomatis

Jenis layanan ini digunakan untuk menyediakan prediksi kueri bagi pencarian geografis berbasis teks, dengan menampilkan kueri yang disarankan saat pengguna mengetik. Contoh permintaan terlihat seperti ini:

https://maps.googleapis.com/maps/api/place/queryautocomplete/json?key=YOUR_API_KEY&input=pizza+near%20par

Harga dan Batas Google Places API

Di sini Google menggunakan model harga bayar sesuai pemakaian. Ini berarti API Google Maps Platform ditagih per SKU. Penggunaan dicatat untuk setiap SKU Produk, dan sebuah API bisa memiliki lebih dari satu SKU Produk.

Ada 1.000 pencarian Places API gratis setiap 24 jam, tetapi Anda bisa meningkatkan menjadi 150.000 pencarian gratis per 24 jam dengan Mengaktifkan Penagihan di Google Cloud Console.

Anda bisa melihat dokumentasi Google Place API documentation untuk menemukan rincian lebih lanjut tentang semua harga dan batasan.

Pertanyaan Umum

Kesimpulan

Artikel oleh

Valeriya Polyakova

Manajer Konten

Sebagai Manajer Konten di Elfsight, saya fokus pada pembuatan konten yang praktis dan menginspirasi. Saya suka membuat hal-hal yang kompleks menjadi sederhana dan menyenangkan untuk dibaca.

Ikuti kami di Facebook

Ikuti di X

Ikuti di LinkedIn

Ikuti di Reddit