MCP Tools Reference: mapstools.googleapis.com

Narzędzie: search_places

Wywołuj to narzędzie, gdy użytkownik chce znaleźć miejsca, firmy, adresy, lokalizacje, punkty orientacyjne lub inne elementy związane z wyszukiwaniem w Mapach Google.

Wymagania dotyczące danych wejściowych (KRYTYCZNE):

1. text_query (ciąg znaków – WYMAGANY): główne zapytanie. Musi on jasno określać, czego szuka użytkownik.

   • Przykłady: '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'.
   • W przypadku szczegółowych informacji o miejscu: dodaj wymagany atrybut (np. 'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address').

2. location_bias (obiekt – OPCJONALNIE): użyj tego parametru, aby nadać priorytet wynikom w pobliżu określonego obszaru geograficznego.

   • Format: {"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
   • Użycie:
     • Aby ustawić preferencje dla promienia 5 km: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
     • Aby silnie faworyzować punkt środkowy: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (pomijając radius_meters).

3. language_code (ciąg znaków – OPCJONALNIE): język, w którym ma być wyświetlane podsumowanie wyników wyszukiwania.

   • Format: dwuliterowy kod języka (ISO 639-1), opcjonalnie po którym następuje podkreślenie i dwuliterowy kod kraju (ISO 3166-1 alfa-2), np. en, ja, en_US, zh_CN, es_MX. Jeśli nie podasz kodu języka, wyniki będą wyświetlane w języku angielskim.

4. region_code (ciąg znaków – OPCJONALNIE): kod regionu CLDR użytkownika w Unicode. Ten parametr służy do wyświetlania szczegółów miejsca, np. nazwy miejsca w danym regionie, jeśli jest dostępna. W zależności od obowiązujących przepisów parametr może wpływać na wyniki.

   • Format: dwuliterowy kod kraju (ISO 3166-1 alfa-2), np. US, CA.

Instrukcje dotyczące wywołania narzędzia:

• Informacje o lokalizacji (KRYTYCZNE): wyszukiwanie musi zawierać wystarczające informacje o lokalizacji. Jeśli lokalizacja jest niejednoznaczna (np. tylko „pizzerie”), musisz ją określić w parametrze text_query (np. „pizzerie w Nowym Jorku”) lub użyć parametru location_bias. W razie potrzeby podaj nazwę miasta, stanu/prowincji i regionu/kraju, aby uniknąć uściślania.

• Zawsze podawaj jak najbardziej szczegółowe i bogate w kontekst text_query.

• Używaj parametru location_bias tylko wtedy, gdy współrzędne są wyraźnie podane lub gdy wnioskowanie o lokalizacji na podstawie znanego kontekstu użytkownika jest odpowiednie i konieczne do uzyskania lepszych wyników.

• Wygenerowane dane muszą być przypisane do źródła na podstawie informacji z pola attribution, jeśli są dostępne.

Poniższy przykładowy kod pokazuje, jak używać curl do wywoływania narzędzia MCP search_places.

Schemat wejściowy

{
  "textQuery": string,
  "languageCode": string,
  "regionCode": 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.
}

{
  "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
}

Schemat wyjściowy

{
  "places": [
    {
      object (PlaceView)
    }
  ],
  "summary": 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
}

Adnotacje do narzędzi

Adnotacje narzędzia są wysyłane do klientów MCP w celu opisania podstawowego ryzyka związanego z danym narzędziem. Większość klientów traktuje te wskazówki jako niezaufane, ale można ich używać do określania, kiedy użytkownikowi może zostać wysłany monit o potwierdzenie.

Oprócz ciągu tytułu zdefiniowano te wskazówki logiczne:

• readOnlyHint: jeśli wartość jest prawdziwa, narzędzie nie modyfikuje środowiska. Wartość domyślna: fałsz.
• destructiveHint: jeśli ma wartość Prawda, narzędzie może wykonywać działania destrukcyjne. Jeśli wartość to „false”, narzędzie może wykonywać tylko działania dodające. Wartość domyślna: true.
• idempotentHint: jeśli ma wartość „true”, wielokrotne wywoływanie narzędzia z tymi samymi argumentami nie będzie miało dodatkowego wpływu na jego środowisko. Wartość domyślna: fałsz.
• openWorldHint: jeśli wartość to „true”, narzędzie może wchodzić w interakcje z „otwartym światem” podmiotów zewnętrznych. Jeśli wartość jest fałszywa, narzędzie może wchodzić w interakcje tylko z podmiotami wewnętrznymi. Na przykład narzędzie do wyszukiwania w internecie byłoby narzędziem typu otwarty świat, a narzędzie do zapamiętywania nie.

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