- HTTP-запрос
- Параметры запроса
- Тело запроса
- Тело ответа
- Области авторизации
- ФотоПоследовательность
- GPS-источник
- Иму
- Измерение3d
- Состояние обработки
- Причина сбоя обработки
- Сбой обработкиПодробности
- Недостаточный GPS-сбойПодробнее
- GpsDataGapFailureDetails
- ImuDataGapFailureПодробности
- NotOutdoorsFailureПодробности
- NoOverlapGpsFailureПодробнее
- LatLngГраницы
- Тип ввода
- Попробуйте!
После того, как клиент завершит загрузку PhotoSequence
с возвращенным UploadRef
, photoSequence.create
извлекает последовательность панорамных фотографий из видео или метаданных расширяемого устройства (XDM, http://www.xdm.org/ ) для публикации в Street View в Google. Карты.
photoSequence.create
возвращает Operation
с идентификатором PhotoSequence
, установленным в поле Operation.name
.
Этот метод возвращает следующие коды ошибок:
-
google.rpc.Code.INVALID_ARGUMENT
, если запрос имеет неверный формат. -
google.rpc.Code.NOT_FOUND
если ссылка на загрузку не существует.
HTTP-запрос
POST https://streetviewpublish.googleapis.com/v1/photoSequence
URL-адрес использует синтаксис транскодирования gRPC .
Параметры запроса
Параметры | |
---|---|
inputType | Необходимый. Форма ввода |
Тело запроса
Тело запроса содержит экземпляр PhotoSequence
.
Тело ответа
В случае успеха тело ответа содержит вновь созданный экземпляр Operation
.
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/streetviewpublish
Дополнительную информацию см. в обзоре OAuth 2.0 .
Фотопоследовательность
Последовательность из панорамных фотографий с метаданными.
JSON-представление |
---|
{ "id": string, "photos": [ { object ( |
Поля | |
---|---|
id | Только вывод. Уникальный идентификатор серии фотографий. Он также действует как идентификатор длительной операции, если загрузка выполняется асинхронно. |
photos[] | Только вывод. Фотографии с увеличивающимися временными метками. |
uploadReference | Только ввод. Требуется при создании фоторяда. Имя ресурса, куда загружаются байты серии фотографий (в виде видео). |
captureTimeOverride | Необязательный. Абсолютное время, когда начинается съемка серии фотографий. Если серия фотографий представляет собой видео, это время начала видео. Если это поле заполнено во входных данных, оно переопределяет время захвата в видео или файле XDM. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
uploadTime | Только вывод. Время создания этой серии фотографий в сервисе uSV Store. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
rawGpsTimeline[] | Только ввод. Необработанные измерения GPS с увеличивающимися временными метками с устройства, которые не синхронизированы по времени с каждой фотографией. Эти необработанные измерения будут использоваться для определения позы каждого кадра. Требуется во входных данных, когда Тип ввода — ВИДЕО и необработанные измерения GPS не находятся в дорожке метаданных движения камеры (CAMM). Пользователь может указать, что имеет приоритет, используя gpsSource, если необработанные измерения GPS предоставляются как в rawGpsTimeline, так и в треке метаданных движения камеры (CAMM). |
gpsSource | Только ввод. Если и rawGpsTimeline, и трек метаданных движения камеры (CAMM) содержат измерения GPS, укажите, какие из них имеют приоритет. |
imu | Только ввод. Трехосные данные IMU для коллекции. Если эти данные слишком велики для размещения в запросе, их следует поместить в дорожку CAMM для видео. Эти данные всегда имеют приоритет над эквивалентными данными CAMM, если они существуют. |
processingState | Только вывод. Состояние обработки этой последовательности. |
failureReason | Только вывод. Если эта последовательность имеет ProcessingState = FAILED, это будет содержать причину, по которой она не удалась. Если в поле ProcessingState указано любое другое значение, это поле будет не установлено. |
failureDetails | Только вывод. Если для этой последовательности установлен |
distanceMeters | Только вывод. Вычисленное расстояние до серии фотографий в метрах. |
sequenceBounds | Только вывод. Прямоугольная коробка, в которой заключены все изображения в этой серии фотографий. |
viewCount | Только вывод. Общее количество просмотров, полученных всеми опубликованными изображениями в этой PhotoSequence. |
filename | Только вывод. Имя файла загрузки. Не включает путь к каталогу. Доступно только в том случае, если эпизод был загружен на платформу, предоставляющую имя файла. |
GPSИсточник
Основной источник измерений GPS.
Перечисления | |
---|---|
PHOTO_SEQUENCE | GPS в rawGpsTimeline имеет приоритет, если он существует. |
CAMERA_MOTION_METADATA_TRACK | GPS в отслеживании метаданных движения камеры (CAMM) имеет приоритет, если он существует. |
Иму
Данные IMU от датчиков устройства.
JSON-представление |
---|
{ "accelMpsps": [ { object ( |
Поля | |
---|---|
accelMpsps[] | Измерения акселерометра в метрах/сек^2 с увеличением меток времени от устройств. |
gyroRps[] | Измерения гироскопа в радианах/сек с увеличением меток времени от устройств. |
magUt[] | Магнитометрические измерения магнитного поля в микротеслах (мкТл) с увеличением временных меток от приборов. |
Измерение3d
Общий образец 3D-измерений.
JSON-представление |
---|
{ "captureTime": string, "x": number, "y": number, "z": number } |
Поля | |
---|---|
captureTime | Временная метка измерения IMU. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
x | Измерение датчика по оси X. |
y | Измерение датчика по оси Y. |
z | Измерение датчика по оси z. |
Состояние обработки
Состояние обработки последовательности. Государства действуют следующим образом:
+-------------------------+
| |
+---v---+ +----------+ +----+----+
|PENDING+-->PROCESSING+-->PROCESSED|
+---+---+ +----+-----+ +----+----+
| | |
| +--v---+ |
+-------->FAILED<---------+
+------+
Последовательность может перейти в состояние FAILED из любого состояния. Кроме того, обработанная последовательность может быть повторно обработана в любое время.
Перечисления | |
---|---|
PROCESSING_STATE_UNSPECIFIED | Состояние не указано, это значение по умолчанию. |
PENDING | Последовательность еще не начала обработку. |
PROCESSING | Последовательность в настоящее время находится в обработке. |
PROCESSED | Последовательность завершила обработку, включая уточнение позиции. |
FAILED | Последовательность не удалось обработать. Дополнительные сведения см. в разделе «Причина сбоя». |
Причина сбоя обработки
Возможные причины, по которым PhotoSequence
не удалось обработать.
Перечисления | |
---|---|
PROCESSING_FAILURE_REASON_UNSPECIFIED | Причина сбоя не указана, это значение по умолчанию. |
LOW_RESOLUTION | Разрешение видеокадра слишком маленькое. |
DUPLICATE | Это видео уже было загружено ранее. |
INSUFFICIENT_GPS | Слишком мало точек GPS. |
NO_OVERLAP_GPS | Нет перекрытия между временными рамками GPS-трека и временными рамками видео. |
INVALID_GPS | GPS недействителен (например, все точки GPS находятся в (0,0)) |
FAILED_TO_REFINE_POSITIONS | Последовательность фотографий не удалось точно определить в мире. |
TAKEDOWN | Последовательность была удалена по политическим соображениям. |
CORRUPT_VIDEO | Видеофайл поврежден или не может быть декодирован. |
INTERNAL | Произошёл постоянный сбой в базовой системе. |
INVALID_VIDEO_FORMAT | Формат видео недействителен или не поддерживается. |
INVALID_VIDEO_DIMENSIONS | Обнаружено неверное соотношение сторон изображения. |
INVALID_CAPTURE_TIME | Недопустимое время захвата. Временные метки были из будущего. |
GPS_DATA_GAP | Данные GPS содержат разрыв длительностью более 5 секунд. |
JUMPY_GPS | Данные GPS слишком нестабильны для обработки. |
INVALID_IMU | Данные IMU (акселерометра, гироскопа и т. д.) недействительны. В них могут отсутствовать обязательные поля (x, y, z или время), они могут быть неправильно отформатированы или иметь любую другую проблему, которая не позволяет нашим системам проанализировать их. |
INSUFFICIENT_IMU | Слишком мало очков IMU. |
INSUFFICIENT_OVERLAP_TIME_SERIES | Недостаточное перекрытие во временных рамках между данными GPS, IMU и другими временными рядами. |
IMU_DATA_GAP | Данные IMU (акселерометра, гироскопа и т. д.) содержат промежутки длительностью более 0,1 секунды. |
UNSUPPORTED_CAMERA | Камера не поддерживается. |
NOT_OUTDOORS | Некоторые кадры были в помещении, что не поддерживается. |
INSUFFICIENT_VIDEO_FRAMES | Недостаточно видеокадров. |
INSUFFICIENT_MOVEMENT | Недостаточно движущихся данных. |
Сбой обработкиПодробности
Дополнительные сведения, сопровождающие перечисление ProcessingFailureReason. Ожидается, что это сообщение всегда будет использоваться вместе с ProcessingFailureReason, и значение oneof, установленное в этом сообщении, должно соответствовать FailureReason.
JSON-представление |
---|
{ // Union field |
Поля | |
---|---|
details поля объединения. Будет установлен только один набор сведений, который должен соответствовать соответствующему перечислению в ProcessingFailureReason. details могут быть только одним из следующих: | |
insufficientGpsDetails | См. сведения о недостаточном GpsFailureDetails. |
gpsDataGapDetails | См. раздел GpsDataGapFailureDetails. |
imuDataGapDetails | См. ImuDataGapFailureDetails. |
notOutdoorsDetails | См. раздел NotOutdoorsFailureDetails. |
noOverlapGpsDetails | См. раздел NoOverlapGpsFailureDetails. |
Недостаточный GPS-сбойПодробнее
Подробности, связанные с ProcessingFailureReason#INSUFFICIENT_GPS.
JSON-представление |
---|
{ "gpsPointsFound": integer } |
Поля | |
---|---|
gpsPointsFound | Количество GPS-точек, найденных на видео. |
GpsDataGapFailureDetails
Подробности, связанные с ProcessingFailureReason#GPS_DATA_GAP. Если имеется несколько пробелов в данных GPS, здесь указывается только тот, который имеет наибольшую продолжительность.
JSON-представление |
---|
{ "gapDuration": string, "gapStartTime": string } |
Поля | |
---|---|
gapDuration | Продолжительность обнаруженного пробела в данных GPS. Продолжительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « |
gapStartTime | Относительное время (от начала видеопотока), когда начался разрыв. Продолжительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « |
ImuDataGapFailureПодробности
Подробности, связанные с ProcessingFailureReason#IMU_DATA_GAP. Если имеется несколько пробелов в данных IMU, здесь сообщается только тот, который имеет наибольшую продолжительность.
JSON-представление |
---|
{ "gapDuration": string, "gapStartTime": string } |
Поля | |
---|---|
gapDuration | Продолжительность обнаруженного пробела в данных IMU. Продолжительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « |
gapStartTime | Относительное время (от начала видеопотока), когда начался разрыв. Продолжительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « |
NotOutdoorsFailureПодробности
Подробности, связанные с ProcessingFailureReason#NOT_OUTDOORS. Если обнаружено несколько внутренних кадров, здесь записывается первый кадр.
JSON-представление |
---|
{ "startTime": string } |
Поля | |
---|---|
startTime | Относительное время (от начала видеопотока), когда был найден внутренний кадр. Продолжительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « |
NoOverlapGpsFailureПодробнее
Подробности, связанные с PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS.
JSON-представление |
---|
{ "gpsStartTime": string, "gpsEndTime": string, "videoStartTime": string, "videoEndTime": string } |
Поля | |
---|---|
gpsStartTime | Время первой записанной точки GPS. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
gpsEndTime | Время последней записанной точки GPS. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
videoStartTime | Время начала видео. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
videoEndTime | Время окончания видео. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
LatLngГраницы
Прямоугольник в географических координатах.
JSON-представление |
---|
{ "southwest": { object ( |
Поля | |
---|---|
southwest | Юго-западный угол этих границ. |
northeast | Северо-восточный угол этих границ. |
Тип ввода
Формы ввода PhotoSequence
.
Перечисления | |
---|---|
INPUT_TYPE_UNSPECIFIED | Не указан. Сервер вернет google.rpc.Code.INVALID_ARGUMENT . |
VIDEO | 360 Видео. |
XDM | Расширяемые метаданные устройства, http://www.xdm.org. |