Grounding Lite

Experimental: Grounding Lite is in the Experimental (pre-GA) stage. Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. Pre-GA Offerings are covered by the Google Maps Platform Service Specific Terms. For more information, see the launch stage descriptions. There is no charge for using Grounding Lite while it is in Experimental.

Google Maps Platform Grounding Lite is a service with Model Context Protocol (MCP) support that makes it easy to ground your AI applications with trusted geospatial data from Google Maps. The MCP server provides tools that allow LLMs to access capabilities for places, weather, and routes. You can try out Grounding Lite by enabling it in any tool that supports MCP servers.

Tools

Grounding Lite provides tools that allow LLMs to access the following Google Maps capabilities:

• Search places: Request information about places and get AI-generated place data summaries, as well as Place IDs, latitude and longitude coordinates, and Google Maps links for each of the places included in the summary. You can use the returned Place IDs and latitude and longitude coordinates with other Google Maps Platform APIs to show places on a map.
• Lookup weather: Request information about weather and return current conditions, hourly forecasts, and daily forecasts.

• Compute routes: Request information about driving or walking routes between two locations and return route distance and duration information.

  Note: Grounding Lite does not provide step-by-step routing, directions, real-time traffic, or navigation information

Enabling the Maps Grounding Lite MCP server allows LLMs to call the new tools exposed by the server to return additional grounding information for the data types listed above. While the LLM can use this additional information for context, the response that the LLM ultimately generates may not include the exact information returned by the MCP server. You should verify the accuracy of the generated response.

Billing and quotas

There is no charge for using Grounding Lite while it is Experimental. However, the following quotas apply to the tools provided by Grounding Lite:

• Search places: 100 queries per minute, per project. 1,000 queries per day, per project.
• Lookup weather: 300 queries per minute, per project.
• Compute routes: 300 queries per minute, per project.

Policies and terms of service

Grounding Lite is subject to the Google Maps Platform Terms of Service, including the service-specific terms for this service. This section describes additional service usage requirements for Grounding Lite, including compatible LLMs and source attribution requirements.

Requirements for Compatible LLMs

You may only use Grounding Lite with an LLM that is compliant with the Google Maps Platform Terms of Service.

For example, you are responsible for ensuring that Google Maps Content is not cached by, stored by, or used to improve the LLM that you choose to use. Before using Grounding Lite, you will need to review the Terms of Service for any model you intend to use with Grounding Lite. You must not use Grounding Lite with any models that use the data input into the model for any model training or improvement. You are responsible for ensuring that your use of the model fully complies with the restrictions on Google Maps Content in the Google Maps Platform Terms of Service, including the service specific terms.

Attribution requirements for Google Maps sources

Each tool response from Grounding Lite includes sources. When presenting results that use tools provided by Grounding Lite, you must include the associated Google Maps sources in a way that meets the following requirements:

• The Google Maps sources must immediately follow the generated content that the sources support. This generated content is also referred to as Grounded Output.
• The Google Maps sources must be viewable within one user interaction.

Sources for the Search places tool

The search_places tool places field provides sources that support the summary. For places, the following metadata is returned:

• place (resource name)
• id
• location
• googleMapsLinks

For each place, you must generate a link preview that meets these requirements:

• Attribute each source to Google Maps, following the Grounding Lite text attribution guidelines.
• Display the source page title from the Open Graph metadata og:title from the googleMapsLinks provided in the response.
• Link to the source using the places.googleMapsLinks.placeUrl from the response.

Configure LLMs to use the MCP server

To use Grounding Lite, you first need an API key with the Maps Grounding Lite API service enabled. Then, you can configure LLMs to access the MCP server. Grounding Lite MCP server uses Streamable HTTP transport.

Create or configure an API key

You can use an existing API key with Maps Grounding Lite or create a new one, as long as you enable the Maps Grounding Lite API service on the key. Maps Grounding Lite API does not charge during experimental, but billing must be enabled on the project.

To enable the API:

1. In the Google Cloud Console, choose the project you want to use for Grounding Lite.
2. Enable billing for the project in the Google Cloud Console.
3. From the top navigation, open Cloud Shell terminal.

4. Run the following commands to enable the service and MCP endpoint:

   gcloud beta services enable mapstools.googleapis.com --project=PROJECT_ID
   gcloud beta services mcp enable mapstools.googleapis.com --project=PROJECT_ID
   

5. Follow the steps in Getting started with Google Maps Platform to create or configure an API key.

Note: When creating or configuring an API key, be sure to limit the use of the key by applying the appropriate restrictions. For more information, see Restrict your API keys.

The API key should be passed to the MCP server using the header X-Goog-Api-Key. You need to specify this as a custom HTTP header in the LLM's MCP tool configuration.

Configure LLMs to access the Grounding Lite MCP server

Once you have an API key with the Maps Grounding Lite API service enabled, you can configure LLMs to access the MCP server by following the corresponding MCP configuration documentation and using the Grounding Lite MCP server URL: https://mapstools.googleapis.com/mcp

Configure Grounding Lite with the Gemini CLI

This section provides an example of how to configure the Grounding Lite MCP server using the Gemini CLI. For more details, see the MCP servers with the Gemini CLI.

1. Once you install the Gemini CLI, you can use the add command to configure Maps Grounding Lite MCP server:

   gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-grounding-lite-mcp https://mapstools.googleapis.com/mcp
   

   If the configuration was successful, you should see a confirmation that the server has been added to your user settings.

2. To validate that the server is working correctly, run the /mcp list command:

   > /mcp list
   
   Configured MCP servers:
   
   maps-grounding-lite-mcp - Ready (3 tools)
   Tools:
   -   compute_routes
   -   lookup_weather
   -   search_places
   

3. Start asking Maps related questions with the CLI. For example, try "Recommend me some restaurants in Mountain View" which should call the search_places tool on your behalf.

Sharing feedback

To share feedback about Grounding Lite, use the following forms:

• Report a bug
• Submit a feature request
• Provide feedback