Package google.streetview.publish.v1

Index

StreetViewPublishService

Hiermit werden von Nutzern bereitgestellte Fotos in Street View veröffentlicht und verknüpft.

BatchDeletePhotos

rpc BatchDeletePhotos(BatchDeletePhotosRequest) returns (BatchDeletePhotosResponse)

Löscht eine Liste von Photos und deren Metadaten.

Wenn BatchDeletePhotos fehlschlägt, fehlen entweder wichtige Felder oder es liegt ein Authentifizierungsfehler vor. Selbst wenn BatchDeletePhotos erfolgreich ist, kann es bei einzelnen Fotos im Batch zu Fehlern kommen. Diese Fehler werden in jedem PhotoResponse.status in BatchDeletePhotosResponse.results angegeben. Unter DeletePhoto finden Sie Informationen zu spezifischen Fehlern, die bei jedem Foto auftreten können.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/streetviewpublish

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

BatchGetPhotos

rpc BatchGetPhotos(BatchGetPhotosRequest) returns (BatchGetPhotosResponse)

Ruft die Metadaten des angegebenen Photo-Batches ab.

Wenn BatchGetPhotos fehlschlägt, fehlen entweder wichtige Felder oder es liegt ein Authentifizierungsfehler vor. Selbst wenn BatchGetPhotos erfolgreich ist, kann es bei einzelnen Fotos im Batch zu Fehlern kommen. Diese Fehler werden in jedem PhotoResponse.status in BatchGetPhotosResponse.results angegeben. Unter GetPhoto finden Sie Informationen zu spezifischen Fehlern, die bei jedem Foto auftreten können.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/streetviewpublish

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

BatchUpdatePhotos

rpc BatchUpdatePhotos(BatchUpdatePhotosRequest) returns (BatchUpdatePhotosResponse)

Aktualisiert die Metadaten von Photos, z. B. Pose, Ortsverknüpfung, Verbindungen usw. Das Ändern der Pixel von Fotos wird nicht unterstützt.

Wenn BatchUpdatePhotos fehlschlägt, fehlen entweder wichtige Felder oder es liegt ein Authentifizierungsfehler vor. Selbst wenn BatchUpdatePhotos erfolgreich ist, kann es bei einzelnen Fotos im Batch zu Fehlern kommen. Diese Fehler werden in jedem PhotoResponse.status in BatchUpdatePhotosResponse.results angegeben. Unter UpdatePhoto finden Sie Informationen zu spezifischen Fehlern, die bei jedem Foto auftreten können.

Es werden nur die im Feld updateMask angegebenen Felder verwendet. Wenn updateMask nicht vorhanden ist, gilt die Aktualisierung auf alle Felder.

Die Anzahl der UpdatePhotoRequest-Nachrichten in einer BatchUpdatePhotosRequest darf 20 nicht überschreiten.

Hinweis: Zum Aktualisieren von Pose.altitude muss auch Pose.latLngPair ausgefüllt werden. Andernfalls scheitert die Anfrage.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/streetviewpublish

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

CreatePhoto

rpc CreatePhoto(CreatePhotoRequest) returns (Photo)

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

Derzeit können in CreatePhoto nur über die Photo Sphere XMP-Metadaten in den Fotobytes eine Richtung, eine Verkaufspräsentation und ein Roll-Effekt festgelegt werden. CreatePhoto ignoriert die Felder pose.heading, pose.pitch, pose.roll, pose.altitude und pose.level in Pose.

Diese Methode gibt die folgenden Fehlercodes zurück:

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/streetviewpublish

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

CreatePhotoSequence

rpc CreatePhotoSequence(CreatePhotoSequenceRequest) returns (Operation)

Nachdem der Client den Upload von PhotoSequence mit dem zurückgegebenen UploadRef abgeschlossen hat, extrahiert CreatePhotoSequence eine Sequenz von 360°-Fotos aus einem Video oder aus Extensible Device Metadata (XDM, http://www.xdm.org/), die in Street View auf Google Maps veröffentlicht werden sollen.

CreatePhotoSequence gibt eine Operation zurück, wobei die PhotoSequence-ID im Feld Operation.name festgelegt ist.

Diese Methode gibt die folgenden Fehlercodes zurück:

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/streetviewpublish

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

DeletePhoto

rpc DeletePhoto(DeletePhotoRequest) returns (Empty)

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

Diese Methode gibt die folgenden Fehlercodes zurück:

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/streetviewpublish

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

DeletePhotoSequence

rpc DeletePhotoSequence(DeletePhotoSequenceRequest) returns (Empty)

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

Diese Methode gibt die folgenden Fehlercodes zurück:

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/streetviewpublish

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

GetPhoto

rpc GetPhoto(GetPhotoRequest) returns (Photo)

Ruft die Metadaten der angegebenen Photo ab.

Diese Methode gibt die folgenden Fehlercodes zurück:

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/streetviewpublish

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

GetPhotoSequence

rpc GetPhotoSequence(GetPhotoSequenceRequest) returns (Operation)

Ruft die Metadaten der angegebenen PhotoSequence über die Operation-Schnittstelle ab.

Diese Methode gibt die folgenden drei Arten von Antworten zurück:

  • Operation.done = falsch, wenn die Verarbeitung von PhotoSequence noch nicht abgeschlossen ist.
  • Operation.done = „true“ und Operation.error wird ausgefüllt, wenn bei der Verarbeitung ein Fehler aufgetreten ist.
  • Operation.done = „true“ und Operation.response wird erfasst, was eine PhotoSequence-Nachricht enthält.

Diese Methode gibt die folgenden Fehlercodes zurück:

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/streetviewpublish

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

ListPhotoSequences

rpc ListPhotoSequences(ListPhotoSequencesRequest) returns (ListPhotoSequencesResponse)

Listet alle PhotoSequences des Nutzers in absteigender Reihenfolge der CreatePhotoSequence-Zeitstempel in absteigender Reihenfolge auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/streetviewpublish

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

ListPhotos

rpc ListPhotos(ListPhotosRequest) returns (ListPhotosResponse)

Listet alle Photos auf, die dem Nutzer gehören.

Hinweis: Kürzlich erstellte Fotos, die noch indexiert werden, werden nicht in der Antwort zurückgegeben.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/streetviewpublish

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

StartPhotoSequenceUpload

rpc StartPhotoSequenceUpload(Empty) returns (UploadRef)

Erstellt eine Uploadsitzung, um mit dem Hochladen von Fotosequenzdaten zu beginnen. Die Upload-URL der zurückgegebenen UploadRef wird verwendet, um die Daten für die photoSequence hochzuladen.

Nach Abschluss des Uploads wird UploadRef mit CreatePhotoSequence verwendet, um den PhotoSequence-Objekteintrag zu erstellen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/streetviewpublish

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

StartUpload

rpc StartUpload(Empty) returns (UploadRef)

Erstellt eine Uploadsitzung, um mit dem Hochladen von Fotobytes zu beginnen. Die Methode verwendet die Upload-URL der zurückgegebenen UploadRef, um die Byte für die Photo hochzuladen.

Zusätzlich zu den unter https://support.google.com/maps/answer/7012050?ref_topic=6275604 aufgeführten Anforderungen an Fotos muss ein Foto die folgenden Anforderungen erfüllen:

Nach Abschluss des Uploads verwendet die Methode UploadRef mit CreatePhoto, um den Photo-Objekteintrag zu erstellen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/streetviewpublish

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

UpdatePhoto

rpc UpdatePhoto(UpdatePhotoRequest) returns (Photo)

Aktualisiert die Metadaten einer Photo, z. B. Pose, Ortsverknüpfung, Verbindungen usw. Das Ändern der Pixel eines Fotos wird nicht unterstützt.

Nur die im Feld updateMask angegebenen Felder werden verwendet. Wenn updateMask nicht vorhanden ist, gilt die Aktualisierung auf alle Felder.

Diese Methode gibt die folgenden Fehlercodes zurück:

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/streetviewpublish

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

BatchDeletePhotosRequest

Anfrage zum Löschen mehrerer Photos.

Felder
photo_ids[]

string

Erforderlich. IDs von Photos. HTTP GET-Anfragen erfordern die folgende Syntax für den URL-Suchparameter: photoIds=<id1>&photoIds=<id2>&....

BatchDeletePhotosResponse

Antwort auf das Batch-Löschen von einem oder mehreren Photos-Elementen.

Felder
status[]

Status

Der Status des Vorgangs zum Löschen einer einzelnen Photo in der Batchanfrage.

BatchGetPhotosRequest

Fordern Sie eine oder mehrere Photos an. Standardmäßig

  • gibt keine Download-URL für die Fotobytes zurück.

Parameter:

  • view steuert, ob die Download-URL für die Fotobytes zurückgegeben wird.
Felder
photo_ids[]

string

Erforderlich. IDs von Photos. Für HTTP-GET-Anfragen sollte der URL-Suchparameter photoIds=<id1>&photoIds=<id2>&... lauten.

view

PhotoView

Erforderlich. Gibt an, ob in der Fotoantwort eine Download-URL für die Fotobytes zurückgegeben werden soll.

language_code

string

Optional. 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 „language_code“ nicht angegeben ist, wird die Spracheinstellung des Nutzers für Google-Dienste verwendet.

BatchGetPhotosResponse

Antwort auf den Batch-Abruf von Photos.

Felder
results[]

PhotoResponse

Liste der Ergebnisse für jede einzelne angeforderte Photo, in derselben Reihenfolge wie die Anfragen in BatchGetPhotos.

BatchUpdatePhotosRequest

Anfrage zum Aktualisieren der Metadaten von Fotos Pixel von Fotos können nicht aktualisiert werden.

Felder
update_photo_requests[]

UpdatePhotoRequest

Erforderlich. Liste mit UpdatePhotoRequests.

BatchUpdatePhotosResponse

Antwort auf die Batch-Aktualisierung von Metadaten von einem oder mehreren Photos.

Felder
results[]

PhotoResponse

Liste der Ergebnisse für jede einzelne aktualisierte Photo in derselben Reihenfolge wie in der Anfrage.

Verbindung

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

Felder
target

PhotoId

Erforderlich. Das Ziel der Verbindung zwischen dem zugehörigen Foto und einem anderen Foto.

CreatePhotoRequest

Anfrage zum Erstellen eines Photo.

Felder
photo

Photo

Erforderlich. Zu erstellendes Foto.

CreatePhotoSequenceRequest

Anfrage zum Erstellen eines PhotoSequence aus einem Video

Felder
photo_sequence

PhotoSequence

Erforderlich. Zum Erstellen PhotoSequence.

input_type

InputType

Erforderlich. Das Eingabeformular von PhotoSequence.

InputType

Eingabeformen von PhotoSequence.

Enums
INPUT_TYPE_UNSPECIFIED Nicht angegeben. Der Server gibt google.rpc.Code.INVALID_ARGUMENT zurück.
VIDEO 360°-Video.
XDM Extensible Device Metadata, http://www.xdm.org

DeletePhotoRequest

Anfrage zum Löschen eines Photo.

Felder
photo_id

string

Erforderlich. ID von Photo.

DeletePhotoSequenceRequest

Anfrage zum Löschen eines PhotoSequence.

Felder
sequence_id

string

Erforderlich. ID von PhotoSequence.

GetPhotoRequest

Anfrage zum Erhalt von Photo

Standardmäßig

  • gibt keine Download-URL für die Fotobytes zurück.

Parameter:

  • view steuert, ob die Download-URL für die Fotobytes zurückgegeben wird.
Felder
photo_id

string

Erforderlich. ID von Photo.

view

PhotoView

Erforderlich. Gibt an, ob in der Photo-Antwort eine Download-URL für die Fotobytes zurückgegeben werden soll.

language_code

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 „language_code“ nicht angegeben ist, wird die Spracheinstellung des Nutzers für Google-Dienste verwendet.

GetPhotoSequenceRequest

Anfrage zum Erhalt von PhotoSequence

Standardmäßig

Parameter:

  • view steuert, ob die Download-URL für die PhotoSequence zurückgegeben wird.
Felder
sequence_id

string

Erforderlich. ID der Fotosequenz.

view
(deprecated)

PhotoView

Gibt an, ob eine Download-URL für die Fotosequenz in download_url einzelner Fotos in der PhotoSequence-Antwort zurückgegeben werden soll.

Hinweis: Derzeit nicht implementiert.

filter

string

Optional. Der Filterausdruck. Beispiel: published_status=PUBLISHED.

Folgende Filter werden unterstützt: published_status. Weitere Informationen finden Sie unter https://google.aip.dev/160.

GpsDataGapFailureDetails

Details zu ProcessingFailureReason#GPS_DATA_GAP. Wenn es mehrere GPS-Datenlücken gibt, wird hier nur die mit der längsten Dauer angezeigt.

Felder
gap_duration

Duration

Die Dauer der Lücke in den gefundenen GPS-Daten.

gap_start_time

Duration

Relative Zeit (ab Beginn des Videostreams), wann die Lücke begann.

Imu

IMU-Daten von den Gerätesensoren

Felder
accel_mpsps[]

Measurement3d

Die Messwerte des Beschleunigungsmessers in Metern/s^2 mit zunehmenden Zeitstempeln von Geräten.

gyro_rps[]

Measurement3d

Die Gyroskopwerte in Radiant/s mit zunehmenden Zeitstempeln von Geräten.

mag_ut[]

Measurement3d

Messungen des Magnetfelds in Mikrotesla (uT) mit zunehmenden Zeitstempeln von Geräten.

Messung3D

Ein generisches 3D-Messbeispiel.

Felder
capture_time

Timestamp

Der Zeitstempel der IMU-Messung.

x

float

Die Sensormessung auf der x-Achse.

y

float

Die Sensormessung auf der Y-Achse.

z

float

Die Sensormessung in der z-Achse.

ImuDataGapFailureDetails

Details in Bezug auf ProcessingFailureReason#IMU_DATA_GAP. Wenn es mehrere IMU-Datenlücken gibt, wird hier nur die mit der größten Dauer angegeben.

Felder
gap_duration

Duration

Die Dauer der gefundenen Lücke in den IMU-Daten.

gap_start_time

Duration

Relative Zeit (ab Beginn des Videostreams), wann die Lücke begann.

InsufficientGpsFailureDetails

Details in Bezug auf ProcessingFailureReason#INSUFFICIENT_GPS.

Felder
gps_points_found

int32

Die Anzahl der GPS-Punkte, die im Video gefunden wurden.

LatLngBounds

Ein Rechteck in geografischen Koordinaten.

Felder
southwest

LatLng

Die südwestliche Ecke dieser Grenzen.

northeast

LatLng

Die nordöstliche Ecke dieser Grenzen.

Level

Informationen zur Ebene, die die Nummer der Stufe und den entsprechenden Namen enthalten.

Felder
number

double

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.

ListPhotoSequencesRequest

Anfrage zum Auflisten aller Fotosequenzen des Nutzers, der die Anfrage gesendet hat.

Parameter:

  • pageSize bestimmt die maximale Anzahl von Fotosequenzen, die zurückgegeben werden sollen.
  • pageToken ist der Wert des nächsten Seitentokens, der von einer vorherigen ListPhotoSequences-Anfrage zurückgegeben wurde, falls vorhanden.
Felder
page_size

int32

Optional. Die maximale Anzahl der Fotosequenzen, die zurückgegeben werden sollen. pageSize darf nicht negativ sein. Wenn pageSize null oder nicht angegeben ist, wird die Standardseitengröße von 100 verwendet. Die Anzahl der in der Antwort zurückgegebenen Fotosequenzen kann kleiner als pageSize sein, wenn die Anzahl der Übereinstimmungen kleiner als pageSize ist. Diese Funktion wird derzeit noch nicht implementiert.

page_token

string

Optional. Der nextPageToken-Wert, der von einer vorherigen ListPhotoSequences-Anfrage zurückgegeben wurde, falls vorhanden.

filter

string

Optional. Der Filterausdruck. Beispiel: imagery_type=SPHERICAL.

Folgende Filter werden unterstützt: imagery_type, processing_state, min_latitude, max_latitude, min_longitude, max_longitude, filename_query, min_capture_time_seconds, `max_capture_time_seconds. Weitere Informationen finden Sie unter https://google.aip.dev/160. Dateinamenabfragen sollten als Phrase gesendet werden, um mehrere Wörter und Sonderzeichen durch Hinzufügen von Anführungszeichen in Escapezeichen zu unterstützen. Beispiel: filename_query="Beispiel für eine Wortgruppe.mp4"

ListPhotoSequencesResponse

Antwort, um alle Fotosequenzen aufzulisten, die zu einem Nutzer gehören.

Felder
photo_sequences[]

Operation

Liste der Fotosequenzen über die Operation-Schnittstelle.

Die maximale Anzahl der zurückgegebenen Elemente basiert auf dem Feld pageSize in der Anfrage.

Jedes Element in der Liste kann drei mögliche Status haben,

  • Operation.done = falsch, wenn die Verarbeitung von PhotoSequence noch nicht abgeschlossen ist.
  • Operation.done = „true“ und Operation.error wird ausgefüllt, wenn bei der Verarbeitung ein Fehler aufgetreten ist.
  • Operation.done = „true“ und Operation.response enthält eine PhotoSequence-Nachricht. In jeder Sequenz wird nur Id dargestellt.
next_page_token

string

Token zum Abrufen der nächsten Ergebnisseite. Leer, wenn keine weiteren Ergebnisse in der Liste vorhanden sind.

ListPhotosRequest

Anfrage senden, alle Fotos aufzulisten, die zu dem Nutzer gehören, der die Anfrage gesendet hat

Standardmäßig

  • gibt keine Download-URL für die Fotobytes zurück.

Parameter:

  • view steuert, ob die Download-URL für die Fotobytes zurückgegeben wird.
  • pageSize legt die maximale Anzahl von Fotos fest, die zurückgegeben werden sollen.
  • pageToken ist der Wert des nächsten Seitentokens, der von einer vorherigen ListPhotos-Anfrage zurückgegeben wurde, falls vorhanden.
  • filter ermöglicht das Filtern nach einem bestimmten Parameter. „placeId“ ist derzeit der einzige unterstützte Parameter.
Felder
view

PhotoView

Erforderlich. Gibt an, ob in der Google Fotos-Antwort eine Download-URL für die Fotobytes zurückgegeben werden soll.

page_size

int32

Optional. Die maximale Anzahl der Fotos, die zurückgegeben werden sollen. pageSize darf nicht negativ sein. Wenn pageSize null oder nicht angegeben ist, wird die Standardseitengröße von 100 verwendet. Die Anzahl der in der Antwort zurückgegebenen Fotos kann kleiner als pageSize sein, wenn die Anzahl der Fotos, die dem Nutzer gehören, kleiner als pageSize ist.

page_token

string

Optional. Der nextPageToken-Wert, der von einer vorherigen ListPhotos-Anfrage zurückgegeben wurde, falls vorhanden.

filter

string

Optional. Der Filterausdruck. Beispiel: placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw.

Folgende Filter werden unterstützt: placeId, min_latitude, max_latitude, min_longitude, max_longitude. Weitere Informationen finden Sie unter https://google.aip.dev/160.

language_code

string

Optional. 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 „language_code“ nicht angegeben ist, wird die Spracheinstellung des Nutzers für Google-Dienste verwendet.

ListPhotosResponse

Antwort auf eine Liste aller Fotos eines Nutzers

Felder
photos[]

Photo

Liste der Fotos. Das Feld pageSize in der Anfrage bestimmt die Anzahl der zurückgegebenen Elemente.

next_page_token

string

Token zum Abrufen der nächsten Ergebnisseite. Leer, wenn keine weiteren Ergebnisse in der Liste vorhanden sind.

NoOverlapGpsFailureDetails

Details zu PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS

Felder
gps_start_time

Timestamp

Zeitpunkt des ersten aufgezeichneten GPS-Punkts

gps_end_time

Timestamp

Zeitpunkt des letzten aufgezeichneten GPS-Punkts.

video_start_time

Timestamp

Startzeit des Videos.

video_end_time

Timestamp

Endzeit des Videos.

NotOutdoorsFailureDetails

Details in Bezug auf ProcessingFailureReason#NOT_OUTDOORS Wenn mehrere Frames in Innenräumen gefunden werden, wird hier der erste Frame aufgezeichnet.

Felder
start_time

Duration

Relative Zeit (ab Beginn des Videostreams), während der ein Indoor-Frame gefunden wurde.

Foto

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

Felder
photo_id

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.

upload_reference

UploadRef

Nur Eingabe. Erforderlich beim Erstellen eines Fotos. Nur Eingabe. Die Ressourcen-URL, in die die Fotobytes hochgeladen werden.

download_url

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.

thumbnail_url

string

Nur Ausgabe. Die URL der Miniaturansicht zur Anzeige einer Vorschau des jeweiligen Fotos.

pose

Pose

Optional. Position des Fotos.

connections[]

Connection

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

capture_time

Timestamp

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

upload_time

Timestamp

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

places[]

Place

Optional. Orte, zu denen das Foto gehört

view_count

int64

Nur Ausgabe. Anzahl der Aufrufe des Fotos.

transfer_status

TransferStatus

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

maps_publish_status

MapsPublishStatus

Nur Ausgabe. Status in Google Maps, der angibt, ob dieses Foto veröffentlicht oder abgelehnt wurde.

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.

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.

PhotoId

ID für Photo.

Felder
id

string

Eine eindeutige Kennung für ein Foto.

PhotoResponse

Antwortnutzlast für eine einzelne Photo in Batchvorgängen wie BatchGetPhotos und BatchUpdatePhotos.

Felder
status

Status

Der Status des Vorgangs zum Abrufen oder Aktualisieren eines einzelnen Fotos in der Batchanfrage.

photo

Photo

Die Ressource Photo, wenn die Anfrage erfolgreich war.

PhotoSequence

Eine Abfolge von 360°-Fotos mit Metadaten.

Felder
id

string

Nur Ausgabe. Eindeutige Kennung für die Fotosequenz. Dies fungiert auch als eine Vorgangs-ID mit langer Ausführungszeit, wenn der Upload asynchron durchgeführt wird.

photos[]

Photo

Nur Ausgabe. Fotos mit zunehmenden Zeitstempeln.

upload_reference

UploadRef

Nur Eingabe. Erforderlich beim Erstellen von Fotosequenzen. Der Name der Ressource, in die die Byte der Fotosequenz (in Form eines Videos) hochgeladen werden.

capture_time_override

Timestamp

Optional. Absoluter Zeitpunkt, zu dem die Aufnahme der Fotosequenz beginnt. Wenn die Fotosequenz ein Video ist, ist dies die Startzeit des Videos. Wenn dieses Feld in der Eingabe ausgefüllt wird, wird die Erfassungszeit in der Video- oder XDM-Datei überschrieben.

upload_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem diese Fotosequenz im uSV Store-Dienst erstellt wurde.

raw_gps_timeline[]

Pose

Nur Eingabe. GPS-Rohdaten mit zunehmenden Zeitstempeln vom Gerät, die nicht zeitgleich mit jedem Foto synchronisiert sind. Diese Rohdaten werden verwendet, um die Position jedes Frames abzuleiten. Eingabe erforderlich, wenn der InputType VIDEO ist und GPS-Rohdaten nicht im CAMM-Metadatentrack (Camera Motion Metadata Track) enthalten sind. Nutzer können mithilfe von gps_source angeben, welche GPS-Rohdaten sowohl in raw_gps_timeline als auch in CAMM (Camera Motion Metadata Track) bereitgestellt werden.

gps_source

GpsSource

Nur Eingabe. Wenn sowohl raw_gps_timeline als auch der Camera Motion Metadata Track (CAMM) GPS-Messungen enthalten, geben Sie an, was Vorrang hat.

imu

Imu

Nur Eingabe. Dreiachsige IMU-Daten für die Sammlung. Wenn diese Daten zu groß für die Anfrage sind, sollten sie in den CAMM-Track des Videos eingefügt werden. Diese Daten haben immer Vorrang vor den entsprechenden CAMM-Daten, sofern vorhanden.

processing_state

ProcessingState

Nur Ausgabe. Der Verarbeitungsstatus dieser Sequenz.

failure_reason

ProcessingFailureReason

Nur Ausgabe. Wenn für diese Sequenz „processing_state“ = FAILED gilt, enthält dieses Feld den Grund für den Fehler. Ist „processing_state“ ein anderer Wert, wird dieses Feld nicht festgelegt.

failure_details

ProcessingFailureDetails

Nur Ausgabe. Wenn für diese Sequenz failure_reason festgelegt ist, können darin zusätzliche Details zum Fehler enthalten sein.

distance_meters

double

Nur Ausgabe. Die berechnete Entfernung der Fotosequenz in Metern.

sequence_bounds

LatLngBounds

Nur Ausgabe. Ein rechteckiges Feld, das jedes Bild in dieser Fotosequenz enthält.

view_count

int64

Nur Ausgabe. Die Gesamtzahl der Aufrufe, die alle veröffentlichten Bilder in dieser PhotoSequence gesendet wurden.

filename

string

Nur Ausgabe. Der Dateiname des Uploads. Enthält nicht den Verzeichnispfad. Nur verfügbar, wenn die Sequenz auf eine Plattform hochgeladen wurde, die den Dateinamen bereitstellt.

GpsSource

Primäre Quelle für GPS-Messungen.

Enums
PHOTO_SEQUENCE GPS in raw_gps_timeline hat Vorrang, sofern vorhanden.
CAMERA_MOTION_METADATA_TRACK GPS im Camera Motion Metadata Track (CAMM) hat Vorrang, sofern vorhanden.

PhotoView

Gibt an, welche Ansicht von Photo in die Antwort aufgenommen werden soll.

Enums
BASIC Die Serverantworten enthalten nicht die Download-URL für die Fotobytes. Der Standardwert.
INCLUDE_DOWNLOAD_URL Serverantworten enthalten die Download-URL für die Fotobytes.

Ort

Ortsmetadaten für eine Entität.

Felder
place_id

string

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

name

string

Nur Ausgabe. Der Name des Orts, lokalisiert in „language_code“.

language_code

string

Nur Ausgabe. Der language_code, mit dem der Name lokalisiert wird. Dies sollte dem in der Anfrage angegebenen „language_code“ entsprechen, kann aber auch ein Fallback sein.

Position

Raw-Pose-Messung einer Entität.

Felder
lat_lng_pair

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

double

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

heading

double

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

double

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

double

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.

gps_record_timestamp_unix_epoch

Timestamp

Zeitpunkt des GPS-Eintrags seit der UTC-Epoche.

level

Level

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

accuracy_meters

float

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.

ProcessingFailureDetails

Zusätzliche Details für den Enum-Wert „ProcessingFailureReason“. Diese Meldung wird immer in Verbindung mit „ProcessingFailureReason“ verwendet. Der in dieser Meldung festgelegte Wert sollte mit „FailureReason“ übereinstimmen.

Felder
Union-Feld details. Es wird nur ein Detailsatz festgelegt, der mit der entsprechenden Enum in ProcessingFailureReason übereinstimmen muss. Für details ist nur einer der folgenden Werte zulässig:
insufficient_gps_details

InsufficientGpsFailureDetails

Weitere Informationen finden Sie unter „UnzureichendeGpsFailureDetails“.

gps_data_gap_details

GpsDataGapFailureDetails

Siehe GpsDataGapFailureDetails.

imu_data_gap_details

ImuDataGapFailureDetails

Siehe ImuDataGapFailureDetails.

not_outdoors_details

NotOutdoorsFailureDetails

Siehe NotOutdoorsFailureDetails.

no_overlap_gps_details

NoOverlapGpsFailureDetails

Siehe NoOverlapGpsFailureDetails.

ProcessingFailureReason

Mögliche Gründe, warum PhotoSequence nicht verarbeitet werden konnte.

Enums
PROCESSING_FAILURE_REASON_UNSPECIFIED Die Fehlerursache ist nicht angegeben. Dies ist der Standardwert.
LOW_RESOLUTION Die Auflösung des Videoframes ist zu gering.
DUPLICATE Dieses Video wurde schon einmal hochgeladen.
INSUFFICIENT_GPS Zu wenige GPS-Punkte
NO_OVERLAP_GPS Keine Überschneidung zwischen dem Zeitrahmen des GPS-Tracks und dem Zeitrahmen des Videos.
INVALID_GPS GPS ist ungültig (z.B. befinden sich alle GPS-Punkte bei (0,0))
FAILED_TO_REFINE_POSITIONS Die Sequenz der Fotos konnte nicht genau auf der Welt positioniert werden.
TAKEDOWN Die Sequenz wurde aufgrund von Richtlinienverstößen entfernt.
CORRUPT_VIDEO Die Videodatei ist beschädigt oder konnte nicht decodiert werden.
INTERNAL Im zugrunde liegenden System ist ein dauerhafter Fehler aufgetreten.
INVALID_VIDEO_FORMAT Das Videoformat ist ungültig oder wird nicht unterstützt.
INVALID_VIDEO_DIMENSIONS Ungültiges Bildseitenverhältnis gefunden.
INVALID_CAPTURE_TIME Ungültige Aufnahmezeit. Die Zeitstempel stammen aus der Zukunft.
GPS_DATA_GAP Die GPS-Daten weisen eine Lücke von mehr als 5 Sekunden auf.
JUMPY_GPS GPS-Daten sind zu ungenau, um verarbeitet zu werden.
INVALID_IMU IMU-Daten (Beschleunigungsmesser, Gyroskop usw.) sind ungültig. Möglicherweise fehlen Pflichtfelder (x, y, z oder Zeit), sind nicht richtig formatiert oder andere Probleme, die das Parsen durch unsere Systeme verhindern.
INSUFFICIENT_IMU Zu wenige IMU-Punkte
INSUFFICIENT_OVERLAP_TIME_SERIES Unzureichende Überschneidung im Zeitraum zwischen GPS-, IMU- und anderen Zeitreihendaten.
IMU_DATA_GAP IMU-Daten (Beschleunigungsmesser, Gyroskop usw.) enthalten Lücken von einer Dauer von mehr als 0, 1 Sekunden.
UNSUPPORTED_CAMERA Die Kamera wird nicht unterstützt.
NOT_OUTDOORS Einige Frames befanden sich in Innenräumen. Dies wird nicht unterstützt.
INSUFFICIENT_VIDEO_FRAMES Nicht genügend Videoframes vorhanden.
INSUFFICIENT_MOVEMENT Die zu verschiebenden Daten reichen nicht aus.

ProcessingState

Der Verarbeitungsstatus der Sequenz. Die Status bewegen sich wie folgt:

     +-------------------------+
     |                         |
 +---v---+  +----------+  +----+----+
 |PENDING+-->PROCESSING+-->PROCESSED|
 +---+---+  +----+-----+  +----+----+
     |           |             |
     |        +--v---+         |
     +-------->FAILED<---------+
              +------+

Die Sequenz kann aus jedem Status in den Status FAILED gesetzt werden. Außerdem kann eine verarbeitete Sequenz jederzeit noch einmal verarbeitet werden.

Enums
PROCESSING_STATE_UNSPECIFIED Der Status ist nicht angegeben. Dies ist der Standardwert.
PENDING Die Verarbeitung der Sequenz wurde noch nicht gestartet.
PROCESSING Die Sequenz wird gerade verarbeitet.
PROCESSED Die Verarbeitung der Sequenz, einschließlich der Verfeinerung der Position, ist abgeschlossen.
FAILED Die Verarbeitung der Sequenz ist fehlgeschlagen. Weitere Informationen finden Sie unter FailureReason.

UpdatePhotoRequest

Anfrage zum Aktualisieren der Metadaten eines Photo. Das Aktualisieren der Pixel eines Fotos wird nicht unterstützt.

Felder
photo

Photo

Erforderlich. Photo-Objekt, das die neuen Metadaten enthält.

update_mask

FieldMask

Erforderlich. Maske, die Felder in den Fotometadaten identifiziert, die aktualisiert werden sollen. Falls nicht vorhanden, werden die alten Photo-Metadaten in dieser Anfrage vollständig durch die neuen Photo-Metadaten ersetzt. Die Aktualisierung schlägt fehl, wenn ungültige Felder angegeben werden. In einer durch Kommas getrennten Liste können mehrere Felder angegeben werden.

Die folgenden Felder sind gültig:

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

Hinweis: Wenn updateMask wiederkehrende Felder enthält, wird der gesamte Satz wiederkehrender Werte durch den neuen Inhalt ersetzt. Wenn beispielsweise updateMask connections enthält und UpdatePhotoRequest.photo.connections leer ist, werden alle Verbindungen entfernt.

UploadRef

Referenz für Mediendateien hochladen

Felder
Union-Feld file_source Erforderlich. Für file_source ist nur einer der folgenden Werte zulässig:
upload_url

string

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