Method: photos.batchGet

  • Retrieves metadata for multiple photos using their IDs via a GET request to the specified endpoint.

  • Requires providing photo IDs and view preference via query parameters, and an empty request body.

  • The response includes a list of results, each corresponding to a requested photo, and indicating success or failure.

  • Authorization is required using the https://www.googleapis.com/auth/streetviewpublish OAuth scope.

  • If the batch request fails, it may be due to missing fields or authentication errors, while individual photos may have separate failures detailed within the response.

Gets the metadata of the specified Photo batch.

Note that if photos.batchGet fails, either critical fields are missing or there is an authentication error. Even if photos.batchGet succeeds, individual photos in the batch may have failures. These failures are specified in each PhotoResponse.status in BatchGetPhotosResponse.results. See photo.get for specific failures that can occur per photo.

HTTP request

GET https://streetviewpublish.googleapis.com/v1/photos:batchGet

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
photoIds[]

string

Required. IDs of the Photos. For HTTP GET requests, the URL query parameter should be photoIds=<id1>&photoIds=<id2>&....
view

enum (PhotoView)

Required. Specifies if a download URL for the photo bytes should be returned in the Photo response.
languageCode

string

Optional. The BCP-47 language code, such as "en-US" or "sr-Latn". For more information, see http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. If languageCode is unspecified, the user's language preference for Google services is used.

Request body

The request body must be empty.

Response body

Response to batch get of Photos.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
Fields
results[]

object (PhotoResponse)

List of results for each individual Photo requested, in the same order as the requests in photos.batchGet.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/streetviewpublish

For more information, see the OAuth 2.0 Overview.