---
title: "GET /v1/photo/{photoId}"
method: GET
path: "/v1/photo/{photoId}"
tags: ["photo"]
---

# GET /v1/photo/{photoId}

`GET /v1/photo/{photoId}`

## Request

- Base URL: `https://streetviewpublish.googleapis.com`
- URL: `https://streetviewpublish.googleapis.com/v1/photo/{photoId}`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/streetviewpublish`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/streetviewpublish`

Gets the metadata of the specified Photo. This method returns the following error codes: * google.rpc.Code.PERMISSION_DENIED if the requesting user did not create the requested Photo. * google.rpc.Code.NOT_FOUND if the requested Photo does not exist. * google.rpc.Code.UNAVAILABLE if the requested Photo is still being indexed.

## Path parameters

- `photoId` string, required

## Query parameters

- `languageCode` string
- `view` 'BASIC' | 'INCLUDE_DOWNLOAD_URL'

## Response `200`

Successful response

- Photo: Photo is used to store 360 photos along with photo metadata.
  - `captureTime` string, google-datetime: Optional. Absolute time when the photo was captured. When the photo has no exif timestamp, this is used to set a timestamp in the photo metadata.
  - `connections` Connection[]: Optional. Connections to other photos. A connection represents the link from this photo to another photo.
    - `target` PhotoId: Identifier for a Photo.
      - `id` string: A unique identifier for a photo.
  - `downloadUrl` string: Output only. The download URL for the photo bytes. This field is set only when GetPhotoRequest.view is set to PhotoView.INCLUDE_DOWNLOAD_URL.
  - `mapsPublishStatus` 'UNSPECIFIED_MAPS_PUBLISH_STATUS' | 'PUBLISHED' | 'REJECTED_UNKNOWN': Output only. Status in Google Maps, whether this photo was published or rejected.
  - `photoId` PhotoId: Identifier for a Photo.
    - `id` string: A unique identifier for a photo.
  - `places` Place[]: Optional. Places where this photo belongs.
    - `languageCode` string: Output only. The language_code that the name is localized with. This should be the language_code specified in the request, but may be a fallback.
    - `name` string: Output only. The name of the place, localized to the language_code.
    - `placeId` string: Place identifier, as described in https://developers.google.com/places/place-id.
  - `pose` Pose: Raw pose measurement for an entity.
    - `accuracyMeters` number, float: The estimated horizontal accuracy of this pose in meters with 68% confidence (one standard deviation). For example, on Android, this value is available from this method: https://developer.android.com/reference/android/location/Location#getAccuracy(). Other platforms have different methods of obtaining similar accuracy estimations.
    - `altitude` number, double: Altitude of the pose in meters above WGS84 ellipsoid. NaN indicates an unmeasured quantity.
    - `gpsRecordTimestampUnixEpoch` string, google-datetime: Time of the GPS record since UTC epoch.
    - `heading` number, double: The following pose parameters pertain to the center of the photo. They match https://developers.google.com/streetview/spherical-metadata. Compass heading, measured at the center of the photo in degrees clockwise from North. Value must be >=0 and <360. NaN indicates an unmeasured quantity.
    - `latLngPair` LatLng: An object that represents a latitude/longitude pair. This is expressed as a pair of doubles to represent degrees latitude and degrees longitude. Unless specified otherwise, this object must conform to the WGS84 standard. Values must be within normalized ranges.
      - `latitude` number, double: The latitude in degrees. It must be in the range [-90.0, +90.0].
      - `longitude` number, double: The longitude in degrees. It must be in the range [-180.0, +180.0].
    - `level` Level: Level information containing level number and its corresponding name.
      - `name` string: Required. A name assigned to this Level, restricted to 3 characters. Consider how the elevator buttons would be labeled for this level if there was an elevator.
      - `number` number, double: Optional. Floor number, used for ordering. 0 indicates the ground level, 1 indicates the first level above ground level, -1 indicates the first level under ground level. Non-integer values are OK.
    - `pitch` number, double: Pitch, measured at the center of the photo in degrees. Value must be >=-90 and <= 90. A value of -90 means looking directly down, and a value of 90 means looking directly up. NaN indicates an unmeasured quantity.
    - `roll` number, double: Roll, measured in degrees. Value must be >= 0 and <360. A value of 0 means level with the horizon. NaN indicates an unmeasured quantity.
  - `shareLink` string: Output only. The share link for the photo.
  - `thumbnailUrl` string: Output only. The thumbnail URL for showing a preview of the given photo.
  - `transferStatus` 'TRANSFER_STATUS_UNKNOWN' | 'NEVER_TRANSFERRED' | 'PENDING' | 'COMPLETED' | 'REJECTED' | 'EXPIRED' | 'CANCELLED' | 'RECEIVED_VIA_TRANSFER': Output only. Status of rights transfer on this photo.
  - `uploadReference` UploadRef: Upload reference for media files.
    - `uploadUrl` string: An upload reference should be unique for each user. It follows the form: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}"
  - `uploadTime` string, google-datetime: Output only. Time when the image was uploaded.
  - `viewCount` string, int64: Output only. View count of the photo.

## Changes

- **2026-10-10** `456fcd9c879c`: 1 breaking
  - removed the media type `*/*` for the response with the status `200`

[Operation history](https://skmtc.dev/google/apis/streetviewpublish/changes/v1/photo/:photoId/get.md)

---

[API](https://skmtc.dev/google/apis/streetviewpublish.md) - [All operations](https://skmtc.dev/google/apis/streetviewpublish/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/streetviewpublish/revisions/456fcd9c879c?raw)
