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

# Google Gemini places schema

> Schema for the place cards returned by the Google Gemini endpoint when the answer carries a lodging or local carousel, including names, ratings, prices and links.

This section documents the **places** data returned by the [Google Gemini endpoint](/docs/api-reference/endpoint/monitor-gemini): the cards Gemini renders above an answer when it detects local or lodging intent, part of the Gemini response so no separate API call is needed. Places appear in the order Gemini ranks them; array index `0` is the top card.

<Note>
  Gemini's place cards are not sources, and they do not appear in [sources](/docs/api-reference/endpoint/gemini/sources) or [citationPills](/docs/api-reference/endpoint/gemini/citation-pills). An answer can carry places, sources, both, or neither.
</Note>

## Example request

Places are intent-detected; no flag is required.

```json theme={null}
{
  "prompt": "Best hotels in Sydney CBD with harbour views and breakfast",
  "country": "AU"
}
```

## Place structure

| Field         | Type    | Description                                         |
| ------------- | ------- | --------------------------------------------------- |
| `index`       | integer | Position index of the place in the results          |
| `title`       | string  | Place name                                          |
| `link`        | string  | Google URL for the place                            |
| `thumbnail`   | string  | Place photo URL                                     |
| `rating`      | number  | Star rating (0-5)                                   |
| `reviews`     | integer | Number of reviews                                   |
| `type`        | string  | Place type or category (e.g., "5-star hotel")       |
| `description` | string  | Short description of the place                      |
| `price`       | string  | Nightly price as Gemini displays it (e.g., "\$565") |

Only `index`, `title` and `link` are always present. Gemini leaves the other fields out for cards that carry no such value.

## Response example

```json theme={null}
{
  "success": true,
  "result": {
    "text": "Here are some of the top-rated hotels in Sydney CBD...",
    "places": [
      {
        "index": 0,
        "title": "Pullman Quay Grand Sydney Harbour",
        "link": "https://www.google.com/travel/search?q=Pullman+Quay+Grand+Sydney+Harbour",
        "thumbnail": "https://lh3.googleusercontent.com/gps-cs-s/example",
        "rating": 4.4,
        "reviews": 1307,
        "type": "5-star hotel",
        "description": "Upscale hotel offering sophisticated suites, plus a restaurant, an indoor pool & a chic bar.",
        "price": "$565"
      }
    ]
  }
}
```