Skip to main content
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.

​
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.
Map in AI Mode

Map in AI Mode

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

FieldTypeDescription
titlestringPlace name
linkstringGoogle viewer URL for the place
place_idstringGoogle Places ID
indexintegerPosition index of the place in the results
gps_coordinatesobjectGeographic coordinates (latitude, longitude)
thumbnailstringPlace thumbnail image URL
ratingnumberStar rating (0-5)
reviewsintegerNumber of reviews
typestringPlace type or category
addressstringFull address
statusstringOperating status (e.g., “Open now”)

​
gps_coordinates

FieldTypeDescription
latitudenumberLatitude coordinate
longitudenumberLongitude 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",
        "place_id": "/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"
      }
    ]
  }
}
Map in AI Mode