MCP Tools Reference: mapstools.googleapis.com

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 pada 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.

  • 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": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Pesan permintaan untuk SearchText.

SearchTextRequest

Representasi JSON 
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "pageSize": integer,
  "pageToken": string,

  // Union field _location_bias can be only one of the following:
  "locationBias": {
    object (LocationBias)
  }
  // End of list of possible types for union field _location_bias.
}
Kolom
textQuery

string

Wajib. Kueri teks.
languageCode

string

Opsional. Bahasa yang digunakan untuk meminta ringkasan ditampilkan. Jika kode bahasa tidak ditentukan atau tidak dikenali, ringkasan dengan preferensi bahasa Inggris akan ditampilkan.

Misalnya, "en" untuk bahasa Inggris.

Daftar bahasa yang didukung saat ini: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

Opsional. Kode negara/wilayah Unicode (CLDR) lokasi asal permintaan. Parameter ini digunakan untuk menampilkan detail tempat, seperti nama tempat khusus wilayah, jika tersedia. Parameter dapat memengaruhi hasil berdasarkan hukum yang berlaku.

Misalnya, "US" untuk Amerika Serikat.

Untuk mengetahui informasi selengkapnya, lihat https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Perhatikan bahwa kode wilayah 3 digit saat ini tidak didukung.
pageSize

integer

Opsional. Jumlah maksimum tempat yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini.
pageToken

string

Opsional. Token halaman, yang diterima dari panggilan SearchText sebelumnya. Berikan ini untuk mengambil halaman selanjutnya.

Kolom union _location_bias.

_location_bias hanya dapat berupa salah satu dari hal berikut:
locationBias

object (LocationBias)

Wilayah opsional untuk memengaruhi hasil penelusuran. Jika ada lokasi eksplisit di text_query, lokasi tersebut akan digunakan untuk memengaruhi hasil penelusuran, bukan kolom ini.

LocationBias

Representasi JSON 
{
  "circle": {
    object (Circle)
  }
}
Kolom
circle

object (Circle)

Opsional. Lingkaran yang ditentukan oleh titik tengah dan radius. radius_meters bersifat opsional. Jika tidak disetel, hasil akan cenderung mengarah ke titik tengah.

Lingkaran

Representasi JSON 
{
  "center": {
    object (google.type.LatLng)
  },

  // Union field _radius_meters can be only one of the following:
  "radiusMeters": number
  // End of list of possible types for union field _radius_meters.
}
Kolom
center

object (google.type.LatLng)

Wajib. Titik tengah lingkaran.

Kolom union _radius_meters.

_radius_meters hanya dapat berupa salah satu dari hal berikut:
radiusMeters

number

Radius lingkaran dalam meter. Radius harus berada dalam jarak 50.000 meter.

LatLng

Representasi JSON 
{
  "latitude": number,
  "longitude": number
}
Kolom
latitude

number

Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0].
longitude

number

Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0].

Skema Output

Pesan respons untuk SearchText.

SearchTextResponse

Representasi JSON 
{
  "places": [
    {
      object (PlaceView)
    }
  ],
  "summary": string,
  "nextPageToken": string
}
Kolom
places[]

object (PlaceView)

Hanya output. Daftar tempat yang disebutkan dalam ringkasan.
summary

string

Hanya output. Ringkasan bahasa alami dari hasil penelusuran. Ringkasan dapat berisi kutipan berbasis nol seperti "[0]", "[1]", "[2]", dll. Kutipan ini dipetakan ke tempat yang sesuai di kolom places.
nextPageToken

string

Opsional. Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya.

PlaceView

Representasi JSON 
{
  "place": string,
  "id": string,
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },

  // Union field _location can be only one of the following:
  "location": {
    object (google.type.LatLng)
  }
  // End of list of possible types for union field _location.
}
Kolom
place

string

Nama resource tempat yang mendasarinya, dalam format "places/{id}".
id

string

ID tempat dari tempat yang mendasarinya.
googleMapsLinks

object (GoogleMapsLinks)

Link untuk memicu berbagai tindakan Google Maps.

Kolom union _location.

_location hanya dapat berupa salah satu dari hal berikut:
location

object (google.type.LatLng)

Posisi tempat ini.

LatLng

Representasi JSON 
{
  "latitude": number,
  "longitude": number
}
Kolom
latitude

number

Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0].
longitude

number

Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0].
Representasi JSON 
{
  "directionsUrl": string,
  "placeUrl": string,
  "writeAReviewUrl": string,
  "reviewsUrl": string,
  "photosUrl": string
}
Kolom
directionsUrl

string

Link untuk menampilkan rute ke tempat tersebut. Link hanya mengisi lokasi tujuan dan menggunakan mode perjalanan default DRIVE.
placeUrl

string

Link untuk menampilkan tempat ini.
writeAReviewUrl

string

Link untuk menulis ulasan untuk tempat ini di Google Maps.
reviewsUrl

string

Link untuk menampilkan ulasan tempat ini di Google Maps.
photosUrl

string

Link untuk menampilkan ulasan tempat ini di Google Maps.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ❌ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌