Google Gemini places schema - cloro
Gemini
Google Gemini places schema
Schema for place cards returned by the Google Gemini endpoint when a lodging or local carousel appears, with names, ratings, prices, and links.
This section documents the
places
data returned by the
Google Gemini endpoint
: 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.
Places in Gemini
Gemini’s place cards are not sources, and they do not appear in
sources
or
citationPills
. An answer can carry places, sources, both, or neither.
Navigate to header: Example request Example request
Places are intent-detected; no flag is required.
{
"prompt"
:
"Best hotels in Sydney CBD with harbour views and breakfast"
,
"country"
:
"AU"
}
Navigate to header: Place structure 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.
Navigate to header: Response example Response example
{
"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"
}
]
}
}
Was this page helpful?
Ask a question...
Navigate to header: Example request