feat(firebaseai): add Google Maps Grounding support by ryanwilson · Pull Request #18144 · firebase/flutterfire

ryanwilson · 2026-03-25T17:57:11Z

Introduces support for Google Maps Grounding to the firebase_ai SDK, establishing feature parity with other platforms.

API Changes:

Added Tool.googleMaps() factory and GoogleMaps class.
Introduced RetrievalConfig and LatLng for dynamic location-based tool configurations.
Expanded ToolConfig to include an optional retrievalConfig property.
Added GoogleMapsGroundingChunk to represent parsed Maps location properties (uri, title, placeId).
Updated GroundingChunk to expose the new maps property alongside web.
Exported all new grounding models publicly via firebase_ai.dart.

Example App:

Added a dedicated "Grounding" page (grounding_page.dart) to the main navigation menu.
Implemented dynamic UI toggles for both Search and Maps Grounding.
Implemented dynamic parsing and Markdown rendering of returned grounding chunks.

Testing:

Added comprehensive JSON roundtrip serialization tests for all new Tool configurations.
Added parsing tests mapping Developer API JSON payloads to GoogleMapsGroundingChunk.
Manually tested newly added web app section with Vertex and Developer APIs

Checklist

Before you create this PR confirm that it meets all requirements listed below by checking the relevant checkboxes ([x]).
This will ensure a smooth and quick review process. Updating the pubspec.yaml and changelogs is not required.

I read the [Contributor Guide] and followed the process outlined there for submitting PRs.
My PR includes unit or integration tests for all changed/updated/fixed behaviors (See [Contributor Guide]).
All existing and new tests are passing.
I updated/added relevant documentation (doc comments with ///).
The analyzer (melos run analyze) does not report any problems on my PR.
I read and followed the [Flutter Style Guide].
I signed the [CLA].
I am willing to follow-up on review comments in a timely manner.

Breaking Change

Does your PR require plugin users to manually update their apps to accommodate your change?

Yes, this is a breaking change.
No, this is not a breaking change.

Introduces support for Google Maps Grounding to the firebase_ai SDK, establishing feature parity with other platforms. API Changes: - Added `Tool.googleMaps()` factory and `GoogleMaps` class. - Introduced `RetrievalConfig` and `LatLng` for dynamic location-based tool configurations. - Expanded `ToolConfig` to include an optional `retrievalConfig` property. - Added `GoogleMapsGroundingChunk` to represent parsed Maps location properties (`uri`, `title`, `placeId`). - Updated `GroundingChunk` to expose the new `maps` property alongside `web`. - Exported all new grounding models publicly via `firebase_ai.dart`. Example App: - Added a dedicated "Grounding" page (`grounding_page.dart`) to the main navigation menu. - Implemented dynamic UI toggles for both Search and Maps Grounding. - Implemented dynamic parsing and Markdown rendering of returned grounding chunks. Testing: - Added comprehensive JSON roundtrip serialization tests for all new Tool configurations. - Added parsing tests mapping Developer API JSON payloads to `GoogleMapsGroundingChunk`. - Manually tested newly added web app section with Vertex and Developer APIs

gemini-code-assist · 2026-03-25T17:57:15Z

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

ryanwilson · 2026-03-25T18:01:54Z

Sample app snippets showing functionality (and the Search grounding part of the sample)

ryanwilson · 2026-03-26T01:15:17Z

The Android test appears to be a flake

ryanwilson · 2026-03-26T01:16:03Z

/gemini review

gemini-code-assist

Code Review

This pull request introduces Google Maps grounding capabilities to the firebase_ai library and demonstrates its usage in the example application. Key changes include new API classes for Google Maps grounding chunks, tools, and configuration (like LatLng and RetrievalConfig), along with updated serialization/deserialization logic and comprehensive unit tests. The example app now features a dedicated "Grounding" page, enabling users to toggle Search and Maps grounding, input latitude/longitude, and interact with the model to visualize grounding sources in the response. Review comments suggest adding a mounted check in _sendPrompt to prevent potential errors, improving the display of nullable Google Maps grounding source properties for better user experience, and refactoring the model initialization logic to reduce code duplication.

packages/firebase_ai/firebase_ai/example/lib/pages/grounding_page.dart

…age.dart Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

paulb777 · 2026-03-26T14:18:18Z

packages/firebase_ai/firebase_ai/lib/src/api.dart

+  GoogleMapsGroundingChunk({this.uri, this.title, this.placeId});
+
+  /// The URI of the place.
+  final String? uri;


Does dart have a URL type and would that be more idiomatic?

I don't believe so - this is copying Google Search Grounding's same uri parameter

/// The URI of the retrieved web page. final String? uri;

paulb777 · 2026-03-26T14:19:28Z

packages/firebase_ai/firebase_ai/lib/firebase_ai.dart

        CitationMetadata,
        Citation,
+        GoogleMapsGroundingChunk,
+        GroundingChunk,


Why adding GroundingChunk here? Was it missed before?

I believe so but I'll defer to @cynthiajoan on if that should be here or not

Open question on if WebGroundingChunk also needs to be exposed (separately maybe?)

Since they are on the receiving side, developer usually don't have the necessity to construct them. But it also would not hurt if they need to take it as an entity and pass it around on the user side. I would say let's add all three in this change.

cynthiajoan · 2026-03-27T04:11:02Z

packages/firebase_ai/firebase_ai/test/firebase_vertexai_test.dart

+      expect(model, isA<GenerativeModel>());
+    });
+
    // ... other tests (e.g., with different parameters)


lol let's remove this line.

ryanwilson added 2 commits March 25, 2026 14:26

Fixes

8327599

Formatting and import fix

4301b4b

gemini-code-assist bot reviewed Mar 26, 2026

View reviewed changes

ryanwilson and others added 2 commits March 25, 2026 22:03

Update packages/firebase_ai/firebase_ai/example/lib/pages/grounding_p…

9880afb

…age.dart Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Gemini Code Review feedback

8851d18

ryanwilson requested a review from cynthiajoan March 26, 2026 10:45

ryanwilson marked this pull request as ready for review March 26, 2026 10:45

paulb777 reviewed Mar 26, 2026

View reviewed changes

cynthiajoan changed the title ~~feat(ai): add Google Maps Grounding support~~ feat(firebaseai): add Google Maps Grounding support Mar 27, 2026

cynthiajoan reviewed Mar 27, 2026

View reviewed changes

cynthiajoan approved these changes Mar 27, 2026

View reviewed changes

Conversation

ryanwilson commented Mar 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Checklist

Breaking Change

Uh oh!

gemini-code-assist bot commented Mar 25, 2026

Uh oh!

ryanwilson commented Mar 25, 2026

Uh oh!

ryanwilson commented Mar 26, 2026

Uh oh!

ryanwilson commented Mar 26, 2026

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

paulb777 Mar 26, 2026

Choose a reason for hiding this comment

Uh oh!

ryanwilson Mar 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

paulb777 Mar 26, 2026

Choose a reason for hiding this comment

Uh oh!

ryanwilson Mar 26, 2026

Choose a reason for hiding this comment

Uh oh!

ryanwilson Mar 26, 2026

Choose a reason for hiding this comment

Uh oh!

cynthiajoan Mar 27, 2026

Choose a reason for hiding this comment

Uh oh!

cynthiajoan Mar 27, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

ryanwilson commented Mar 25, 2026 •

edited

Loading

ryanwilson Mar 26, 2026 •

edited

Loading