Method: photo.get
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ruft die Metadaten der angegebenen Photo ab.
Diese Methode gibt die folgenden Fehlercodes zurück:
HTTP-Anfrage
GET https://streetviewpublish.googleapis.com/v1/photo/{photoId}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
photoId |
string
Erforderlich. ID von Photo.
|
Abfrageparameter
| Parameter |
view |
enum (PhotoView)
Erforderlich. Gibt an, ob eine Download-URL für die Fotobytes in der Photo-Antwort zurückgegeben werden soll.
|
languageCode |
string
Der BCP-47-Sprachcode, z. B. „en-US“ oder „sr-Latn“. Weitere Informationen finden Sie unter http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Wenn „languageCode“ nicht angegeben ist, wird die Spracheinstellung des Nutzers für Google-Dienste verwendet.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Photo.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/streetviewpublish
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[[["\u003cp\u003eRetrieves metadata for a specified Photo using its ID.\u003c/p\u003e\n"],["\u003cp\u003eAllows specifying the view (including download URL) and language code.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003estreetviewpublish\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eReturns a Photo object on success, or an error if permissions are lacking, the photo is not found, or is still being indexed.\u003c/p\u003e\n"]]],["This describes retrieving photo metadata using a GET request to `https://streetviewpublish.googleapis.com/v1/photo/{photoId}`. The `photoId` (required) must be specified as a path parameter. Optional query parameters include `view` (required) and `languageCode`. The request body must be empty, while a successful response will contain a Photo instance. Specific error codes are returned for permission issues, non-existent photos, or photos being indexed. The request requires `https://www.googleapis.com/auth/streetviewpublish` authorization.\n"],null,["# Method: photo.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nGets the metadata of the specified [Photo](/streetview/publish/reference/rest/v1/photo#Photo).\n\nThis method returns the following error codes:\n\n- [google.rpc.Code.PERMISSION_DENIED](/streetview/publish/reference/rest/v1/Code#ENUM_VALUES.PERMISSION_DENIED) if the requesting user did not create the requested [Photo](/streetview/publish/reference/rest/v1/photo#Photo).\n- [google.rpc.Code.NOT_FOUND](/streetview/publish/reference/rest/v1/Code#ENUM_VALUES.NOT_FOUND) if the requested [Photo](/streetview/publish/reference/rest/v1/photo#Photo) does not exist.\n- [google.rpc.Code.UNAVAILABLE](/streetview/publish/reference/rest/v1/Code#ENUM_VALUES.UNAVAILABLE) if the requested [Photo](/streetview/publish/reference/rest/v1/photo#Photo) is still being indexed.\n\n### HTTP request\n\n`GET https://streetviewpublish.googleapis.com/v1/photo/{photoId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|------------------------------------------------------------------------------------------|\n| `photoId` | `string` Required. ID of the [Photo](/streetview/publish/reference/rest/v1/photo#Photo). |\n\n### Query parameters\n\n| Parameters ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `view` | `enum (`[PhotoView](/streetview/publish/reference/rest/v1/PhotoView)`)` Required. Specifies if a download URL for the photo bytes should be returned in the [Photo](/streetview/publish/reference/rest/v1/photo#Photo) response. |\n| `languageCode` | `string` The BCP-47 language code, such as \"en-US\" or \"sr-Latn\". For more information, see \u003chttp://www.unicode.org/reports/tr35/#Unicode_locale_identifier\u003e. If languageCode is unspecified, the user's language preference for Google services is used. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [Photo](/streetview/publish/reference/rest/v1/photo#Photo).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/streetviewpublish`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
