API Reference › AI Mode › Places

Places

Location-aware place cards that cloro surfaces from a Google AI Mode answer whenever the model recognizes that a prompt is asking about physical venues.

Overview

Places is not a standalone endpoint. It is one of the structured blocks embedded in the payload returned by the Google AI Mode extraction call, so you do not issue a separate request to obtain it. When cloro determines that a prompt carries local or geographic intent — for instance a search for eateries, landmarks, or nearby shops — it parses the corresponding cards out of the answer and delivers them as a places array inside the same response.

Entries in the array follow the ranking order that Google AI Mode assigns in its reply, so the element at index 0 is the highest-ranked venue. If the underlying answer also carries GPS-level coordinates, those are reported separately in the map block; both places and map can be present in a single response.

Triggering places

There is no explicit flag to request this data. Simply submit a prompt whose wording implies a location goal and cloro will attach the array automatically when AI Mode returns matching cards.

{
  "prompt": "best ramen restaurants in Tokyo",
  "country": "JP"
}

Place fields

Field	Type	Description
title	string	Display name of the venue.
link	string	Google viewer URL that opens the place.
place_id	string	Google Places identifier for the venue.
index	integer	Zero-based rank of the card within the results.
thumbnail	string	URL of the preview image for the place.
rating	number	Average star score on a 0 to 5 scale.
reviews	integer	Count of user reviews backing the rating.
type	string	Category label describing the venue, such as a restaurant or attraction.
price_level	string	Relative cost indicator expressed in dollar signs, for example "$", "$$", or "$$$".
address	string	Complete street address of the place.
status	string	Current operating state, for example "Open now".

Response example

{
  "success": true,
  "result": {
    "text": "Here are some highly rated ramen spots across Tokyo...",
    "places": [
      {
        "title": "Gion District",
        "link": "https://www.google.com/viewer/place?mid=/g/11bw3yq9kp",
        "place_id": "/g/11bw3yq9kp",
        "index": 0,
        "thumbnail": "https://lh5.googleusercontent.com/p/example",
        "rating": 4.5,
        "reviews": 2900,
        "type": "Tourist attraction",
        "price_level": "$$",
        "address": "Gionmachi, Higashiyama Ward, Kyoto",
        "status": "Open now"
      }
    ]
  }
}

Notes

Any individual field may be omitted when Google AI Mode does not expose that detail for a given card, so treat every property as optional and guard against missing keys when reading the array. For coordinate data, pair this block with the map section. Questions about parsing behavior can go to [email protected].