Google AI Mode places schema

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. For use cases, pricing context, and copy-paste examples, see the AI Mode places API page on the product site.

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.

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

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"
      }
    ]
  }
}

Citation pills Shopping cards

⌘I

Overview

ChatGPT

Google

Perplexity

Copilot

AI Mode

Grok

Gemini

Google News

Utilities

Google AI Mode places schema

Example request

Overview

Place structure

Response example

​Example request

​Overview

​Place structure

​Response example

Example request

Overview

Place structure

Response example