MCP Tools Reference: mapstools.googleapis.com

Referensi Alat MCP:

Dokumen ini menjelaskan endpoint REST API yang menghadap eksternal yang digunakan untuk memanggil Alat Model Context Protocol (MCP) jarak jauh Google. API ini bertindak sebagai proxy yang aman antara klien HTTP eksternal (seperti curl atau layanan web) dan Server MCP internal.

Mendapatkan spesifikasi alat MCP

Untuk mendapatkan spesifikasi alat MCP untuk semua alat di server MCP, gunakan metode `tools/list`. Contoh berikut menunjukkan cara menggunakan curl untuk mencantumkan semua alat dan spesifikasinya yang saat ini tersedia dalam server MCP.

Permintaan Curl 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'

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

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP search_places.

Permintaan Curl 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
  "method": "tools/call",
  "params": {
    "name": search_places,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Alat: 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": }

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP lookup_weather.

Permintaan Curl 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
  "method": "tools/call",
  "params": {
    "name": lookup_weather,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Alat: 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"}

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP compute_routes.

Permintaan Curl 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
  "method": "tools/call",
  "params": {
    "name": compute_routes,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'