maps_search()

Create a Google Maps search-mode tool for places and businesses.

Usage

Source

maps_search(
    *,
    provider="auto",
    include_examples=True,
    api_key=None,
    client=None,
    default_params=None,
    timeout=None,
    mode=SearchResultMode.COMPACT,
    response_format=SearchResultFormat.MARKDOWN,
    result_limit=10,
    name="maps_search"
)

The returned tool exposes query plus optional location, zoom, and nearby fields. zoom is constrained to 3 through 30, and nearby=True requires location.

Parameters

provider: ProviderName | str = "auto"

Agent SDK adapter name, "auto", or "function".

include_examples: bool = True

Add a short call example to the model-facing description.

api_key: str | None = None

Runtime authentication, custom client, application filters, timeout, and response mode and serialization selection.

client: str | None = None

Runtime authentication, custom client, application filters, timeout, and response mode and serialization selection.

default_params: str | None = None

Runtime authentication, custom client, application filters, timeout, and response mode and serialization selection.

timeout: str | None = None

Runtime authentication, custom client, application filters, timeout, and response mode and serialization selection.

mode: str | None = None

Runtime authentication, custom client, application filters, timeout, and response mode and serialization selection.

response_format: str | None = None

Runtime authentication, custom client, application filters, timeout, and response mode and serialization selection.

result_limit: int | None = 10

Maximum items kept in each result list in both response modes; use None to keep all returned results.

name: str = "maps_search"

Tool name presented to the model.

Returns

Any

A provider-native Google Maps search tool.