Google AI Mode places schema - cloro

Places in AI Mode

This section documents the places data returned by the Google AI Mode endpoint: inline place cards extracted when AI Mode detects location intent, part of the AI Mode response so no separate API call is needed. Places appear in the order Google AI Mode ranks them in the answer; array index 0 is the top result. For use cases, pricing context, and copy-paste examples, see the AI Mode places API page on the product site.

For GPS-enriched location data with latitude and longitude coordinates, see map. places and map may both appear in the same response.

Example request

Places are intent-detected; no flag is required.

{
  "prompt": "best ramen restaurants in Tokyo",
  "country": "JP"
}

Place 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
`thumbnail`	string	Place thumbnail image URL
`rating`	number	Star rating (0-5)
`reviews`	integer	Number of reviews
`type`	string	Place type or category
`priceLevel`	string	Price level indicator (e.g., ”$”, ”$$”, ”$$$“)
`address`	string	Full address
`status`	string	Operating 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"
      }
    ]
  }
}