REST Resource: photo

Ressource: Foto

„Foto“ wird zum Speichern von 360°-Fotos zusammen mit den Fotometadaten verwendet.

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, wenn ein Foto aktualisiert wird. Ausgabe nur beim Erstellen eines Fotos. ID für das Foto, die unter allen Fotos in Google eindeutig ist.

uploadReference

object (UploadRef)

Nur Eingabe. Erforderlich beim Erstellen eines Fotos. Nur Eingabe. Die Ressourcen-URL, in die die Fotobytes 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 URL der Miniaturansicht zur Anzeige einer Vorschau des jeweiligen Fotos.

pose

object (Pose)

Optional. Position des Fotos.

connections[]

object (Connection)

Optional. Verbindungen zu anderen Fotos. Eine Verbindung stellt den Link von diesem Foto zu einem anderen Foto dar.

captureTime

string (Timestamp format)

Optional. Absoluter Zeitpunkt der Aufnahme des Fotos. Wenn das Foto keinen EXIF-Zeitstempel hat, wird dieser verwendet, um einen Zeitstempel in den Fotometadaten festzulegen.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

uploadTime

string (Timestamp format)

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

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

places[]

object (Place)

Optional. Orte, zu denen das 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, der angibt, ob dieses Foto veröffentlicht oder abgelehnt wurde.

PhotoId

ID für Photo.

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

string

Eine eindeutige Kennung für ein Foto.

UploadRef

Referenz für Mediendateien hochladen

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 Format: „https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}“.

Position

Raw-Pose-Messung einer 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 Pose, wie hier erläutert: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng Wenn beim Erstellen eines Photo-Elements kein Breiten- und Längengrad angegeben ist, wird die Geolocation aus dem EXIF-Header verwendet. Wenn kein Längen- und Breitengrad im Foto oder im EXIF-Header angegeben ist, schlägt der Fotoprozess fehl.

altitude

number

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

heading

number

Die folgenden Positionsparameter beziehen sich auf die Mitte des Fotos. Sie stimmen mit https://developers.google.com/streetview/spherical-metadata überein. Kompassrichtung, gemessen in der Mitte des Fotos, in Grad im Uhrzeigersinn von Norden aus gemessen. Wert muss >=0 und <360 sein. NaN steht für eine nicht gemessene Menge.

pitch

number

Neigung, gemessen in der Mitte des Fotos in Grad. Wert muss >=-90 und <= 90 sein. Ein Wert von -90 bedeutet, dass Sie direkt nach unten schauen, und ein Wert von 90 bedeutet, dass Sie direkt nach oben schauen. NaN steht für eine nicht gemessene Menge.

roll

number

Rollen, gemessen in Grad. Der Wert muss zwischen 0 und 360 liegen. Ein Wert von 0 bedeutet, dass die Ebene am Horizont liegt. NaN steht für eine nicht gemessene Menge.

gpsRecordTimestampUnixEpoch

string (Timestamp format)

Zeitpunkt des GPS-Eintrags seit der UTC-Epoche.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

level

object (Level)

Ebene (die Etage eines Gebäudes), die für die Konfiguration der vertikalen Navigation verwendet wird.

accuracyMeters

number

Die geschätzte horizontale Genauigkeit dieser Position in Metern mit einer Zuverlässigkeit von 68 % (eine Standardabweichung). Bei Android ist dieser Wert beispielsweise über diese Methode verfügbar: https://developer.android.com/reference/android/location/Location#getAccuracy(). Andere Plattformen haben unterschiedliche Methoden, um ähnliche Genauigkeitsschätzungen 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 Ebene, die die Nummer der Stufe und den entsprechenden Namen enthalten.

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

number

Optional. Etagennummer; wird für die Bestellung verwendet. 0 gibt die Bodenhöhe an, 1 die erste oberirdische Ebene, -1 die erste Ebene. Nicht ganzzahlige Werte sind zulässig.

name

string

Erforderlich. Ein diesem Level zugewiesener Name mit maximal 3 Zeichen. Überlegen Sie, wie die Aufzug-Schaltflächen für diese Ebene beschriftet würden, 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 zwischen dem zugehörigen Foto und einem anderen Foto.

Ort

Ortsmetadaten für eine Entität.

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

string

Ortskennung, wie unter https://developers.google.com/places/place-id beschrieben

name

string

Nur Ausgabe. Der Name des Orts, lokalisiert in den languageCode.

languageCode

string

Nur Ausgabe. Der languageCode, mit dem der Name lokalisiert wird. Dies sollte dem in der Anfrage angegebenen „languageCode“ entsprechen, 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 Die Übertragung der Fotos wurde gestartet, aber der Empfänger hat noch nicht geantwortet.
COMPLETED Die Übertragung des Fotos ist abgeschlossen und das Foto wurde an den Empfänger übertragen.
REJECTED Der Empfänger hat diese Fotoübertragung abgelehnt.
EXPIRED Die Übertragung der Fotos ist abgelaufen, bevor der Empfänger eine Aktion ausgeführt 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 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 die hochgeladenen Photo in Street View auf Google Maps.

delete

Löscht eine Photo und die zugehörigen Metadaten.

get

Ruft die Metadaten der angegebenen Photo ab.

startUpload

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

update

Aktualisiert die Metadaten einer Photo, z. B. Pose, Ortsverknüpfung oder Verbindungen.