google-adk-kotlin-core/com.google.adk.kt.tools/GoogleMapsTool

GoogleMapsTool

class GoogleMapsTool(val model: String? = null) : BaseTool

A built-in tool that is automatically invoked by Gemini 2 models to retrieve search results from Google Maps.

This tool operates internally within the model and does not require or perform local code execution.

Constructors

GoogleMapsTool

constructor(model: String? = null)

Properties

customMetadata

val customMetadata: Map<String, Any>

The custom metadata of the tool.

description

val description: String

The description of the tool.

isLongRunning

val isLongRunning: Boolean = false

Whether the tool's final result will be delivered out-of-band. When true, the framework marks the call as long-running and uses the tool's return value as the function-response payload. Returning Unit means "no response yet": the FR event is suppressed so the function-call event (which carries the call id in longRunningToolIds and is thus the turn's final response) ends the turn without re-invoking the model. A non-Unit return -- including an explicit empty Map -- is treated as a real response and emitted. (Unit suppression aligns with Python; Java instead always emits {}.) The longRunningToolIds id also drives the resumable-mode pause gate so the invocation can be resumed later via a user-injected function-response.

model

val ~~model~~: String? = null

name

val name: String

The name of the tool.

Functions

open fun close()

declaration

open override fun declaration(): FunctionDeclaration?

Returns the underlying function declaration.

processLlmRequest

open suspend override fun processLlmRequest(toolContext: ToolContext, llmRequest: LlmRequest): LlmRequest

Processes the LLM request before it is sent.

run

open suspend override fun run(context: ToolContext, args: Map<String, Any>): Any

Executes the tool and returns its result.