search_places |
Panggil alat ini saat permintaan pengguna adalah untuk menemukan tempat, bisnis, alamat, lokasi, lokasi menarik, atau penelusuran terkait Google Maps lainnya. Persyaratan Input (PENTING):
text_query (string - WAJIB): Kueri penelusuran utama. Hal ini harus mendefinisikan dengan jelas apa yang dicari pengguna.
- Contoh:
'restaurants in New York', 'coffee shops near Golden Gate Park', 'SF MoMA', '1600 Amphitheatre Pkwy, Mountain View, CA, USA', 'pets friendly parks in Manhattan, New York', 'date night restaurants in Chicago', 'accessible public libraries in Los Angeles'.
- Untuk detail tempat tertentu: Sertakan atribut yang diminta (misalnya,
'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address').
location_bias (objek - OPSIONAL): Gunakan ini untuk memprioritaskan hasil di dekat area geografis tertentu.
- Format:
{"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
- Penggunaan:
- Untuk membiaskan ke radius 5 km:
{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
- Untuk memberikan bias yang kuat ke titik pusat:
{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (menghilangkan radius_meters).
language_code (string - OPSIONAL): Bahasa yang digunakan untuk menampilkan ringkasan hasil penelusuran.
- Format: Kode bahasa dua huruf (ISO 639-1), yang dapat diikuti dengan garis bawah dan kode negara dua huruf (ISO 3166-1 alpha-2), misalnya,
en, ja, en_US, zh_CN, es_MX. Jika kode bahasa tidak diberikan, hasilnya akan dalam bahasa Inggris.
region_code (string - OPSIONAL): Kode wilayah CLDR Unicode pengguna. Parameter ini digunakan untuk menampilkan detail tempat, seperti nama tempat spesifik per wilayah, jika tersedia. Parameter ini dapat memengaruhi hasil berdasarkan hukum yang berlaku.
- Format: Kode negara dua huruf (ISO 3166-1 alpha-2), misalnya,
US, CA.
Petunjuk untuk Panggilan Alat:
Informasi Lokasi (PENTING): Penelusuran harus berisi informasi lokasi yang memadai. Jika lokasinya ambigu (misalnya, hanya "tempat pizza"), Anda harus menentukannya di text_query (misalnya, "tempat pizza di New York") atau menggunakan parameter location_bias. Sertakan nama kota, negara bagian/provinsi, dan wilayah/negara jika diperlukan untuk disambiguasi. Selalu berikan text_query yang paling spesifik dan kaya konteks. Hanya gunakan location_bias jika koordinat diberikan secara eksplisit atau jika menyimpulkan lokasi dari konteks pengguna yang diketahui sesuai dan diperlukan untuk mendapatkan hasil yang lebih baik. Output yang di-grounding harus diatribusikan ke sumber menggunakan informasi dari kolom attribution jika tersedia.
|
lookup_weather |
Mengambil data cuaca yang komprehensif, termasuk kondisi saat ini, prakiraan per jam, dan harian. Data Spesifik yang Tersedia: Suhu (Saat Ini, Terasa Seperti, Maks/Min, Indeks Panas), Angin (Kecepatan, Embusan, Arah), Peristiwa Langit (Matahari Terbit/Terbenam, Fase Bulan), Presipitasi (Jenis, Probabilitas, Kuantitas/QPF), Kondisi Atmosfer (Indeks UV, Kelembapan, Tutupan Awan, Probabilitas Badai Petir), dan Alamat Lokasi yang Di-geocoding. Lokasi & Aturan Lokasi (PENTING): Lokasi yang data cuacanya diminta ditentukan menggunakan kolom location. Kolom ini adalah struktur 'oneof', yang berarti Anda HARUS memberikan nilai untuk HANYA SATU dari tiga subkolom lokasi di bawah untuk memastikan pencarian data cuaca yang akurat.
Koordinat Geografis (lat_lng)
- Gunakan jika Anda diberi koordinat lintang/bujur yang tepat.
- Contoh: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Los Angeles
ID Tempat (place_id)
- ID string yang jelas (ID Tempat Google Maps).
- place_id dapat diambil dari alat search_places.
- Contoh: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Menara Eiffel
String Alamat (address)
- String bentuk bebas yang memerlukan spesifikasi untuk geocoding.
- Kota & Wilayah: Selalu sertakan wilayah/negara (misalnya, "London, UK", bukan "London").
- Alamat: Berikan alamat lengkap (misalnya, "1600 Pennsylvania Ave NW, Washington, DC").
- Kode Pos: HARUS disertai dengan nama negara (misalnya, "90210, USA", BUKAN "90210").
- Contoh: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}
Mode Penggunaan:
Cuaca Saat Ini: Hanya berikan location. Jangan tentukan date dan hour. Prakiraan Per Jam: Berikan location, date, dan hour (0-23). Gunakan untuk waktu tertentu (misalnya, "pukul 17.00") atau istilah seperti "beberapa jam ke depan" atau "nanti hari ini". Jika pengguna menentukan menit, bulatkan ke bawah ke jam terdekat. Prakiraan per jam setelah 120 jam dari sekarang tidak didukung. Cuaca per jam historis didukung hingga 24 jam yang lalu. Prakiraan Harian: Memberikan location dan date. Jangan tentukan hour. Gunakan untuk permintaan hari umum (misalnya, "cuaca besok", "cuaca pada hari Jumat", "cuaca pada 25/12"). Jika tanggal hari ini tidak ada dalam konteks, Anda harus mengklarifikasinya kepada pengguna. Perkiraan harian setelah 10 hari termasuk hari ini tidak didukung. Cuaca historis tidak didukung. Batasan Parameter:
|
compute_routes |
Menghitung rute perjalanan antara tempat asal dan tujuan, secara opsional melalui perhentian di antaranya. Menampilkan jarak dan durasi untuk setiap rute. Persyaratan Input (PENTING):
origin dan destination (objek - WAJIB): Masing-masing harus disediakan menggunakan salah satu dari:
address (string, misalnya, 'Eiffel Tower, Paris'). Tempat, tempat terkenal, dan bisnis yang diberi nama akan di-resolve secara langsung, jadi JANGAN panggil search_places terlebih dahulu hanya untuk melakukan geocoding pada titik jalan. Sertakan kota, wilayah, atau negara yang disebutkan pengguna.lat_lng (objek, {"latitude": number, "longitude": number}).place_id (string, misalnya, 'ChIJOwE_Id1w5EAR4Q27FkL6T_0'), misalnya dari search_places. intermediate_waypoints (array objek - OPSIONAL): Maksimal 10 perhentian yang harus dilewati, secara berurutan, antara tempat asal dan tujuan. Format sama seperti origin. Tidak didukung dengan TRANSIT. Hanya sertakan perhentian yang diminta pengguna.
travel_mode (enum - OPSIONAL): DRIVE (default), WALK, BICYCLE, atau TRANSIT.
Timing (OPSIONAL - tetapkan maksimal SATU): Stempel waktu RFC 3339 dengan offset UTC, misalnya, '2026-09-19T08:00:00-07:00'. Defaultnya adalah berangkat sekarang. Untuk TRANSIT, waktunya dapat ditetapkan hingga 7 hari yang lalu atau hingga 100 hari ke depan. Untuk mode lainnya, waktu dapat ditetapkan hingga 365 hari ke depan dan tidak boleh di masa lalu.
departure_time: Gunakan saat pengguna menyebutkan waktu keberangkatan (misalnya, "besok pukul 08.00").arrival_time: Gunakan saat pengguna menyebutkan waktu kedatangan yang diinginkan (misalnya, "tiba di sana pukul 09.00"). routing_preference (enum - OPSIONAL):
ROUTING_PREFERENCE_TRAFFIC_UNAWARE (default): mengabaikan lalu lintas langsung, insiden, dan penutupan. Latensi terendah.ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL: menggunakan kondisi lalu lintas real-time jika tersedia. Tidak didukung untuk WALK atau BICYCLE. Tetapkan ini HANYA jika pengguna bertanya tentang lalu lintas, kemacetan, atau perkiraan waktu tiba (ETA) yang disesuaikan dengan lalu lintas. Hal ini menimbulkan biaya dan latensi yang lebih tinggi. location_bias (objek - OPSIONAL): {"latitude": number, "longitude": number} digunakan untuk memperjelas nama tempat di alamat titik jalan. Jika nama bersifat ambigu (misalnya, "Springfield") dan pengguna tidak memberikan wilayah, pertahankan nama seperti yang diberikan di address dan tetapkan location_bias ke area yang dimaksud, bukan menebak wilayah.
compute_alternative_routes (boolean - OPSIONAL): Tetapkan ke true hanya jika pengguna meminta opsi atau alternatif rute. Defaultnya adalah false, yang hanya menampilkan rute yang direkomendasikan.
include_polyline (boolean - OPSIONAL): Setel ke true hanya jika geometri rute (encoded_polyline) diperlukan. Nilai defaultnya adalah false.
Petunjuk untuk Panggilan Alat:
- Jika asal atau tujuan tidak ada, Anda HARUS meminta klarifikasi kepada pengguna sebelum memanggil alat.
- Untuk pertanyaan "Seberapa jauh A dari B?", gunakan B sebagai
origin dan A sebagai destination.
Contoh Panggilan Alat: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"intermediate_waypoints":[{"address":"Louvre Museum"}],"travel_mode":"DRIVE","departure_time":"2026-09-19T08:00:00+02:00"} Instructions for Response:
- Saat rute alternatif diminta, rute akan diurutkan dari yang paling direkomendasikan hingga yang paling tidak direkomendasikan.
- Jika
routes kosong, beri tahu pengguna bahwa tidak ada rute yang ditemukan. Jangan menebak rute.
- Hanya nyatakan fakta yang ditampilkan oleh alat. JANGAN membuat rute belokan demi belokan, jalur transportasi umum, stasiun, peron, atau transfer.
- Output yang di-grounding harus diatribusikan ke sumber menggunakan kolom
attribution setiap rute jika tersedia.
|
resolve_names |
Menyelesaikan daftar batch kueri lokasi tertentu (nama tempat terkenal atau alamat persis) menjadi ID Tempat Google Maps kanonis. Persyaratan Input (PENTING):
queries (array objek - WAJIB): Daftar kueri lokasi yang akan di-resolve. Anda dapat menentukan hingga 20 kueri.
- Setiap objek kueri harus memiliki:
text (string - WAJIB): Kueri teks yang mewakili nama atau alamat tempat tertentu yang akan di-resolve.
- Contoh:
'Googleplex, Mountain View, CA', '1600 Amphitheatre Pkwy, Mountain View, CA', 'Eiffel Tower, Paris'.
location_bias (objek - OPSIONAL): Gunakan ini untuk memprioritaskan hasil di dekat area geografis tertentu.
- Format:
{"viewport": {"low": {"latitude": [value], "longitude": [value]}, "high": {"latitude": [value], "longitude": [value]}}}
region_code (string - OPSIONAL): Kode wilayah CLDR Unicode (kode negara dua huruf, misalnya, US, CA) pengguna untuk membiaskan hasil.
Petunjuk untuk Panggilan Alat:
- Kekhususan (PENTING): Kueri harus mewakili nama atau alamat tempat tertentu. Penelusuran umum seperti
'restaurants' atau nama jaringan seperti 'Starbucks' tidak didukung.
- JANGAN panggil alat ini jika alat downstream yang ingin Anda panggil sudah menerima string alamat mentah atau nama tempat secara langsung.
Simpan ke Google Maps:
- Responsnya mencakup kolom
save_to_maps_url: satu link Maps Google yang berisi semua Tempat yang berhasil di-resolve.
- Jika pengguna ingin menyimpan, membagikan, atau membuka tempat yang di-resolve sebagai daftar di Google Maps, tampilkan link ini kepada pengguna. JANGAN membuat link ini sendiri.
Penanganan Error (PENTING):
- Alat ini adalah alat batch processing. Permintaan mungkin menampilkan "hasil yang beragam" (misalnya, beberapa kueri berhasil diselesaikan, sementara yang lain gagal).
- Daftar output
results dijamin akan dipetakan 1:1 dengan indeks queries input. Kueri yang gagal akan menghasilkan pesan Result kosong (tidak ada entity yang ditetapkan) pada indeks yang sesuai dalam daftar results.
- Anda HARUS memeriksa kolom peta
failed_requests dalam respons untuk mengidentifikasi indeks kueri tertentu yang gagal. Kunci failed_requests mewakili indeks berbasis 0 dari kueri yang gagal dalam permintaan. Jangan berasumsi bahwa seluruh panggilan batch gagal karena kegagalan parsial.
|
resolve_maps_urls |
Menyelesaikan daftar URL Google Maps menjadi ID Tempat Google Maps kanonis. Kapan harus memanggil alat ini (PENTING):
- Gunakan alat ini saat pengguna memberikan satu atau beberapa link atau URL berbagi Google Maps (misalnya, 'https://maps.app.goo.gl/...', 'https://www.google.com/maps/place/...', atau 'https://maps.google.com/...') dan Anda perlu mengekstrak ID Tempat kanonis yang mendasarinya.
- Anda dapat menentukan hingga 20 URL untuk di-resolve dalam satu permintaan batch.
Persyaratan Input (PENTING):
urls (array string - WAJIB): Daftar URL Google Maps yang akan di-resolve. Setiap URL harus berupa URL Google Maps satu tempat yang valid. Simpan ke Google Maps:
- Responsnya mencakup kolom
save_to_maps_url: satu link Maps Google yang berisi semua Tempat yang berhasil di-resolve.
- Saat pengguna ingin menyimpan, membagikan, atau membuka tempat yang telah diidentifikasi sebagai daftar di Google Maps (misalnya, mengumpulkan tempat yang dibagikan dalam percakapan), tampilkan link ini kepada pengguna. JANGAN membuat link ini sendiri.
Penanganan Error (PENTING):
- Alat ini adalah alat batch processing. Permintaan mungkin menampilkan "hasil yang beragam" (misalnya, beberapa URL berhasil diselesaikan, sementara yang lain gagal).
- Daftar output
entities dijamin akan dipetakan 1:1 dengan indeks urls input. Resolusi URL yang gagal akan menghasilkan pesan Entity kosong (tidak ada kolom yang ditetapkan) pada indeks yang sesuai dalam daftar entities.
- Anda HARUS memeriksa kolom peta
failed_requests dalam respons untuk mengidentifikasi indeks URL spesifik yang gagal. Kunci failed_requests mewakili indeks berbasis 0 dari URL yang gagal dalam permintaan. Jangan berasumsi bahwa seluruh panggilan batch gagal karena kegagalan parsial.
|
