Package com.google.genai.types

Class GroundingMetadata

java.lang.Object

com.google.genai.JsonSerializable

com.google.genai.types.GroundingMetadata

public abstract class GroundingMetadata
extends JsonSerializable

Metadata returned to client when grounding is enabled.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	GroundingMetadata.Builder	Builder for GroundingMetadata.

Constructor Summary

Constructors

Constructor	Description
GroundingMetadata()

Method Summary

Modifier and Type	Method	Description
static GroundingMetadata.Builder	builder()	Instantiates a builder for GroundingMetadata.
static GroundingMetadata	fromJson(String jsonString)	Deserializes a JSON string to a GroundingMetadata object.
abstract Optional<String>	googleMapsWidgetContextToken()	Optional.
abstract Optional<List<GroundingChunk>>	groundingChunks()	List of supporting references retrieved from specified grounding source.
abstract Optional<List<GroundingSupport>>	groundingSupports()	Optional.
abstract Optional<RetrievalMetadata>	retrievalMetadata()	Optional.
abstract Optional<List<String>>	retrievalQueries()	Optional.
abstract Optional<SearchEntryPoint>	searchEntryPoint()	Optional.
abstract Optional<List<GroundingMetadataSourceFlaggingUri>>	sourceFlaggingUris()	Optional.
abstract GroundingMetadata.Builder	toBuilder()	Creates a builder with the same values as this instance.
abstract Optional<List<String>>	webSearchQueries()	Optional.

Methods inherited from class com.google.genai.JsonSerializable

stringToJsonNode, toJson

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

GroundingMetadata

public GroundingMetadata()

Method Details

googleMapsWidgetContextToken

public abstract Optional<String> googleMapsWidgetContextToken()

Optional. Output only. Resource name of the Google Maps widget context token to be used with the PlacesContextElement widget to render contextual data. This is populated only for Google Maps grounding. This field is not supported in Gemini API.

groundingChunks

public abstract Optional<List<GroundingChunk>> groundingChunks()

List of supporting references retrieved from specified grounding source.

groundingSupports

public abstract Optional<List<GroundingSupport>> groundingSupports()

Optional. List of grounding support.

retrievalMetadata

public abstract Optional<RetrievalMetadata> retrievalMetadata()

Optional. Output only. Retrieval metadata.

retrievalQueries

public abstract Optional<List<String>> retrievalQueries()

Optional. Queries executed by the retrieval tools. This field is not supported in Gemini API.

searchEntryPoint

public abstract Optional<SearchEntryPoint> searchEntryPoint()

Optional. Google search entry for the following-up web searches.

sourceFlaggingUris

public abstract Optional<List<GroundingMetadataSourceFlaggingUri>> sourceFlaggingUris()

Optional. Output only. List of source flagging uris. This is currently populated only for Google Maps grounding. This field is not supported in Gemini API.

webSearchQueries

public abstract Optional<List<String>> webSearchQueries()

Optional. Web search queries for the following-up web search.

builder

public static GroundingMetadata.Builder builder()

Instantiates a builder for GroundingMetadata.

toBuilder

public abstract GroundingMetadata.Builder toBuilder()

Creates a builder with the same values as this instance.

fromJson

public static GroundingMetadata fromJson(String jsonString)

Deserializes a JSON string to a GroundingMetadata object.