MCP Tools Reference: mapstools.googleapis.com

도구: search_places

사용자의 요청이 장소, 비즈니스, 주소, 위치, 관심 장소 또는 기타 Google 지도 관련 검색을 찾는 것인 경우 이 도구를 호출합니다.

입력 요구사항 (중요):

1. text_query (문자열 - 필수): 기본 검색어입니다. 사용자가 찾고 있는 내용을 명확하게 정의해야 합니다.

   • 예시: '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'
   • 특정 장소 세부정보: 요청된 속성 (예: 'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address')을 포함합니다.

2. location_bias (객체 - 선택사항): 특정 지리적 영역 근처의 결과에 우선순위를 지정하는 데 사용합니다.

   • 형식: {"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
   • 사용량:
     • 반경 5km로 편향: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
     • 중심점에 강하게 편향: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}}(radius_meters 생략)

3. language_code (문자열 - 선택사항): 검색 결과 요약을 표시할 언어입니다.

   • 형식: 두 자리 언어 코드(ISO 639-1) 뒤에 밑줄과 두 자리 국가 코드(ISO 3166-1 alpha-2)가 올 수 있습니다(예: en, ja, en_US, zh_CN, es_MX). 언어 코드가 제공되지 않으면 결과가 영어로 표시됩니다.

4. region_code (문자열 - 선택사항): 사용자의 유니코드 CLDR 지역 코드입니다. 이 매개변수는 지역별 장소 이름과 같은 장소 세부정보를 표시하는 데 사용됩니다(사용 가능한 경우). 이 매개변수는 관련 법률에 따라 결과에 영향을 미칠 수 있습니다.

   • 형식: 두 자리 국가 코드(ISO 3166-1 alpha-2)(예: US, CA)

도구 호출 안내:

• 위치 정보 (중요): 검색어에 충분한 위치 정보가 포함되어야 합니다. 위치가 모호한 경우 (예: '피자 가게') text_query에 위치를 지정하거나(예: '뉴욕의 피자 가게') location_bias 매개변수를 사용해야 합니다. 모호성을 해소하기 위해 필요한 경우 시, 주/도, 지역/국가 이름을 포함합니다.

• 항상 가장 구체적이고 맥락이 풍부한 text_query를 제공하세요.

• 좌표가 명시적으로 제공되거나 사용자의 알려진 컨텍스트에서 위치를 추론하는 것이 적절하고 더 나은 결과를 위해 필요한 경우에만 location_bias를 사용하세요.

• 그라운딩된 출력은 가능한 경우 attribution 필드의 정보를 사용하여 소스에 기여해야 합니다.

다음 코드 샘플은 curl를 사용하여 search_places MCP 도구를 호출하는 방법을 보여줍니다.

입력 스키마

{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "pageSize": integer,
  "includeExtendedDetails": boolean,

  // 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.
}

{
  "circle": {
    object (Circle)
  }
}

{
  "center": {
    object (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.
}

{
  "latitude": number,
  "longitude": number
}

출력 스키마

{
  "places": [
    {
      object (PlaceView)
    }
  ],
  "summary": string,
  "contentToken": string
}

{
  "place": string,
  "id": string,
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "attribution": {
    object (Attribution)
  },

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

{
  "latitude": number,
  "longitude": number
}

{
  "directionsUrl": string,
  "placeUrl": string,
  "writeAReviewUrl": string,
  "reviewsUrl": string,
  "photosUrl": string
}

{
  "title": string,
  "url": string
}

도구 주석

도구 주석은 MCP 클라이언트에 전송되어 특정 도구의 기본 위험을 설명합니다. 대부분의 클라이언트는 이러한 힌트를 신뢰할 수 없는 것으로 취급하지만, 확인 메시지가 사용자에게 전송될 수 있는 시점을 결정하는 데 사용할 수 있습니다.

제목 문자열과 함께 다음 불리언 힌트가 정의됩니다.

• readOnlyHint: true인 경우 도구가 환경을 수정하지 않습니다. 기본값: false.
• destructiveHint: true인 경우 도구에서 파괴적인 작업을 수행할 수 있습니다. false이면 도구는 추가 작업만 수행할 수 있습니다. 기본값은 true입니다.
• idempotentHint: true인 경우 동일한 인수로 도구를 반복적으로 호출해도 환경에 추가적인 영향을 미치지 않습니다. 기본값: false.
• openWorldHint: true인 경우 도구는 외부 항목의 '오픈 월드'와 상호작용할 수 있습니다. false이면 도구는 내부 항목과만 상호작용할 수 있습니다. 예를 들어 웹 검색 도구는 오픈 월드이지만 메모리 도구는 오픈 월드가 아닙니다.

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ✅ | Open World Hint: ❌