MCP Reference: mapstools.googleapis.com

Server Model Context Protocol (MCP) bertindak sebagai proxy antara layanan eksternal yang menyediakan konteks, data, atau kemampuan ke Model Bahasa Besar (LLM) atau aplikasi AI. Server MCP menghubungkan aplikasi AI ke sistem eksternal seperti database dan layanan web, menerjemahkan responsnya ke dalam format yang dapat dipahami aplikasi AI.

Ini adalah server MCP yang disediakan oleh Maps Grounding Lite API. Server ini menyediakan alat bagi developer untuk membangun aplikasi LLM di atas Google Maps Platform.

Endpoint Server

Endpoint Layanan MCP adalah alamat jaringan dan antarmuka komunikasi (biasanya URL) Server MCP yang digunakan aplikasi AI (Host untuk klien MCP) untuk membuat koneksi yang aman dan standar. Ini adalah titik kontak bagi LLM untuk meminta konteks, memanggil alat, atau mengakses resource. Endpoint MCP Google dapat bersifat global atau regional.

Server MCP mapstools.googleapis.com memiliki endpoint MCP berikut:

Alat MCP

Alat MCP adalah fungsi atau kemampuan yang dapat dieksekusi yang diekspos oleh Server MCP ke aplikasi LLM atau AI untuk melakukan tindakan di dunia nyata.

Server MCP mapstools.googleapis.com memiliki alat berikut:

Alat MCP
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):

  1. 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').

  2. 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 membatasi radius 5 km: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
      • Untuk sangat memihak titik tengah: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (menghilangkan radius_meters).

  3. 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 dalam bahasa Inggris.

  4. 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 Panggilan Alat:

  • Informasi Lokasi (KRITIS): 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 membedakan.

  • Selalu berikan text_query yang paling spesifik dan kaya konteks jika memungkinkan.

  • Gunakan location_bias hanya jika koordinat diberikan secara eksplisit atau jika menyimpulkan lokasi dari konteks pengguna yang diketahui sesuai dan diperlukan untuk mendapatkan hasil yang lebih baik.
lookup_weather

Memberikan kondisi saat ini, prakiraan per jam, dan harian untuk lokasi mana pun. Gunakan alat ini untuk semua pertanyaan terkait cuaca.

Data Spesifik yang Tersedia: Suhu (Saat Ini, Terasa Seperti, Maks/Min, Indeks Panas), Angin (Kecepatan, Angin Kencang, 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 Geokode.

Persyaratan Input (KRITIS):

  • Kondisi Saat Ini: Hanya memerlukan lokasi (misalnya, kota atau alamat). Jangan tentukan tanggal atau jam.

  • Prakiraan Cuaca Per Jam: Memerlukan lokasi dan jam (0-23). Gunakan jika pengguna menanyakan cuaca pada waktu tertentu atau menggunakan istilah seperti 'beberapa jam ke depan' atau 'nanti hari ini'.

  • Prakiraan Harian: Memerlukan lokasi dan tanggal lengkap.

Penanganan Tanggal (KRITIS): Tanggal dan jam yang diberikan pengguna HARUS diberikan dalam zona waktu lokal dari lokasi yang diminta. Tanggal HARUS dipecah menjadi parameter bilangan bulat terpisah: tahun, bulan, dan hari. Format yang diperlukan untuk parameter ini adalah: {"year": , "month": , "day": }
compute_routes

Menghitung rute perjalanan antara tempat asal dan tujuan yang ditentukan. Mode Perjalanan yang Didukung: DRIVE (default), WALK.

Persyaratan Input (KRITIS): Memerlukan asal dan tujuan. Setiap nilai harus diberikan menggunakan salah satu metode berikut, yang disusun bertingkat dalam kolom masing-masing:

  • alamat: (string, misalnya, 'Menara Eiffel, Paris'). Catatan: Makin terperinci atau spesifik alamat input, makin baik hasilnya.

  • lat_lng: (objek, {"latitude": angka, "longitude": angka})

  • place_id: (string, misalnya, 'ChIJOwE_Id1w5EAR4Q27FkL6T_0') Catatan: ID ini dapat diperoleh dari alat search_places. Kombinasi jenis input apa pun diizinkan (misalnya, asal menurut alamat, tujuan menurut lat_lng). Jika 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"}