Skip to main content
This section documents the places data returned by the Google AI Mode endpoint. Places are part of the AI Mode response, so no separate API call is needed.

​
Example request

Places are intent-detected. Send a prompt that expresses location intent (for example, looking for restaurants, attractions, or businesses in a place). No flag is required. 
{
  "prompt": "best ramen restaurants in Tokyo",
  "country": "JP"
}
This produces a response containing the places array documented below.

​
Overview

Inline place cards extracted from the response when AI Mode detects location intent. Places appear in the order Google AI Mode ranks them in the answer; array index 0 is the top result.
Places in AI Mode
For GPS-enriched location data with latitude and longitude coordinates, see map. places and map may both appear in the same response.

​
Place structure

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

​
Response example

{
  "success": true,
  "result": {
    "text": "Here are highly-rated ramen restaurants in Tokyo...",
    "places": [
      {
        "title": "Gion District",
        "link": "https://www.google.com/viewer/place?mid=/g/11bw3yq9kp",
        "placeId": "/g/11bw3yq9kp",
        "index": 0,
        "thumbnail": "https://lh5.googleusercontent.com/p/example",
        "rating": 4.5,
        "reviews": 2900,
        "type": "Tourist attraction",
        "priceLevel": "$$",
        "address": "Gionmachi, Higashiyama Ward, Kyoto",
        "status": "Open now"
      }
    ]
  }
}