search_places |
Panggil alat ini saat permintaan pengguna adalah untuk menemukan tempat, bisnis, alamat, lokasi, tempat menarik, atau penelusuran terkait Google Maps lainnya. Persyaratan Input (KRITIS):
text_query (string - WAJIB): Kueri penelusuran utama. Kueri ini harus menentukan 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 (mis.,
'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address').
location_bias (objek - OPSIONAL): Gunakan parameter ini untuk memprioritaskan hasil di dekat area geografis tertentu.
- Format:
{"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
- Penggunaan:
- Untuk memprioritaskan hasil dalam radius 5 km:
{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
- Untuk memprioritaskan hasil di titik tengah:
{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (menghilangkan radius_meters).
language_code (string - OPSIONAL): Bahasa untuk menampilkan ringkasan hasil penelusuran.
- Format: Kode bahasa dua huruf (ISO 639-1), yang secara opsional 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 ditampilkan dalam bahasa Inggris.
region_code (string - OPSIONAL): Kode wilayah CLDR Unicode pengguna. Parameter ini digunakan untuk menampilkan detail tempat, seperti nama tempat khusus 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 (KRITIS): Penelusuran harus berisi informasi lokasi yang memadai. Jika lokasi tidak jelas (mis., hanya "tempat pizza"), Anda harus menentukannya dalam text_query (mis., "tempat pizza di New York") atau menggunakan parameter location_bias. Sertakan nama kota, negara bagian/provinsi, dan wilayah/negara jika diperlukan untuk menghilangkan ambiguitas. 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 didasarkan harus dikaitkan dengan sumber menggunakan informasi dari kolom attribution jika tersedia.
|
lookup_weather |
Mengambil data cuaca komprehensif termasuk kondisi saat ini, prakiraan cuaca per jam, dan harian. Data Spesifik yang Tersedia: Suhu (Saat Ini, Terasa Seperti, Maks/Min, Indeks Panas), Angin (Kecepatan, Hembusan, Arah), Peristiwa Langit (Matahari Terbit/Terbenam, Fase Bulan), Curah Hujan (Jenis, Probabilitas, Kuantitas/QPF), Kondisi Atmosfer (Indeks UV, Kelembapan, Tutupan Awan, Probabilitas Badai Petir), dan Alamat Lokasi yang Digeokode. Lokasi &Aturan Lokasi (KRITIS): Lokasi tempat data cuaca diminta ditentukan menggunakan kolom location. Kolom ini adalah struktur 'oneof', yang berarti Anda HARUS memberikan nilai untuk HANYA SATU dari tiga sub-kolom lokasi di bawah untuk memastikan pencarian data cuaca yang akurat.
Koordinat Geografis (lat_lng)
- Gunakan parameter ini jika Anda diberikan koordinat lat/lng yang tepat.
- Contoh: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Los Angeles
ID Tempat (place_id)
- ID string yang tidak ambigu (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 spesifisitas untuk geocoding.
- Kota & Wilayah: Selalu sertakan wilayah/negara (mis., "London, UK", bukan "London").
- Alamat Jalan: Berikan alamat lengkap (mis., "1600 Pennsylvania Ave NW, Washington, DC").
- Kode Pos: HARUS disertai dengan nama negara (mis., "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 Cuaca Per Jam: Berikan location, date, dan hour (0-23). Gunakan untuk waktu tertentu (mis., "at 5 PM") atau istilah seperti "next few hours" atau "later today". Jika pengguna menentukan menit, bulatkan ke jam terdekat. Prakiraan cuaca per jam di luar 120 jam dari sekarang tidak didukung. Cuaca per jam historis didukung hingga 24 jam yang lalu. Prakiraan Cuaca Harian: Berikan location dan date. Jangan tentukan hour. Gunakan untuk permintaan hari umum (mis., "weather for tomorrow", "weather on Friday", "weather on 12/25"). Jika tanggal hari ini tidak ada dalam konteks, Anda harus mengklarifikasinya dengan pengguna. Prakiraan cuaca harian di luar 10 hari termasuk hari ini tidak didukung. Cuaca historis tidak didukung. Batasan Parameter:
|
compute_routes |
Menghitung rute perjalanan antara tempat asal dan tujuan yang ditentukan. Mode Perjalanan yang Didukung: DRIVE (default), WALK. Persyaratan Input (KRITIS): Memerlukan tempat asal dan tujuan. Setiap tempat asal dan tujuan harus diberikan menggunakan salah satu metode berikut, yang berada dalam kolomnya masing-masing:
address: (string, mis., 'Eiffel Tower, Paris'). Catatan: Makin mendetail atau spesifik alamat input, makin baik hasilnya. lat_lng: (objek, {"latitude": number, "longitude": number}) place_id: (string, mis., 'ChIJOwE_Id1w5EAR4Q27FkL6T_0') Catatan: ID ini dapat diperoleh dari alat search_places. Kombinasi jenis input apa pun diizinkan (mis., tempat asal berdasarkan alamat, tujuan berdasarkan lat_lng). Jika tempat asal atau tujuan tidak ada, Anda HARUS meminta klarifikasi kepada pengguna sebelum mencoba memanggil alat. Contoh Panggilan Alat: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}
- Output yang didasarkan harus dikaitkan dengan sumber menggunakan informasi dari kolom
attribution jika tersedia.
|
resolve_names |
Menyelesaikan daftar batch kueri lokasi tertentu (nama landmark atau alamat yang tepat) ke ID Tempat Google Maps kanonis. Persyaratan Input (KRITIS):
queries (array objek - WAJIB): Daftar kueri lokasi yang akan diselesaikan. Anda dapat menentukan hingga 20 kueri.
- Setiap objek kueri harus memiliki:
text (string - WAJIB): Kueri teks yang mewakili nama tempat atau alamat tertentu yang akan diselesaikan.
- Contoh:
'Googleplex, Mountain View, CA', '1600 Amphitheatre Pkwy, Mountain View, CA', 'Eiffel Tower, Paris'.
location_bias (objek - OPSIONAL): Gunakan parameter 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, mis., US, CA) pengguna untuk memprioritaskan hasil.
Petunjuk untuk Panggilan Alat:
- Spesifisitas (KRITIS): Kueri harus mewakili nama tempat atau alamat tertentu. Penelusuran umum seperti
'restaurants' atau nama rantai seperti 'Starbucks' tidak didukung.
- JANGAN panggil alat ini jika alat hilir yang ingin Anda panggil sudah menerima string alamat atau nama tempat mentah secara langsung.
Penanganan Error (KRITIS):
- Alat ini adalah alat pemrosesan batch. Permintaan dapat menampilkan "hasil campuran" (mis., 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 sebagian.
|
resolve_maps_urls |
Menyelesaikan daftar URL Google Maps ke ID Tempat Google Maps kanonis. Kapan harus memanggil alat ini (KRITIS):
- Gunakan alat ini saat pengguna memberikan satu atau beberapa link atau URL berbagi Google Maps (mis., '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 diselesaikan dalam satu permintaan batch.
Persyaratan Input (KRITIS):
urls (array string - WAJIB): Daftar URL Google Maps yang akan diselesaikan. Setiap URL harus berupa URL Google Maps satu tempat yang valid. Penanganan Error (KRITIS):
- Alat ini adalah alat pemrosesan batch. Permintaan dapat menampilkan "hasil campuran" (mis., 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 tertentu yang gagal. Kunci failed_requests mewakili indeks berbasis 0 dari URL yang gagal dalam permintaan. Jangan berasumsi bahwa seluruh panggilan batch gagal karena kegagalan sebagian.
|
