REST Resource: photo

Ressource: Foto

Mit 360°-Fotos und -Metadaten werden Fotos 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, wenn ein Foto aktualisiert wird. Wird nur beim Erstellen eines Fotos ausgegeben. Bild-ID für das Foto, das 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 Fotobyte hochgeladen werden.
downloadUrl

string

Nur Ausgabe. Die Download-URL für die Fotobyte. Dieses Feld ist nur festgelegt, wenn für GetPhotoRequest.view der Wert PhotoView.INCLUDE_DOWNLOAD_URL festgelegt ist.
thumbnailUrl

string

Nur Ausgabe. Die URL der Miniaturansicht für die Vorschau des Fotos.
pose

object (Pose)

Optional. Pose des Fotos.
connections[]

object (Connection)

Optional. Verbindungen zu anderen Fotos. Eine Verbindung steht für den Link von diesem Foto zu einem anderen Foto.
captureTime

string (Timestamp format)

Optional. Absolute Zeit zur Aufnahme des Fotos. Wenn das Foto keinen Exif-Zeitstempel hat, wird damit ein Zeitstempel für die Fotometadaten festgelegt.

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

string (Timestamp format)

Nur Ausgabe. Uhrzeit, zu der das Bild hochgeladen wurde

Ein Zeitstempel im RFC3339 UTC-Format „Zulu“ mit einer Nanosekundenauflösung 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 dieses Foto gehört
viewCount

string (int64 format)

Nur Ausgabe. Anzahl der Aufrufe für das Foto
transferStatus

enum (TransferStatus)

Nur Ausgabe. Status der Rechteübertragung auf diesem Foto.
mapsPublishStatus

enum (MapsPublishStatus)

Nur Ausgabe. Status in Google Maps, unabhängig davon, ob dieses Foto veröffentlicht oder abgelehnt wurde.

Foto-ID

ID für Photo.

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

string

Eine eindeutige Kennung für ein Foto.

Verweis-Upload

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

Sie sollte für jeden Nutzer eindeutig sein. Sie hat das Format „https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}“

Pose (Position)

Unbearbeitete Posen-Messung 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)

Hier erfahren Sie, wie der Längen- und Breitengrad der Position dargestellt wird: https://cloud.google.com/Datastore/docs/reference/rest/Shared.Types/LatLng. Wenn kein Paar aus Breiten- und Längengrad angegeben wird, wird die Standortbestimmung anhand des exif-Headers verwendet.Photo Wenn Fotos nicht im Breiten- und Längengrad angegeben werden, kann das nicht passieren.
altitude

number

Höhe der Pose in Metern über dem WGS84-Ellipsoid. NaN gibt eine nicht gemessene Menge an.
heading

number

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

number

Tonhöhe, gemessen in der Mitte des Fotos in Grad. Wert muss >=-90 und <= 90 sein. Ein Wert von -90 bedeutet, dass der Blick direkt nach unten geht, und ein Wert von 90 bedeutet direkt nach oben blicken. NaN gibt eine nicht gemessene Menge an.
roll

number

Rolle, gemessen in Grad. Wert muss >= 0 und < 360 sein. Ein Wert von 0 bedeutet einen höheren Horizont. NaN gibt eine nicht gemessene Menge an.
gpsRecordTimestampUnixEpoch

string (Timestamp format)

Zeit des GPS-Eintrags seit UTC-Epoche.

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

object (Level)

Ebene (die Etage in einem Gebäude), die zur Konfiguration der vertikalen Navigation verwendet wird.
accuracyMeters

number

Die geschätzte horizontale Genauigkeit dieser Pose in Metern mit einem Konfidenzintervall von 68 % (eine Standardabweichung). Auf Android-Geräten ist dieser Wert beispielsweise über die folgende Methode verfügbar: https://developer.android.com/reference/android/location/Location#getAccuracy(). Andere Plattformen haben unterschiedliche Methoden zum Abrufen ähnlicher Genauigkeitsschätzungen.

LatLng

Ein Objekt, das ein Paar aus Breiten- und Längengrad darstellt. Es wird als Paar zweier Werte (Breiten- und Längengrad) ausgedrückt. Wenn 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.

Ebene

Informationen zur Ebene mit der entsprechenden Nummer und dem entsprechenden Namen

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

number

Optional. Etagennummer, die für die Bestellung verwendet wird. 0 gibt die Bodenebene an, 1 gibt die erste Ebene über dem Boden und -1 gibt die erste Ebene unter dem Boden an. Werte, die nicht als ganze Zahlen gelten, sind zulässig.
name

string

Erforderlich. Ein Name, der dieser Ebene zugewiesen ist und auf drei Zeichen beschränkt ist. Überlegen Sie, wie die Aufzugstasten für diese Ebene beschriftet wären, wenn es einen Aufzug geben würde.

Verbindung

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

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

object (PhotoId)

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

Ort

Platzieren Sie Metadaten für eine Entität.

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 Ortes, lokalisiert im Feld „languageCode“.
languageCode

string

Nur Ausgabe. Der "languageCode", mit dem der Name lokalisiert ist. Dies sollte der Sprachencode sein, der in der Anfrage angegeben wurde. Es kann sich aber auch um ein Fallback handeln.

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 gestartet, aber der Empfänger hat noch nicht geantwortet.
COMPLETED Die Übertragung des Fotos wurde abgeschlossen und das Foto wurde an den Empfänger übertragen.
REJECTED Der Empfänger hat diese Fotoübertragung abgelehnt.
EXPIRED Die Übertragung des Fotos ist abgelaufen, bevor der Empfänger eine Aktion ausgeführt hat.
CANCELLED Der Absender hat die Übertragung dieses Fotos abgebrochen.
RECEIVED_VIA_TRANSFER Der Empfänger ist aufgrund einer Rechteübertragung der Eigentümer des Fotos.

Status der Kartenveröffentlichung

Der 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 einem unbekannten Grund abgelehnt.

Methoden

create

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

delete

 Löscht eine Photo und ihre Metadaten

get

 Ruft die Metadaten des angegebenen Photo ab.

startUpload

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

update

 Aktualisiert die Metadaten einer Photo, z. B. Pose, Place Association, Verbindungen usw.