<br />

> [!WARNING]
> This product or feature is Experimental (pre-GA). Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. Pre-GA Offerings are covered by the [Google
> Maps Platform Service Specific Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms). For more information, see the [launch stage descriptions](https://developers.google.com/maps/launch-stages.md.txt).

<br />

**European Economic Area (EEA) developers**

> [!NOTE]
> If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](https://developers.google.com/maps/comms/eea/faq.md.txt).

> [!CAUTION]
> **Caution:** AI summaries are only available for residential destinations in certain metropolitan areas in the United States and India. Coverage is limited to these areas and may be low, especially outside of city centers. For a list of supported metropolitan areas, see [Destination coverage](https://developers.google.com/maps/documentation/geocoding/ai-powered-summaries.md.txt#destination-coverage).

The Geocoding API offers AI-generated summaries to help users understand a
destination. These summaries are provided in the
[`Destination`](https://developers.google.com/maps/documentation/geocoding/reference/rest/v4alpha/geocode.destinations/searchDestinations.md.txt#Destination)
object in the `arrivalSummary` field.

These summaries are short, scannable text snippets of about 120 characters or 24
words or less, that encapsulate distinctive attributes about the destination to
help users during trip planning and arrival.

For example:

- "Behind Domino's Pizza ⋅ Mid-rise apartment building with white and brick-red stripes ⋅ Entrance is behind a black metal gate"
- "Tall cream apartment building with balconies ⋅ Entrance is under a large arched bridge over the driveway and has a security booth"

Arrival summaries are AI-generated. However, these summaries are
experimental and may occasionally contain inaccurate information. Your users
shouldn't rely on AI-powered summaries as their source of information.

## Request an arrival summary

To return an arrival summary in the response, include
`destinations.arrivalSummary` in the `X-Goog-FieldMask`
header of your [Search for
destinations](https://developers.google.com/maps/documentation/geocoding/search-for-destinations) request:

```console
curl -X POST -d '{
  "place": "places/ChIJAWLGeHRZwokRV4Dojw9TEHA"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: destinations.arrivalSummary" \
https://geocode.googleapis.com/v4alpha/geocode/destinations
```

> [!IMPORTANT]
> **Important:** The AI-powered summaries feature is Experimental. Form HTTP requests using the `/v4alpha/` channel. [More information about launch stage channels](https://developers.google.com/maps/documentation/geocoding/geocoding-v4-overview.md.txt#launch_stage_channels).

The `arrival_summary` field contains an `ArrivalSummary` object with the
following fields: `text`, `flag_content_url`, and `disclosure_text`.

The response is in the form:

```json
{
  "destinations": [
    {
      "arrivalSummary": {
        "text": {
          "text": "Tall red-brick apartment building ⋅ Entrance has a glass front and a grey metal overhang",
          "languageCode": "en"
        },
        "flagContentUrl": "https://www.google.com/local/review/rap/report?postId=...",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    }
  ]
}
```

## Display AI-powered summaries

When you display AI-powered summaries in your app, you must include the required
disclosure text and a link to report issues with the summary.

### Disclosure text

When displaying an AI-powered summary from the `text` field, you must include
the localized disclosure text provided in the `disclosure_text` field of the
`ArrivalSummary` object in the response immediately below the summary. Never
modify or augment the disclosure text provided by the API.

### Report issues

Each summary contains a `flag_content_url` which provides a link for users to
report issues with the summary content. When displaying an AI-powered summary,
you must make this link available to users to report issues with the summary.

For more information, see [Policies for Geocoding
API](https://developers.google.com/maps/documentation/geocoding/policies#ai-powered-summaries).

## Destination coverage

AI-powered summaries are only available for residential destinations, in the
following metropolitan areas:

### United States

- Atlanta
- Boston
- Chicago
- Dallas-Fort Worth
- Houston
- Las Vegas
- Los Angeles
- Miami
- New York
- Philadelphia
- San Diego
- San Francisco
- Seattle
- Washington, D.C.

### India

- Bangalore (Bengaluru)
- Chennai
- Delhi (New Delhi)
- Hyderabad
- Kolkata
- Mumbai

## Feedback

This is an experimental feature of the Geocoding API. We would appreciate
feedback at
[geocoding-feedback-channel@google.com](mailto:geocoding-feedback-channel@google.com).