Method: photos.list
Stay organized with collections
Save and categorize content based on your preferences.
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.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-09 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-09 UTC."],[[["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."]]],["This document details how to retrieve a user's photos using the Street View Publish API. A `GET` request to `https://streetviewpublish.googleapis.com/v1/photos` is used. Key parameters include `view`, `pageSize`, `pageToken`, `filter`, and `languageCode`. The request body is empty. A successful response returns a JSON object containing a list of `photos`, and a `nextPageToken` for pagination. Access requires the `https://www.googleapis.com/auth/streetviewpublish` authorization scope.\n"]]
