Package google.streetview.publish.v1

Index

StreetViewPublishService

Veröffentlicht und verbindet von Nutzern bereitgestellte Fotos in Street View.

BatchDeletePhotos

rpc BatchDeletePhotos(BatchDeletePhotosRequest) returns (BatchDeletePhotosResponse)

Löscht eine Liste mit Photos und ihren Metadaten.

Wenn BatchDeletePhotos fehlschlägt, fehlen entweder wichtige Felder oder es liegt ein Authentifizierungsfehler vor. Auch wenn BatchDeletePhotos erfolgreich ist, können bei einzelnen Fotos im Batch Fehler auftreten. Diese Fehler werden in jedem PhotoResponse.status in BatchDeletePhotosResponse.results angegeben. Unter DeletePhoto finden Sie Informationen zu spezifischen Fehlern, die pro 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. Auch wenn BatchGetPhotos erfolgreich ist, können bei einzelnen Fotos im Batch Fehler auftreten. Diese Fehler werden in jedem PhotoResponse.status in BatchGetPhotosResponse.results angegeben. Unter GetPhoto finden Sie Informationen zu spezifischen Fehlern, die pro 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 oder Verbindungen. Das Ändern der Pixel von Fotos wird nicht unterstützt.

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

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

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

Hinweis: Zum Aktualisieren von Pose.altitude muss auch Pose.latLngPair ausgefüllt sein. 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 Kunde das Foto mit der zurückgegebenen UploadRef hochgeladen hat, veröffentlicht CreatePhoto das hochgeladene Photo in Street View auf Google Maps.

Derzeit ist es nur über die Photo Sphere-XMP-Metadaten in den Fotobytes möglich, um Überschriften, Pitch und Roll-Elemente in CreatePhoto festzulegen. CreatePhoto ignoriert die Felder pose.heading, pose.pitch, pose.roll, pose.altitude und pose.level in der Position.

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 das Hochladen von PhotoSequence mit der zurückgegebenen UploadRef abgeschlossen hat, extrahiert CreatePhotoSequence eine Folge von 360°-Fotos aus einem Video oder erweiterbaren Gerätemetadaten (Extensible Device Metadata, XDM, http://www.xdm.org/), um sie in Street View in Google Maps zu veröffentlichen.

CreatePhotoSequence gibt ein 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 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 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 Antworttypen zurück:

  • Operation.done = „false“, wenn die Verarbeitung von PhotoSequence noch nicht abgeschlossen ist.
  • Operation.done = „true“ und Operation.error ist ausgefüllt, wenn bei der Verarbeitung ein Fehler aufgetreten ist.
  • Operation.done = „true“ und Operation.response wird mit einer PhotoSequence-Nachricht abgefragt.

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 Zeitstempelreihenfolge in CreatePhotoSequence 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 zum Nutzer gehören.

Hinweis: Kürzlich erstellte Fotos, die noch indexiert werden, werden in der Antwort nicht 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 Upload von Fotosequenzdaten zu beginnen. Die Upload-URL der zurückgegebenen UploadRef wird verwendet, um die Daten für photoSequence hochzuladen.

Nach dem Upload wird die UploadRef mit CreatePhotoSequence verwendet, um den Objekteintrag PhotoSequence 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 Upload-Sitzung, um mit dem Hochladen von Fotobytes zu beginnen. Die Methode verwendet die Upload-URL der zurückgegebenen UploadRef, um die Byte für Photo hochzuladen.

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

Nachdem der Upload abgeschlossen ist, verwendet die Methode UploadRef mit CreatePhoto, um den Objekteintrag Photo 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 oder Verbindungen. Das Ändern der Pixel eines Fotos wird nicht unterstützt.

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

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 Löschen eines Batches von einem oder mehreren Photos.

Felder
status[]

Status

Der Status für den Vorgang zum Löschen eines einzelnen Photo in der Batchanfrage.

BatchGetPhotosRequest

Anfrage zum Abrufen eines oder mehrerer Photos. Standardmäßig

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

Parameter:

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

string

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

PhotoView

Erforderlich. Gibt an, ob eine Download-URL für die Fotobytes in der Fotoantwort 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 Batch-Abruf von Photos.

Felder
results[]

PhotoResponse

Liste der Ergebnisse für jeden einzelnen angeforderten Photo, in derselben Reihenfolge wie die Anfragen in BatchGetPhotos.

BatchUpdatePhotosRequest

Anfrage zur Aktualisierung der Metadaten von Fotos Das Aktualisieren der Pixel von Fotos wird nicht unterstützt.

Felder
update_photo_requests[]

UpdatePhotoRequest

Erforderlich. Liste mit UpdatePhotoRequests.

BatchUpdatePhotosResponse

Antwort auf die Batch-Aktualisierung von Metadaten eines oder mehrerer Photos.

Felder
results[]

PhotoResponse

Liste der Ergebnisse für jeden einzelnen Photo, der aktualisiert wurde, in derselben Reihenfolge wie die Anfrage.

Verbindung

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

Felder
target

PhotoId

Erforderlich. Das Ziel der Verbindung zwischen dem enthaltenen 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 Eingabeformat 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 Erweiterbare Gerätemetadaten, 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 Abrufen eines Photo.

Standardmäßig

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

Parameter:

  • view legt fest, 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 eine Download-URL für die Fotobytes in der Photo-Antwort 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 Abrufen eines PhotoSequence.

Standardmäßig

Parameter:

  • view legt fest, ob die Download-URL für 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 der einzelnen 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 zum ProcessingFailureReason#GPS_DATA_GAP. Wenn es mehrere GPS-Datenlücken gibt, wird hier nur die mit der längsten Dauer gemeldet.

Felder
gap_duration

Duration

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

Duration

Der relative Zeitraum (ab Beginn des Videostreams), zu dem die Lücke begann.

Imu

Die IMU-Daten von den Gerätesensoren.

Felder
accel_mpsps[]

Measurement3d

Die Messungen des Beschleunigungsmessers in Metern/s^2 mit zunehmenden Zeitstempeln von Geräten.
gyro_rps[]

Measurement3d

Die Messungen des Gyroskops in Radiant/s mit zunehmenden Zeitstempeln von Geräten.
mag_ut[]

Measurement3d

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

Messung 3D

Ein allgemeines 3D-Messbeispiel.

Felder
capture_time

Timestamp

Zeitstempel der IMU-Messung.
x

float

Die Sensormessung auf der x-Achse.
y

float

Die Sensormessung auf der y-Achse.
z

float

Die Sensormessung auf der z-Achse.

ImuDataGapFailureDetails

Details zum ProcessingFailureReason#IMU_DATA_GAP Bei mehreren IMU-Datenlücken wird hier nur die mit der längsten Dauer erfasst.

Felder
gap_duration

Duration

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

Duration

Der relative Zeitraum (ab Beginn des Videostreams), zu dem die Lücke begann.

InsufficientGpsFailureDetails

Details zum 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.

Ebene

Ebeneninformationen mit der Nummer der Stufe und dem zugehörigen Namen

Felder
number

double

Optional. Etagennummer, die für die Bestellung verwendet wird. 0 gibt die erste Ebene an, 1 die erste Ebene, -1 die erste Ebene. Werte, die keine ganzen Zahlen sind, sind zulässig.
name

string

Erforderlich. Ein Name, der dieser Stufe zugewiesen ist und auf 3 Zeichen beschränkt ist. Überlegen Sie, wie die Aufzugtasten für diese Ebene beschriftet wären, wenn es einen Fahrstuhl gäbe.

ListPhotoSequencesRequest

Anfrage zum Auflisten aller Fotosequenzen des Nutzers, der die Anfrage sendet.

Parameter:

  • pageSize legt die maximale Anzahl von Fotosequenzen fest, die zurückgegeben werden sollen.
  • pageToken ist der Tokenwert für die nächste Seite, der gegebenenfalls von einer vorherigen ListPhotoSequences-Anfrage zurückgegeben wurde.
Felder
page_size

int32

Optional. Die maximale Anzahl der Fotosequenzen, die zurückgegeben werden sollen. pageSize darf nicht negativ sein. Wenn pageSize null ist 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 wurde noch nicht implementiert, wird aber in Bearbeitung.
page_token

string

Optional. Der Wert nextPageToken, der gegebenenfalls von einer vorherigen ListPhotoSequences-Anfrage zurückgegeben wurde.
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. Dateinamensabfragen sollten als Wortgruppe gesendet werden, um mehrere Wörter und Sonderzeichen zu unterstützen, indem Anführungszeichen mit Escapezeichen hinzugefügt werden. Beispiel: filename_query="Beispiel einer Wortgruppe.mp4"

ListPhotoSequencesResponse

Antwort zur Auflistung aller Fotosequenzen, die 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 Status haben:

  • Operation.done = „false“, wenn die Verarbeitung von PhotoSequence noch nicht abgeschlossen ist.
  • Operation.done = „true“ und Operation.error ist 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 ausgefüllt.
next_page_token

string

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

ListPhotosRequest

Anfrage zur Auflistung aller Fotos des Nutzers, der die Anfrage sendet.

Standardmäßig

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

Parameter:

  • view legt fest, 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 Tokenwert für die nächste Seite, der gegebenenfalls von einer vorherigen ListPhotos-Anfrage zurückgegeben wurde.
  • filter ermöglicht das Filtern nach einem bestimmten Parameter. „placeId“ ist derzeit der einzige Parameter, der derzeit unterstützt wird.
Felder
view

PhotoView

Erforderlich. Gibt an, ob eine Download-URL für die Fotobyte in der Fotos-Antwort 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 ist 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 des Nutzers weniger als pageSize beträgt.
page_token

string

Optional. Der Wert nextPageToken, der gegebenenfalls von einer vorherigen ListPhotos-Anfrage zurückgegeben wurde.
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, die einem Nutzer gehören.

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 zuletzt aufgezeichneten GPS-Punkts
video_start_time

Timestamp

Beginn des Videos.
video_end_time

Timestamp

Endzeit des Videos.

NotOutdoorsFailureDetails

Details zum ProcessingFailureReason#NOT_OUTDOORS Werden mehrere Frames für den Innenbereich gefunden, wird hier der erste Frame erfasst.

Felder
start_time

Duration

Relativer Zeitraum (ab Beginn des Videostreams), zu dem ein Indoor-Frame gefunden wurde.

Foto

Mit „Foto“ werden 360°-Fotos zusammen mit Metadaten gespeichert.

Felder
photo_id

PhotoId

Erforderlich. Nur Ausgabe Erforderlich, wenn ein Foto aktualisiert wird. Ausgabe nur beim Erstellen eines Fotos. Kennung des Fotos, 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 Fotobyte 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 Miniaturansichts-URL zum Anzeigen einer Vorschau des jeweiligen Fotos.
pose

Pose

Optional. Zeigen Sie das Foto.
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, zu dem das Foto aufgenommen wurde. Wenn das Foto keinen exif-Zeitstempel hat, wird hiermit ein Zeitstempel in den Metadaten des Fotos festgelegt.
upload_time

Timestamp

Nur Ausgabe Zeitpunkt, zu dem das Bild hochgeladen wurde.
places[]

Place

Optional. Orte, zu denen dieses 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, ob das 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 eingeleitet, 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 Fotoübertragung ist abgelaufen, bevor der Empfänger eine Aktion ausgeführt hat.
CANCELLED Der Absender hat die Übertragung des Fotos abgebrochen.
RECEIVED_VIA_TRANSFER Der Empfänger ist aufgrund einer Rechteübertragung Eigentümer dieses Fotos.

PhotoId

Kennzeichnung für Photo.

Felder
id

string

Eine eindeutige Kennung für ein Foto.

PhotoResponse

Antwortnutzlast für eine einzelne Photo in Batchvorgängen, einschließlich BatchGetPhotos und BatchUpdatePhotos.

Felder
status

Status

Der Status für den Vorgang 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. Sie dient auch als ID für Vorgänge mit langer Ausführungszeit, wenn der Upload asynchron erfolgt.
photos[]

Photo

Nur Ausgabe Fotos mit zunehmenden Zeitstempeln
upload_reference

UploadRef

Nur Eingabe. Erforderlich beim Erstellen einer Fotosequenz. Der Ressourcenname, in den die Bytes der Fotosequenz (in Form eines Videos) hochgeladen werden.
capture_time_override

Timestamp

Optional. Absoluter Zeitpunkt, zu dem die Aufnahme der Fotosequenz beginnt. Wenn es sich bei der Fotosequenz um ein Video handelt, ist dies die Startzeit des Videos. Wenn dieses Feld in der Eingabe ausgefüllt ist, 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 des Geräts, die nicht mit jedem Foto synchronisiert werden. Diese Rohabmessungen werden verwendet, um die Position der einzelnen Frames abzuleiten. Erforderlich bei der Eingabe, wenn als InputType VIDEO angegeben ist und die GPS-Rohdaten nicht im Camera Motion Metadata Track (CAMM) enthalten sind. Der Nutzer kann mithilfe von gps_source angeben, was Vorrang hat, wenn GPS-Rohmessungen sowohl in raw_gps_timeline als auch in Camera Motion Metadata Track (CAMM) bereitgestellt werden.
gps_source

GpsSource

Nur Eingabe. Wenn sowohl raw_gps_timeline als auch die Kamerabewegungs-Metadatentrack (Camera Motion Metadata Track, CAMM) GPS-Messungen enthalten, geben Sie an, welche Priorität 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 für das Video aufgenommen 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 diese Sequenz „processing_state = FAILED“ hat, enthält dies den Grund für den Fehler. Wenn der Processing_state-Wert ein anderer Wert ist, wird dieses Feld nicht festgelegt.
failure_details

ProcessingFailureDetails

Nur Ausgabe Wenn für diese Sequenz failure_reason festgelegt ist, kann dies zusätzliche Details zum Fehler enthalten.
distance_meters

double

Nur Ausgabe Die berechnete Entfernung der Fotosequenz in Metern.
sequence_bounds

LatLngBounds

Nur Ausgabe Ein rechteckiges Feld, in dem jedes Bild in dieser Fotosequenz eingekapselt ist.
view_count

int64

Nur Ausgabe Die Gesamtzahl der Aufrufe, die alle veröffentlichten Bilder in dieser Fotosequenz erzielt haben.
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 enthält.

GpsSource

Primäre Quelle von GPS-Messungen.

Enums
PHOTO_SEQUENCE GPS in raw_gps_timeline hat Vorrang, sofern vorhanden.
CAMERA_MOTION_METADATA_TRACK GPS im Kamera-Bewegungsmetadaten-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

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

string

Nur Ausgabe Der Name des Ortes in der Sprache „language_code“.
language_code

string

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

Pose

Rohpositionsmessung für eine 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. Beim Erstellen von Photo wird die Standortbestimmung aus dem exif-Header verwendet, sofern kein Paar aus Breiten- und Längengrad angegeben ist. Ein Paar aus Breiten- und Längengrad, das nicht im Foto- oder EXIF-Header angegeben ist, führt zu einem Fehler beim Fotovorgang.
altitude

double

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

double

Die folgenden Posenparameter 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. Der 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. Der Wert muss >=-90 und <= 90 sein. Ein Wert von -90 bedeutet, direkt nach unten zu blicken, und ein Wert von 90, dass er direkt nach oben blickt. NaN steht für eine nicht gemessene Menge.
roll

double

Roll-Winkel in Grad (gemessen in Grad) Der Wert muss >= 0 und < 360 sein. Der Wert 0 bedeutet, dass sich der Horizont auf einer Höhe befindet. NaN steht für eine nicht gemessene Menge.
gps_record_timestamp_unix_epoch

Timestamp

Zeit des GPS-Eintrags seit der UTC-Epoche.
level

Level

Ebene (Etage eines Gebäudes), auf der die vertikale Navigation konfiguriert wird.
accuracy_meters

float

Die geschätzte horizontale Genauigkeit dieser Pose in Metern mit einer Zuverlässigkeit von 68 % (eine Standardabweichung). Auf Android-Geräten ist dieser Wert beispielsweise über die Methode https://developer.android.com/reference/android/location/Location#getAccuracy() verfügbar. Auf anderen Plattformen gibt es unterschiedliche Methoden, um ähnliche Genauigkeitsschätzungen zu erhalten.

ProcessingFailureDetails

Zusätzliche Details für die Aufzählung „ProcessingFailureReason“. Diese Nachricht wird immer in Verbindung mit ProcessingFailureReason verwendet und der Wert oneof, der in dieser Nachricht festgelegt ist, sollte mit FailureReason übereinstimmen.

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

InsufficientGpsFailureDetails

Siehe AccelerateGpsFailureDetails.
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 diese PhotoSequence nicht verarbeitet werden konnte.

Enums
PROCESSING_FAILURE_REASON_UNSPECIFIED Der Grund für den Fehler wurde nicht angegeben. Dies ist der Standardwert.
LOW_RESOLUTION Die Auflösung des Videoframes ist zu klein.
DUPLICATE Dieses Video wurde bereits hochgeladen.
INSUFFICIENT_GPS Zu wenige GPS-Punkte.
NO_OVERLAP_GPS Der Zeitrahmen des GPS-Tracks und der des Videos überschneiden sich nicht.
INVALID_GPS GPS ist ungültig (z.B. liegen alle GPS-Punkte bei (0,0))
FAILED_TO_REFINE_POSITIONS Die Reihenfolge der Fotos konnte nicht genau auf der Welt positioniert werden.
TAKEDOWN Die Sequenz wurde wegen Richtlinienverstößen entfernt.
CORRUPT_VIDEO Die Videodatei war 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 GPS-Daten enthalten eine Lücke von mehr als 5 Sekunden.
JUMPY_GPS Die GPS-Daten sind zu unregelmäßig, um verarbeitet zu werden.
INVALID_IMU IMU-Daten (Beschleunigungsmesser, Gyroskop usw.) sind ungültig. Möglicherweise fehlen Pflichtfelder (x, y, z oder Zeit), sie sind nicht richtig formatiert oder es liegt ein anderes Problem vor, das unsere Systeme daran hindert, sie zu parsen.
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 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 Es sind nicht genügend Videoframes vorhanden.
INSUFFICIENT_MOVEMENT Nicht genügend Daten zum Verschieben vorhanden.

ProcessingState

Der Verarbeitungsstatus der Sequenz. Die Bundesstaaten verschieben sich wie folgt:

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

Die Sequenz kann aus jedem Status zu FAILED wechseln. 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 ist abgeschlossen, einschließlich der Verfeinerung der Position.
FAILED Die Sequenz konnte nicht verarbeitet werden. 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 sind. 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 wiederholter Werte durch den neuen Inhalt ersetzt. Wenn updateMask beispielsweise 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 Uploadreferenz muss für jeden Nutzer eindeutig sein. Es hat das Format „https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}“.