> [!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).
**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).
The Geocoding API's
[`SearchDestinations`](https://developers.google.com/maps/documentation/geocoding/reference/rest/v4alpha/geocode.destinations/searchDestinations.md.txt)
endpoint provides hyperlocal context,
including navigation points and entrances. To enhance user experience, the
response can include parameters for the [**Street View Static API**](https://developers.google.com/maps/documentation/streetview/overview.md.txt), allowing you
to display relevant imagery for these locations.
> [!IMPORTANT]
> **Important:** This feature is available in the `v4alpha` channel.
## Request imagery and annotations
To receive imagery and annotation information, you must include the following
fields to the `X-Goog-FieldMask` header:
- [`destinations.navigationPoints.streetViewThumbnail`](https://developers.google.com/maps/documentation/geocoding/reference/rest/v4alpha/geocode.destinations/searchDestinations.md.txt#navigationpoint)
- [`destinations.navigationPoints.entranceAnnotation`](https://developers.google.com/maps/documentation/geocoding/reference/rest/v4alpha/geocode.destinations/searchDestinations.md.txt#navigationpoint)
- [`destinations.entrances.streetViewThumbnail`](https://developers.google.com/maps/documentation/geocoding/reference/rest/v4alpha/geocode.destinations/searchDestinations.md.txt#entrance)
- [`destinations.entrances.streetViewAnnotation`](https://developers.google.com/maps/documentation/geocoding/reference/rest/v4alpha/geocode.destinations/searchDestinations.md.txt#entrance)
### Example cURL request
```bash
curl -X POST -d '{
"place": "places/ChIJkU89GL9ZwokRvVjWDQzhaNg"
}' \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: destinations.navigationPoints.streetViewThumbnail,destinations.navigationPoints.entranceAnnotation,destinations.entrances.streetViewThumbnail,destinations.entrances.streetViewAnnotation" \
https://geocode.googleapis.com/v4alpha/geocode/destinations
```
### Example JSON response
```json
{
"destinations": [
{
"entrances": [
{
"location": {
"latitude": 40.7406763,
"longitude": -74.0020733
},
"tags": [
"PREFERRED"
],
"place": "places/ChIJkU89GL9ZwokRvVjWDQzhaNg",
"streetViewThumbnail": {
"pano": "EUKaIR67fBVmpsHnXuIevA",
"widthPx": 400,
"heightPx": 600,
"headingDegree": 331.06186,
"fovDegree": 60
},
"streetViewAnnotation": {
"coordinates": [
{
"xPx": 184.7,
"yPx": 290.4
},
{
"xPx": 213.3,
"yPx": 289.4
},
{
"xPx": 214.8,
"yPx": 330.8
},
{
"xPx": 186.0,
"yPx": 332.5
}
]
}
}
]
}
]
}
```
## Featured fields
The `Entrance` and `NavigationPoint` objects in the response can contain a
`streetViewThumbnail` field with the following fields:
| Field | Description | Static API Parameter |
|---|---|---|
| `pano` | A specific panorama ID. | `pano` |
| `widthPx` | Suggested width for the image. | `size` (width part) |
| `heightPx` | Suggested height for the image. | `size` (height part) |
| `headingDegree` | Compass heading of the camera (0-360). | `heading` |
| `pitchDegree` | Up/down angle of the camera (-90 to 90). | `pitch` |
| `fovDegree` | Horizontal field of view (0-120). | `fov` |
## Request an image
To request a Street View image, use the values from the `streetViewThumbnail`
object to construct a URL for the
[Street View Static API](https://developers.google.com/maps/documentation/streetview/request-streetview.md.txt).
### Example URL
The following is an example of a constructed Street View Static API URL:
https://maps.googleapis.com/maps/api/streetview?size=400x600&pano=EUKaIR67fBVmpsHnXuIevA&heading=331.06186&fov=60&key=API_KEY&signature=YOUR_SIGNATURE
### Sample code: TypeScript
The following TypeScript function demonstrates how to construct the Static
Street View API URL from the Destinations endpoint output.
```typescript
interface StreetViewThumbnail {
pano: string;
widthPx: number;
heightPx: number;
headingDegree: number;
pitchDegree: number;
fovDegree: number;
}
function getStreetViewUrl(thumbnail: StreetViewThumbnail, apiKey: string): string {
const params = new URLSearchParams({
size: `${thumbnail.widthPx}x${thumbnail.heightPx}`,
pano: thumbnail.pano,
heading: thumbnail.headingDegree.toString(),
pitch: thumbnail.pitchDegree.toString(),
fov: thumbnail.fovDegree.toString(),
key: apiKey,
});
return `https://maps.googleapis.com/maps/api/streetview?${params.toString()}`;
}
```
## Image annotations
If an `Entrance` or a `NavigationPoint` is returned, it can also include an
image annotation of the corresponding entrance in the `streetViewAnnotation` or
the `entranceAnnotation` field. This provides pixel coordinates for a polygon
that outlines the entrance within the thumbnail image.
These annotations are intended for **client-side rendering** . You can use
them to draw an overlay (for example, using SVG or a `