API Reference › AI Mode › Map

Map

Location results carrying real GPS coordinates, emitted inside the Google AI Mode response whenever a prompt triggers map-aware answers.

Overview

The map array is not a standalone endpoint. It ships as part of the standard Google AI Mode extraction, so no extra request or flag is needed to obtain it. cloro detects location intent automatically; when a prompt resolves to results that Google renders on a map, those places are parsed and returned with latitude and longitude attached.

Entries follow the same order they appear in on the map carousel, so index 0 corresponds to the first card shown. Each item bundles descriptive metadata (name, rating, address) alongside a gps_coordinates object you can plot directly.

Note that map and places serve different purposes and may both be present in a single response. Use places for inline place cards that lack coordinates, and map when you need the GPS-enriched layer for mapping.

Map entry fields

Field	Type	Description
title	string	Display name of the place.
link	string	Google viewer URL pointing to the place.
place_id	string	Google Places identifier for the location.
index	integer	Zero-based position of the place within the results.
gps_coordinates	object	Geographic coordinates for the place; see the table below.
thumbnail	string	URL of the place's preview image.
rating	number	Average star rating on a 0–5 scale.
reviews	integer	Total count of user reviews.
type	string	Category or classification of the place.
address	string	Complete street address.
status	string	Current operating status, for example "Open now".

gps_coordinates

Field	Type	Description
latitude	number	Latitude value of the place.
longitude	number	Longitude value of the place.

Example request

Map entries surface on their own when a prompt expresses location intent. A typical AI Mode request looks like this:

{
  "prompt": "coffee shops near Central Park",
  "country": "US"
}

Response example

{
  "success": true,
  "result": {
    "text": "Here are some coffee shops near Central Park...",
    "map": [
      {
        "title": "Central Park Cafe",
        "link": "https://www.google.com/viewer/place?mid=/g/11bw3yq9kp",
        "place_id": "/g/11bw3yq9kp",
        "index": 0,
        "gps_coordinates": {
          "latitude": 40.7831,
          "longitude": -73.9712
        },
        "thumbnail": "https://lh5.googleusercontent.com/p/example",
        "rating": 4.5,
        "reviews": 1234,
        "type": "Coffee shop",
        "address": "123 Broadway, New York",
        "status": "Open now"
      }
    ]
  }
}

Notes

The map array is present only when AI Mode returns map-aware results; expect it to be absent or empty for prompts without location intent. Some fields such as rating, reviews, or status may be missing for places that do not expose that data. Questions about parsing coverage can go to [email protected].