AI-powered place summaries are brief, 100-character overviews specific to a
given place ID. Place summaries aggregate many different types of data into a
high-level overview to help users get a snapshot of a place.

For example, place summaries may highlight popular foods, services, or goods
available for purchase at a location:

- *"Forum Shops eatery serving large portions of traditional Italian fare in a
  casual space."*
- *"Stylish salon offering haircuts and coloring, plus blowouts."*
- *"Large store with many vendors offering a variety of vintage decor,
  furniture, and clothing."*

Place summaries are supported by
[Place Details (New)](https://developers.google.com/maps/documentation/places/web-service/place-details.md.txt),
[Text Search (New)](https://developers.google.com/maps/documentation/places/web-service/text-search.md.txt),
and
[Nearby Search (New)](https://developers.google.com/maps/documentation/places/web-service/nearby-search.md.txt).
Place summaries are available for place types shown in [Supported
types](https://developers.google.com/maps/documentation/places/web-service/place-types) for the categories
**Culture** , **Entertainment and Recreation** , **Food and Drink** , **Shopping** ,
**Services,** and **Sports**.

Place summaries are supported for points of interest in the following languages
and regions:

| Language | Region |
|---|---|
| English | Australia Canada India New Zealand Singapore United States |

> [!NOTE]
> **Note:** Place summaries are not guaranteed for all places.

[Try the AI-powered summaries demo](https://mapsplatform.google.com/gemini-placesapi-demo/)

## Request a generative place summary

To return a place summary in the response, include the following field in the
[field mask](https://developers.google.com/maps/documentation/places/web-service/choose-fields.md.txt) of the
request:

- **Place Details (New):** `generativeSummary`
- **Text Search (New)** and **Nearby Search (New):** `places.generativeSummary`

The
[generativeSummary](https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places.md.txt#generativesummary)
field contains the following fields:

- `generativeSummary`: The place summary.
- [`overviewFlagContentUri`](https://developers.google.com/maps/documentation/places/web-service/content-reporting.md.txt): A link where users can flag a problem with the place summary.
- `disclosureText`: A localized text string with the disclosure text "Summarized with Gemini" that must be incorporated in attributions.

### Place Details (New) request

The following Place Details (New) request returns an `overview` summary
for a sushi restaurant in Chicago, IL:

```
curl -X GET https://places.googleapis.com/v1/places/ChIJ1eOF7HLTD4gRry3xPjk8DkU \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: displayName,generativeSummary"
```

The response is in the form:

```json
{
  "displayName": {
    "text": "Sushi Nova - Lincoln Park",
    "languageCode": "en"
  },
  "generativeSummary": {
    "overview": {
      "text": "Casual eatery with all-you-can-eat sushi and other Japanese fare, plus beer and sake.",
      "languageCode": "en-US"
    },
    "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDg4MGZkMzcyZWM4NWUzZDU6MHg0NTBlM2MzOTNlZjEyZGFmMAI&d=17924085&t=12",
    "disclaimerText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}
```

### Text Search (New) request

The following Text Search (New) request returns an `overview` summary for
spicy vegetarian restaurants in Mountain View, CA:

```
curl -X  POST -d '{
  "textQuery": "Spicy Vegetarian Food",
  "location_bias": {
    "rectangle": {
      "low": {
        "latitude": 37.415,
        "longitude": -122.091
      },
      "high": {
        "latitude": 37.429,
        "longitude": -122.065
      }
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchText'
```

The response is in the form:

```json
{
  "places": [
    {
      "id": "ChIJ8wN5kzm3j4AR_dRdUHoqrPI",
      "displayName": {
        "text": "Plant-Based Vegan Vietnamese",
        "languageCode": "en"
      }
    },
    {
      "id": "ChIJw4RuczO3j4ARC7RByZ5K9nI",
      "displayName": {
        "text": "sweetgreen",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual eatery offering healthy, made-to-order salads, plates, and grain bowls with vegan options.",
          "languageCode": "en-US"
        },
        "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzMzNzM2ZTg0YzM6MHg3MmY2NGE5ZWM5NDFiNDBiMAI&d=17924085&t=12",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}
```

### Nearby Search (New) request

The following Nearby Search (New) request returns an `overview` summary
for restaurants and cafes in Portland, OR:

```
curl -X POST -d '{
  "maxResultCount": 5,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 45.553360,
        "longitude": -122.674934
        },
      "radius": 1000
    }
  },
  "includedTypes": ["restaurant", "cafe"],
  "excludedTypes": [],
  "rankPreference":"POPULARITY"
  }' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchNearby'
```

The response is in the form:

```json
{
  "places": [
    {
      "id": "ChIJOa08KlqnlVQR_ZZx1jEcTYY",
      "generativeSummary": {
        "overview": {
          "text": "BBQ and Thai street fare, plus imaginative tropical cocktails, served in a vibrant space.",
          "languageCode": "en-US"
        },
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJU4OzoWynlVQRxlQMpGenSvA",
      "generativeSummary": {
        "overview": {
          "text": "Beer hall with a big selection of German brews, plus a central courtyard with food trucks.",
          "languageCode": "en-US"
        },
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}
```

## Attributions

All AI-powered summaries displayed in your app must be accompanied by the
appropriate attribution in accordance with Google's policies and standards. For
more information, see [Policies for Places
API](https://developers.google.com/maps/documentation/places/web-service/policies#ai-powered_summaries).