AI-powered place summaries

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

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

  • "Forum Shops eatery serving large portions of traditional Italian fare in acasual 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 byPlace Details (New),Text Search (New),andNearby Search (New).Place summaries are available for place types shown inSupportedtypes for the categoriesCulture,Entertainment and Recreation,Food and Drink,Shopping,Services, andSports.

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

LanguageRegion
English

India

United States

Note: Place summaries are not guaranteed for all places.

Request a generative place summary

To return a place summary in the response, include the following field in thefield mask of therequest:

  • Place Details (New):generativeSummary
  • Text Search (New) andNearby Search (New):places.generativeSummary

ThegenerativeSummaryfield contains the following fields:

  • generativeSummary: The place summary.
  • overviewFlagContentUri: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 anoverview summaryfor 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:

{"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 anoverview summary forspicy 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:

{"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 anoverview summaryfor 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:

{"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 theappropriate attribution in accordance with Google's policies and standards. Formore information, seePolicies for PlacesAPI.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-11-21 UTC.