Google AI Mode map schema

This section documents the map data returned by the Google AI Mode endpoint. Map entries are part of the AI Mode response — no separate API call is needed. For use cases, pricing context, and copy-paste examples, see the AI Mode places API page on the product site.

Example request

Map entries are intent-detected: send a prompt with location intent that surfaces map-aware results. No flag is required.

{
  "prompt": "coffee shops near Central Park",
  "country": "US"
}

This produces a response containing the map array documented below.

Overview

GPS-enriched location data extracted from the response when AI Mode surfaces map-aware results. Each entry includes latitude/longitude coordinates suitable for plotting on a map. Map entries appear in render order; array index 0 is the first card shown on the map carousel.

For inline place cards without GPS coordinates, see places. places and map may both appear in the same response — places is the inline place-card layer, map is the GPS-enriched layer.

Map entry structure

Field	Type	Description
`title`	string	Place name
`link`	string	Google viewer URL for the place
`placeId`	string	Google Places ID
`index`	integer	Position index of the place in the results
`gps_coordinates`	object	Geographic coordinates (`latitude`, `longitude`)
`thumbnail`	string	Place thumbnail image URL
`rating`	number	Star rating (0-5)
`reviews`	integer	Number of reviews
`type`	string	Place type or category
`address`	string	Full address
`status`	string	Operating status (e.g., “Open now”)

`gps_coordinates`

Field	Type	Description
`latitude`	number	Latitude coordinate
`longitude`	number	Longitude coordinate

Response example

{
  "success": true,
  "result": {
    "text": "Here are some coffee shops near Central Park...",
    "map": [
      {
        "title": "Central Park Cafe",
        "link": "https://www.google.com/viewer/place?mid=/g/11bw3yq9kp",
        "placeId": "/g/11bw3yq9kp",
        "index": 0,
        "gps_coordinates": {
          "latitude": 40.7831,
          "longitude": -73.9712
        },
        "thumbnail": "https://lh5.googleusercontent.com/p/example",
        "rating": 4.5,
        "reviews": 1234,
        "type": "Coffee shop",
        "address": "123 Broadway, New York",
        "status": "Open now"
      }
    ]
  }
}

Videos Extract Grok

⌘I

Overview

ChatGPT

Google

Perplexity

Copilot

AI Mode

Grok

Gemini

Google News

Utilities

Google AI Mode map schema

Example request

Overview

Map entry structure

`gps_coordinates`

Response example

​Example request

​Overview

​Map entry structure

​gps_coordinates

​Response example

Example request

Overview

Map entry structure

`gps_coordinates`

Response example