Dalam tutorial ini, kami akan menjelaskan bagaimana menggunakan GCP Google Maps dengan Node.js untuk melakukan pencarian tempat berdasarkan teks input. Kami akan menggunakan paket @googlemaps/google-maps-services-js untuk menghubungi API Google Maps dan mendapatkan informasi tempat yang relevan.
Langkah-langkah:
Persiapan Awal
Pastikan Anda memiliki kunci API Google Maps yang valid. Jika belum memilikinya, kunjungi halaman Google Cloud Console untuk membuat kunci API baru.
Pastikan Node.js terinstal di mesin Anda. Jika belum, kunjungi https://nodejs.org dan ikuti petunjuk instalasi berikut ini.
Membuat Proyek dan Menginstal Paket
Buat direktori proyek baru dan buka terminal atau command prompt, lalu masuk ke direktori tersebut.
Jalankan perintah berikut untuk menginisialisasi proyek Node.js dan membuat file package.json:
npm init -y
Selanjutnya, jalankan perintah berikut untuk menginstal paket @googlemaps/google-maps-services-js:
npm install @googlemaps/google-maps-services-js
Cara Menggunakan GCP Google Maps
Buat file JavaScript baru (misalnya, places.js) dan salin kode di bawah ini ke dalam file tersebut. Gantilah "your-api-key" dengan kunci API Google Maps yang Anda miliki
import { Client } from "@googlemaps/google-maps-services-js";
const client = new Client({});
client
.findPlaceFromText({
params: {
input: "Warung Pecel dan Rawon Setan H Lutfi, Jalan Ahmad Yani, Gumuk Kerang, Kebonsari, Kabupaten Jember, Jawa Timur",
inputtype: "textquery",
fields: ["formatted_address", "name", "geometry", "rating"],
key: "your-api-key",
},
timeout: 1000, // milliseconds
})
.then((response) => {
const results = response.data.candidates;
results.forEach((place) => {
console.log("Place Name:", place.name);
console.log("Rating:", place.rating);
console.log("Formatted Address:", place.formatted_address);
console.log("Latitude:", place.geometry.location.lat);
console.log("Longitude:", place.geometry.location.lng);
console.log("------------------------");
});
})
.catch((error) => {
console.log(error.response.data.error_message);
});Pada baris pertama, kita mengimpor kelas Client dari paket @googlemaps/google-maps-services-js.
Baris ketiga, kita membuat instance objek client menggunakan kelas Client yang telah diimpor.
Pada baris kelima, kita melakukan pemanggilan metode findPlaceFromText pada objek client. Metode findPlaceFromText menerima objek konfigurasi dengan parameter seperti input, inputtype, fields, dan key. input berisi teks yang ingin kita cari, dan inputtype diberi nilai "textquery" untuk menentukan jenis input. fields adalah array yang berisi informasi yang ingin kita dapatkan tentang tempat, seperti alamat terformat, nama, geometri, dan peringkat. key adalah kunci API Google Maps yang digunakan untuk mengotentikasi permintaan.
Pada baris ke-14 hingga ke-21, kita menangani respons yang diterima dari API Google Maps. Hasil respons berada dalam properti data.candidates, yang berisi daftar tempat yang sesuai dengan permintaan. Kita menggunakan perulangan forEach untuk mengiterasi setiap tempat dalam daftar dan mencetak informasinya, seperti nama tempat, peringkat, alamat terformat, dan koordinat geografis.
Simpan perubahan dan jalankan kode dengan menjalankan perintah berikut di terminal:
node places.js
Kesimpulan
Dalam tutorial ini, kita telah belajar cara menggunakan paket @googlemaps/google-maps-services-js untuk melakukan pencarian tempat menggunakan layanan Google Maps dengan Node.js.
Kode yang telah kita buat memungkinkan kita untuk mencari tempat berdasarkan teks input dan mendapatkan informasi terkait seperti nama, peringkat, alamat terformat, dan koordinat geografis. Anda dapat mengembangkan kode ini lebih lanjut untuk mengintegrasikannya ke dalam proyek Node.js Anda sendiri.
Harap dicatat bahwa kode di atas merupakan contoh, dan pastikan Anda menggunakan kunci API Google Maps yang valid serta memperbarui parameter permintaan sesuai dengan informasi tempat yang ingin Anda cari.
Jika Anda memiliki pertanyaan lebih lanjut, jangan ragu untuk bertanya. Semoga tutorial ini bermanfaat bagi Anda!