> ## Documentation Index
> Fetch the complete documentation index at: https://cloro.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Places

> Schema for inline place cards returned by the Google AI Mode endpoint when location intent is detected, including business names, ratings, and addresses.

This section documents the **places** data returned by the [Google AI Mode endpoint](/api-reference/endpoint/monitor-aimode). 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.

```json theme={null}
{
  "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.

<Frame caption="Places in AI Mode">
  <img src="https://mintcdn.com/cloro/Qv2xgJAgMecwTTRq/images/aimode/places.webp?fit=max&auto=format&n=Qv2xgJAgMecwTTRq&q=85&s=91d6ae1094ef30e35b52ad1ef84ca5e3" alt="Places in AI Mode" width="1438" height="1176" data-path="images/aimode/places.webp" />
</Frame>

<Note>
  For GPS-enriched location data with latitude and longitude coordinates, see [map](/api-reference/endpoint/aimode/map). `places` and `map` may both appear in the same response.
</Note>

## 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

```json theme={null}
{
  "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"
      }
    ]
  }
}
```