REST Resource: photo

Ressource: Foto

Mit dieser App werden 360°-Fotos zusammen mit Fotometadaten gespeichert.

JSON-Darstellung 
{
  "photoId": {
    object (PhotoId)
  },
  "uploadReference": {
    object (UploadRef)
  },
  "downloadUrl": string,
  "thumbnailUrl": string,
  "shareLink": string,
  "pose": {
    object (Pose)
  },
  "connections": [
    {
      object (Connection)
    }
  ],
  "captureTime": string,
  "uploadTime": string,
  "places": [
    {
      object (Place)
    }
  ],
  "viewCount": string,
  "transferStatus": enum (TransferStatus),
  "mapsPublishStatus": enum (MapsPublishStatus)
}
Felder
photoId

object (PhotoId)

Erforderlich. Nur Ausgabe. Erforderlich beim Aktualisieren eines Fotos. Nur Ausgabe beim Erstellen eines Fotos. Kennung für das Foto, die für alle Fotos bei Google eindeutig ist.
uploadReference

object (UploadRef)

Nur Eingabe. Erforderlich beim Erstellen eines Fotos. Nur Eingabe. Die Ressourcen-URL, an die die Fotobyte hochgeladen werden.
downloadUrl

string

Nur Ausgabe. Die Download-URL für die Fotobytes. Dieses Feld wird nur festgelegt, wenn GetPhotoRequest.view auf PhotoView.INCLUDE_DOWNLOAD_URL gesetzt ist.
thumbnailUrl

string

Nur Ausgabe. Die Thumbnail-URL zum Anzeigen einer Vorschau des angegebenen Fotos.
pose

object (Pose)

Optional. Pose auf dem Foto.
connections[]

object (Connection)

Optional. Verbindungen zu anderen Fotos. Eine Verbindung stellt die Verknüpfung dieses Fotos mit einem anderen Foto dar.
captureTime

string (Timestamp format)

Optional. Absolute Zeit, zu der das Foto aufgenommen wurde. Wenn das Foto keinen EXIF-Zeitstempel hat, wird dieser verwendet, um einen Zeitstempel in den Fotometadaten festzulegen.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
uploadTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem das Bild hochgeladen wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
places[]

object (Place)

Optional. Orte, zu denen dieses Foto gehört.
viewCount

string (int64 format)

Nur Ausgabe. Anzahl der Aufrufe des Fotos.
transferStatus

enum (TransferStatus)

Nur Ausgabe. Status der Rechteübertragung für dieses Foto.
mapsPublishStatus

enum (MapsPublishStatus)

Nur Ausgabe. Status in Google Maps: Gibt an, ob dieses Foto veröffentlicht oder abgelehnt wurde.

PhotoId

ID für ein Photo.

JSON-Darstellung 
{
  "id": string
}
Felder
id

string

Eine eindeutige Kennung für ein Foto.

UploadRef

Referenz für das Hochladen von Mediendateien.

JSON-Darstellung 
{

  // Union field file_source can be only one of the following:
  "uploadUrl": string
  // End of list of possible types for union field file_source.
}
Felder
Union-Feld file_source Erforderlich. Für file_source ist nur einer der folgenden Werte zulässig:
uploadUrl

string

Eine Upload-Referenz muss für jeden Nutzer eindeutig sein. Sie hat das folgende Format: „https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}“.

Pose

Rohmessung der Pose für eine Entität.

JSON-Darstellung 
{
  "latLngPair": {
    object (LatLng)
  },
  "altitude": number,
  "heading": number,
  "pitch": number,
  "roll": number,
  "gpsRecordTimestampUnixEpoch": string,
  "level": {
    object (Level)
  },
  "accuracyMeters": number
}
Felder
latLngPair

object (LatLng)

Breiten- und Längengradpaar der Position, wie hier beschrieben: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng. Wenn Sie ein Photo erstellen und das Breiten- und Längengradpaar nicht angegeben ist, wird die Geolocation aus dem EXIF-Header verwendet. Wenn in einem Foto oder im EXIF-Header keine Breiten- und Längengradangaben enthalten sind, schlägt die Verarbeitung des Fotos fehl.
altitude

number

Höhe der Pose in Metern über dem WGS84-Ellipsoid. „NaN“ steht für eine nicht gemessene Menge.
heading

number

Die folgenden Posierungsparameter beziehen sich auf die Mitte des Fotos. Sie entsprechen https://developers.google.com/streetview/spherical-metadata. Kompasskurs, gemessen in der Mitte des Fotos in Grad im Uhrzeigersinn von Norden aus. Der Wert muss zwischen 0 und 360 liegen. „NaN“ steht für eine nicht gemessene Menge.
pitch

number

Neigung, gemessen in der Mitte des Fotos in Grad. Der Wert muss zwischen -90 und 90 liegen. Ein Wert von -90 bedeutet, dass die Kamera direkt nach unten gerichtet ist, ein Wert von 90, dass sie direkt nach oben gerichtet ist. „NaN“ steht für eine nicht gemessene Menge.
roll

number

Die Rollbewegung in Grad. Der Wert muss >= 0 und < 360 sein. Ein Wert von 0 bedeutet, dass die Kamera auf Höhe des Horizonts ist. „NaN“ steht für eine nicht gemessene Menge.
gpsRecordTimestampUnixEpoch

string (Timestamp format)

Zeit des GPS-Eintrags seit der UTC-Epoche.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
level

object (Level)

Ebene (das Stockwerk in einem Gebäude), die zum Konfigurieren der vertikalen Navigation verwendet wird.
accuracyMeters

number

Die geschätzte horizontale Genauigkeit dieser Pose in Metern mit einem Konfidenzniveau von 68 % (eine Standardabweichung). Unter Android ist dieser Wert beispielsweise über die Methode https://developer.android.com/reference/android/location/Location#getAccuracy() verfügbar. Auf anderen Plattformen gibt es andere Methoden, um ähnliche Schätzungen der Genauigkeit zu erhalten.

LatLng

Ein Objekt, das ein Paar aus Breiten- und Längengrad darstellt. Es wird als Paar aus Werten vom Typ „Double“ (Breiten- und Längengrad) ausgedrückt. Sofern nicht anders angegeben, muss dieses Objekt dem WGS84-Standard entsprechen. Die Werte müssen innerhalb normalisierter Bereiche liegen.

JSON-Darstellung 
{
  "latitude": number,
  "longitude": number
}
Felder
latitude

number

Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen.
longitude

number

Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen.

Level

Informationen zur Stufe, einschließlich Stufennummer und zugehörigem Namen.

JSON-Darstellung 
{
  "number": number,
  "name": string
}
Felder
number

number

Optional. Etagennummer, die für die Sortierung verwendet wird. 0 steht für das Erdgeschoss, 1 für das erste Obergeschoss und -1 für das erste Untergeschoss. Nicht ganzzahlige Werte sind zulässig.
name

string

Erforderlich. Ein Name, der diesem Level zugewiesen ist und auf 3 Zeichen begrenzt ist. Überlegen Sie, wie die Aufzugstasten für diese Ebene beschriftet wären, wenn es einen Aufzug gäbe.

Verbindung

Eine Verbindung ist der Link von einem Quellfoto zu einem Zielfoto.

JSON-Darstellung 
{
  "target": {
    object (PhotoId)
  }
}
Felder
target

object (PhotoId)

Erforderlich. Das Ziel der Verbindung vom enthaltenden Foto zu einem anderen Foto.

Ort

Metadaten für eine Einheit platzieren.

JSON-Darstellung 
{
  "placeId": string,
  "name": string,
  "languageCode": string
}
Felder
placeId

string

Orts-ID, wie unter https://developers.google.com/places/place-id beschrieben.
name

string

Nur Ausgabe. Der Name des Orts, lokalisiert in der Sprache, die durch „languageCode“ angegeben wird.
languageCode

string

Nur Ausgabe. Der languageCode, mit dem der Name lokalisiert wird. Dies sollte der in der Anfrage angegebene languageCode sein, kann aber auch ein Fallback sein.

TransferStatus

Status der Rechteübertragung.

Enums
TRANSFER_STATUS_UNKNOWN Der Status dieser Übertragung ist nicht angegeben.
NEVER_TRANSFERRED Dieses Foto wurde noch nie übertragen.
PENDING Diese Fotoübertragung wurde initiiert, aber der Empfänger hat noch nicht geantwortet.
COMPLETED Die Fotoübertragung wurde abgeschlossen und dieses Foto wurde an den Empfänger übertragen.
REJECTED Der Empfänger hat diese Fotoübertragung abgelehnt.
EXPIRED Die Fotoübertragung ist abgelaufen, bevor der Empfänger Maßnahmen ergriffen hat.
CANCELLED Der Absender hat diese Fotoübertragung abgebrochen.
RECEIVED_VIA_TRANSFER Der Empfänger ist aufgrund einer Rechteübertragung Eigentümer dieses Fotos.

MapsPublishStatus

Veröffentlichungsstatus des Fotos in Google Maps.

Enums
UNSPECIFIED_MAPS_PUBLISH_STATUS Der Status des Fotos ist unbekannt.
PUBLISHED Das Foto wird über Google Maps öffentlich veröffentlicht.
REJECTED_UNKNOWN Das Foto wurde aus unbekanntem Grund abgelehnt.

Methoden

create

 Nachdem der Client das Foto mit dem zurückgegebenen UploadRef hochgeladen hat, veröffentlicht CreatePhoto das hochgeladene Photo in Street View auf Google Maps.

delete

 Löscht ein Photo und seine Metadaten.

get

 Ruft die Metadaten der angegebenen Photo ab.

startUpload

 Erstellt eine Uploadsitzung, um mit dem Hochladen von Fotobyte zu beginnen.

update

 Aktualisiert die Metadaten eines Photo, z. B. Pose, Ortszuordnung und Verbindungen.