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

Google Gemini endpoint

sources

citationPills

Navigate to header: Example request

Navigate to header: Place structure

Navigate to header: Response example