- HTTP-Anfrage
- Suchparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- PhotoSequence
- GpsSource
- Imu
- Measurement3d
- ProcessingState
- ProcessingFailureReason
- ProcessingFailureDetails
- InsufficientGpsFailureDetails
- GpsDataGapFailureDetails
- ImuDataGapFailureDetails
- NotOutdoorsFailureDetails
- NoOverlapGpsFailureDetails
- LatLngBounds
- InputType
- Testen!
Nachdem der Client das Hochladen von PhotoSequence
mit der zurückgegebenen UploadRef
abgeschlossen hat, extrahiert photoSequence.create
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.
photoSequence.create
gibt ein Operation
zurück, wobei die PhotoSequence
-ID im Feld Operation.name
festgelegt ist.
Diese Methode gibt die folgenden Fehlercodes zurück:
google.rpc.Code.INVALID_ARGUMENT
, wenn die Anfrage fehlerhaft ist.google.rpc.Code.NOT_FOUND
, wenn die Uploadreferenz nicht vorhanden ist.
HTTP-Anfrage
POST https://streetviewpublish.googleapis.com/v1/photoSequence
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
Parameter | |
---|---|
inputType |
Erforderlich. Das Eingabeformat von |
Anfragetext
Der Anfragetext enthält eine Instanz von PhotoSequence
.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Operation
.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/streetviewpublish
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
PhotoSequence
Eine Abfolge von 360°-Fotos mit Metadaten.
JSON-Darstellung |
---|
{ "id": string, "photos": [ { object ( |
Felder | |
---|---|
id |
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[] |
Nur Ausgabe Fotos mit zunehmenden Zeitstempeln |
uploadReference |
Nur Eingabe. Erforderlich beim Erstellen einer Fotosequenz. Der Ressourcenname, in den die Bytes der Fotosequenz (in Form eines Videos) hochgeladen werden. |
captureTimeOverride |
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. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
uploadTime |
Nur Ausgabe Der Zeitpunkt, zu dem diese Fotosequenz im uSV-Store-Dienst erstellt wurde. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
rawGpsTimeline[] |
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 gpsSource angeben, was Vorrang hat, wenn GPS-Rohmessungen sowohl in rawGpsTimeline als auch in CAMM (Camera Motion Metadata Track) bereitgestellt werden. |
gpsSource |
Nur Eingabe. Wenn sowohl die rawGpsTimeline als auch der Kamerabewegungs-Metadatentrack (Camera Motion Metadata Track, CAMM) GPS-Messungen enthalten, geben Sie an, welche Priorität hat. |
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. |
processingState |
Nur Ausgabe Der Verarbeitungsstatus dieser Sequenz. |
failureReason |
Nur Ausgabe Wenn diese Sequenz „processingState“ = FAILED hat, enthält dies den Grund für den Fehler. Wenn der ProcessingState-Wert ein anderer Wert ist, wird dieses Feld nicht festgelegt. |
failureDetails |
Nur Ausgabe Wenn für diese Sequenz |
distanceMeters |
Nur Ausgabe Die berechnete Entfernung der Fotosequenz in Metern. |
sequenceBounds |
Nur Ausgabe Ein rechteckiges Feld, in dem jedes Bild in dieser Fotosequenz eingekapselt ist. |
viewCount |
Nur Ausgabe Die Gesamtzahl der Aufrufe, die alle veröffentlichten Bilder in dieser Fotosequenz erzielt haben. |
filename |
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 rawGpsTimeline hat Vorrang, sofern vorhanden. |
CAMERA_MOTION_METADATA_TRACK |
GPS im Kamera-Bewegungsmetadaten-Track (CAMM) hat Vorrang, sofern vorhanden. |
Imu
Die IMU-Daten von den Gerätesensoren.
JSON-Darstellung |
---|
{ "accelMpsps": [ { object ( |
Felder | |
---|---|
accelMpsps[] |
Die Messungen des Beschleunigungsmessers in Metern/s^2 mit zunehmenden Zeitstempeln von Geräten. |
gyroRps[] |
Die Messungen des Gyroskops in Radiant/s mit zunehmenden Zeitstempeln von Geräten. |
magUt[] |
Die Magnetometer-Messungen des Magnetfelds in Mikrotesla (uT) mit zunehmenden Zeitstempeln von Geräten. |
Messung 3D
Ein allgemeines 3D-Messbeispiel.
JSON-Darstellung |
---|
{ "captureTime": string, "x": number, "y": number, "z": number } |
Felder | |
---|---|
captureTime |
Zeitstempel der IMU-Messung. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
x |
Die Sensormessung auf der x-Achse. |
y |
Die Sensormessung auf der y-Achse. |
z |
Die Sensormessung auf der z-Achse. |
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“. |
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. |
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.
JSON-Darstellung |
---|
{ // Union field |
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: |
|
insufficientGpsDetails |
Siehe AccelerateGpsFailureDetails. |
gpsDataGapDetails |
Siehe GpsDataGapFailureDetails. |
imuDataGapDetails |
Siehe ImuDataGapFailureDetails. |
notOutdoorsDetails |
Siehe NotOutdoorsFailureDetails. |
noOverlapGpsDetails |
Siehe „NoOverlapGpsFailureDetails“. |
InsufficientGpsFailureDetails
Details zum ProcessingFailureReason#INSUFFICIENT_GPS.
JSON-Darstellung |
---|
{ "gpsPointsFound": integer } |
Felder | |
---|---|
gpsPointsFound |
Die Anzahl der GPS-Punkte, die im Video gefunden wurden. |
GpsDataGapFailureDetails
Details zum ProcessingFailureReason#GPS_DATA_GAP. Wenn es mehrere GPS-Datenlücken gibt, wird hier nur die mit der längsten Dauer gemeldet.
JSON-Darstellung |
---|
{ "gapDuration": string, "gapStartTime": string } |
Felder | |
---|---|
gapDuration |
Die Dauer der gefundenen Lücke in den GPS-Daten. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
gapStartTime |
Der relative Zeitraum (ab Beginn des Videostreams), zu dem die Lücke begann. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
ImuDataGapFailureDetails
Details zum ProcessingFailureReason#IMU_DATA_GAP Bei mehreren IMU-Datenlücken wird hier nur die mit der längsten Dauer erfasst.
JSON-Darstellung |
---|
{ "gapDuration": string, "gapStartTime": string } |
Felder | |
---|---|
gapDuration |
Die Dauer der gefundenen Lücke in den IMU-Daten. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
gapStartTime |
Der relative Zeitraum (ab Beginn des Videostreams), zu dem die Lücke begann. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
NotOutdoorsFailureDetails
Details zum ProcessingFailureReason#NOT_OUTDOORS Werden mehrere Frames für den Innenbereich gefunden, wird hier der erste Frame erfasst.
JSON-Darstellung |
---|
{ "startTime": string } |
Felder | |
---|---|
startTime |
Relativer Zeitraum (ab Beginn des Videostreams), zu dem ein Indoor-Frame gefunden wurde. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
NoOverlapGpsFailureDetails
Details zu PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS.
JSON-Darstellung |
---|
{ "gpsStartTime": string, "gpsEndTime": string, "videoStartTime": string, "videoEndTime": string } |
Felder | |
---|---|
gpsStartTime |
Zeitpunkt des ersten aufgezeichneten GPS-Punkts Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
gpsEndTime |
Zeitpunkt des zuletzt aufgezeichneten GPS-Punkts Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
videoStartTime |
Beginn des Videos. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
videoEndTime |
Endzeit des Videos. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
LatLngBounds
Ein Rechteck in geografischen Koordinaten.
JSON-Darstellung |
---|
{ "southwest": { object ( |
Felder | |
---|---|
southwest |
Die südwestliche Ecke dieser Grenzen. |
northeast |
Die nordöstliche Ecke dieser Grenzen. |
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 |