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 oleh aplikasi AI.

Penyiapan Server

Anda harus mengaktifkan server MCP dan menyiapkan autentikasi sebelum digunakan. Untuk mengetahui informasi selengkapnya tentang cara menggunakan server MCP jarak jauh Google dan Google Cloud, lihat Ringkasan server MCP Google Cloud.

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 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 untuk 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

Mengambil data cuaca 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, 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.

Lokasi & Aturan Lokasi (KRITIS): Lokasi yang datanya diminta ditentukan menggunakan kolom 'location'. Kolom ini adalah struktur 'oneof', yang berarti Anda HARUS memberikan nilai untuk HANYA SATU dari tiga sub-bidang lokasi di bawah untuk memastikan pencarian data cuaca yang akurat.

  1. Koordinat Geografis (lat_lng)

    • Gunakan saat Anda diberi koordinat lat/lng yang tepat.
    • Contoh: "lat_lng": { "latitude": 34.0522, "longitude": -118.2437 } // Los Angeles

  2. ID Tempat (place_id)

    • ID string yang tidak ambigu (ID Tempat Google Maps).
    • place_id dapat diambil dari alat search_places.
    • Contoh: "place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0" // Menara Eiffel

  3. String Alamat (address)

    • String bentuk bebas yang memerlukan kekhususan untuk geokoding.
    • Kota & Wilayah: Selalu sertakan wilayah/negara (misalnya, "London, Inggris Raya", bukan "London").
    • Alamat: Berikan alamat lengkap (misalnya, "1600 Pennsylvania Ave NW, Washington, DC").
    • Kode Pos: HARUS disertai dengan nama negara (misalnya, "90210, Amerika Serikat", BUKAN "90210").

Mode Penggunaan: 1. Cuaca Saat Ini: Berikan address saja. Jangan tentukan date dan hour.

  1. Prakiraan Cuaca Per Jam: Berikan address, 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 cuaca per jam lebih dari 48 jam dari sekarang tidak didukung.

  2. Prakiraan Harian: Berikan address 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 dengan pengguna. Prakiraan cuaca harian lebih dari 7 hari, termasuk hari ini, tidak didukung. Cuaca historis tidak didukung.

Batasan Parameter: * Zona waktu: Semua input date dan hour harus relatif terhadap zona waktu lokal lokasi, bukan zona waktu pengguna.

  • Format Tanggal: Input harus dipisahkan menjadi {year, month, day} bilangan bulat.

  • Satuan: Defaultnya adalah METRIC. Tetapkan units_system ke IMPERIAL untuk Fahrenheit/Mil jika pengguna menyiratkan standar AS atau memintanya secara eksplisit.
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:

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

  • lat_lng: (object, {"latitude": number, "longitude": number})

  • 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":"Menara Eiffel"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

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
}'