Method: photos.list

  • Lists all photos belonging to a user, although recently created, unindexed photos may not be included.

  • Allows filtering by place ID, latitude, and longitude, and lets you specify the view and page size.

  • Responses include a list of photos and a token for retrieving subsequent pages if available.

  • Requires authorization with the https://www.googleapis.com/auth/streetviewpublish scope.

Lists all the Photos that belong to the user.

Note: Recently created photos that are still being indexed are not returned in the response.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
view

enum (PhotoView)

Required. Specifies if a download URL for the photos bytes should be returned in the Photos response.
pageSize

integer

Optional. The maximum number of photos to return. pageSize must be non-negative. If pageSize is zero or is not provided, the default page size of 100 is used. The number of photos returned in the response may be less than pageSize if the number of photos that belong to the user is less than pageSize.
pageToken

string

Optional. The nextPageToken value returned from a previous photos.list request, if any.
filter

string

Optional. The filter expression. For example: placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw.

The filters supported are: placeId, min_latitude, max_latitude, min_longitude, max_longitude. See https://google.aip.dev/160 for more information.
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 list all photos that belong to a user.

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

JSON representation 
{
  "photos": [
    {
      object (Photo)
    }
  ],
  "nextPageToken": string
}
Fields
photos[]

object (Photo)

List of photos. The pageSize field in the request determines the number of items returned.
nextPageToken

string

Token to retrieve the next page of results, or empty if there are no more results in the list.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.