Package google.streetview.publish.v1

Индекс

StreetViewPublishService

Публикует и объединяет фотографии, предоставленные пользователями, в Просмотре улиц.

Пакетное удаление фотографий

rpc BatchDeletePhotos( BatchDeletePhotosRequest ) returns ( BatchDeletePhotosResponse )

Удаляет список Photos и их метаданные.

Обратите внимание, что в случае сбоя BatchDeletePhotos либо отсутствуют важные поля, либо произошла ошибка аутентификации. Даже если BatchDeletePhotos завершится успешно, отдельные фотографии в пакете могут иметь сбои. Эти ошибки указаны в каждом PhotoResponse.status в BatchDeletePhotosResponse.results . См. DeletePhoto , чтобы узнать о конкретных сбоях, которые могут возникнуть для каждой фотографии.

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

Пакетное получение фотографий

rpc BatchGetPhotos( BatchGetPhotosRequest ) returns ( BatchGetPhotosResponse )

Получает метаданные указанного пакета Photo .

Обратите внимание, что в случае сбоя BatchGetPhotos либо отсутствуют важные поля, либо произошла ошибка аутентификации. Даже если BatchGetPhotos завершится успешно, отдельные фотографии в пакете могут иметь сбои. Эти ошибки указаны в каждом PhotoResponse.status в BatchGetPhotosResponse.results . См. GetPhoto для получения информации о конкретных сбоях, которые могут возникнуть для каждой фотографии.

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

Пакетное обновление фотографий

rpc BatchUpdatePhotos( BatchUpdatePhotosRequest ) returns ( BatchUpdatePhotosResponse )

Обновляет метаданные Photos , такие как поза, ассоциации с местами, связи и т. д. Изменение пикселей фотографий не поддерживается.

Обратите внимание, что в случае сбоя BatchUpdatePhotos либо отсутствуют важные поля, либо произошла ошибка аутентификации. Даже если BatchUpdatePhotos завершится успешно, отдельные фотографии в пакете могут иметь сбои. Эти ошибки указаны в каждом PhotoResponse.status в BatchUpdatePhotosResponse.results . См. UpdatePhoto для получения информации о конкретных сбоях, которые могут возникнуть для каждой фотографии.

Используются только поля, указанные в поле updateMask . Если updateMask отсутствует, обновление применяется ко всем полям.

Количество сообщений UpdatePhotoRequest в BatchUpdatePhotosRequest не должно превышать 20.

Примечание. Чтобы обновить Pose.altitude , необходимо также заполнить Pose.latLngPair . В противном случае запрос не будет выполнен.

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

СоздатьФото

rpc CreatePhoto( CreatePhotoRequest ) returns ( Photo )

После того, как клиент завершит загрузку фотографии с возвращенным UploadRef , CreatePhoto публикует загруженную Photo в Просмотре улиц на Картах Google.

В настоящее время единственный способ установить заголовок, наклон и поворот в CreatePhoto — это использовать метаданные Photo Sphere XMP в байтах фотографии. CreatePhoto игнорирует pose.heading , pose.pitch , pose.roll , pose.altitude pose.level в Pose.

Этот метод возвращает следующие коды ошибок:

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

СоздатьФотопоследовательность

rpc CreatePhotoSequence( CreatePhotoSequenceRequest ) returns ( Operation )

После того, как клиент завершит загрузку PhotoSequence с возвращенным UploadRef , CreatePhotoSequence извлекает последовательность панорамных фотографий из видео или метаданных расширяемого устройства (XDM, http://www.xdm.org/ ) для публикации в Street View на Картах Google.

CreatePhotoSequence возвращает Operation с идентификатором PhotoSequence , установленным в поле Operation.name .

Этот метод возвращает следующие коды ошибок:

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

Удалитьфото

rpc DeletePhoto( DeletePhotoRequest ) returns ( Empty )

Удаляет Photo и ее метаданные.

Этот метод возвращает следующие коды ошибок:

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

Удалить последовательность фотографий

rpc DeletePhotoSequence( DeletePhotoSequenceRequest ) returns ( Empty )

Удаляет PhotoSequence и его метаданные.

Этот метод возвращает следующие коды ошибок:

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

GetPhoto

rpc GetPhoto( GetPhotoRequest ) returns ( Photo )

Получает метаданные указанного Photo .

Этот метод возвращает следующие коды ошибок:

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

GetPhotoSequence

rpc GetPhotoSequence( GetPhotoSequenceRequest ) returns ( Operation )

Получает метаданные указанного PhotoSequence через интерфейс Operation .

Этот метод возвращает следующие три типа ответов:

  • Operation.done = false, если обработка PhotoSequence еще не завершена.
  • Operation.done = true и Operation.error заполняется, если при обработке произошла ошибка.
  • Operation.done = true и заполняется Operation.response , который содержит сообщение PhotoSequence .

Этот метод возвращает следующие коды ошибок:

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

СписокФотопоследовательности

rpc ListPhotoSequences( ListPhotoSequencesRequest ) returns ( ListPhotoSequencesResponse )

Перечисляет все PhotoSequences , принадлежащие пользователю, в порядке убывания временных меток CreatePhotoSequence.

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

Список фотографий

rpc ListPhotos( ListPhotosRequest ) returns ( ListPhotosResponse )

Перечисляет все Photos , принадлежащие пользователю.

Примечание. Недавно созданные фотографии, которые еще индексируются, не возвращаются в ответ.

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

НачалоФотоПоследовательностьЗагрузить

rpc StartPhotoSequenceUpload( Empty ) returns ( UploadRef )

Создает сеанс загрузки для начала загрузки данных серии фотографий. URL-адрес загрузки возвращенного UploadRef используется для загрузки данных для photoSequence .

После завершения загрузки UploadRef используется с CreatePhotoSequence для создания записи объекта PhotoSequence .

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

НачатьЗагрузить

rpc StartUpload( Empty ) returns ( UploadRef )

Создает сеанс загрузки, чтобы начать загрузку байтов фотографий. Метод использует URL-адрес загрузки возвращенного UploadRef для загрузки байтов Photo .

Помимо требований к фотографии, указанных в https://support.google.com/maps/answer/7012050?ref_topic=6275604 , фотография должна соответствовать следующим требованиям:

  • Метаданные Photo Sphere XMP должны быть включены в метаданные фотографии. См. https://developers.google.com/streetview/spherical-metadata для получения информации об обязательных полях.
  • Размер фотографии в пикселях должен соответствовать требованиям к размеру, указанным в https://support.google.com/maps/answer/7012050?ref_topic=6275604 , а фотография должна быть развернута на 360 градусов по горизонтали.

После завершения загрузки метод использует UploadRef с CreatePhoto для создания записи объекта Photo .

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

ОбновитьФото

rpc UpdatePhoto( UpdatePhotoRequest ) returns ( Photo )

Обновляет метаданные Photo , такие как поза, связь с местом, связи и т. д. Изменение пикселей фотографии не поддерживается.

Используются только поля, указанные в поле updateMask . Если updateMask отсутствует, обновление применяется ко всем полям.

Этот метод возвращает следующие коды ошибок:

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

Пакетное удалениеФотографииЗапрос

Запрос на удаление нескольких Photos .

Поля
photo_ids[]

string

Необходимый. Идентификаторы Photos . HTTP-запросы GET требуют следующего синтаксиса для параметра запроса URL: photoIds=<id1>&photoIds=<id2>&... .

Пакетное удалениеФотоОтвет

Ответ на пакетное удаление одной или нескольких Photos .

Поля
status[]

Status

Статус операции по удалению одной Photo в пакетном запросе.

Пакетное получение фотографийЗапрос

Запросите одну или несколько Photos . По умолчанию

  • не возвращает URL-адрес загрузки байтов фотографии.

Параметры:

  • view контролирует, возвращается ли URL-адрес загрузки для байтов фотографии.
Поля
photo_ids[]

string

Необходимый. Идентификаторы Photos . Для запросов HTTP GET параметр URL-запроса должен быть photoIds=<id1>&photoIds=<id2>&... .

view

PhotoView

Необходимый. Указывает, следует ли возвращать URL-адрес загрузки байтов фотографии в ответе «Фото».

language_code

string

Необязательный. Код языка BCP-47, например «en-US» или «sr-Latn». Для получения дополнительной информации см. http://www.unicode.org/reports/tr35/#Unicode_locale_identifier . Если языковой_код не указан, используются языковые предпочтения пользователя для служб Google.

BatchGetPhotosResponse

Ответ на пакетное получение Photos .

Поля
results[]

PhotoResponse

Список результатов для каждой запрошенной отдельной Photo в том же порядке, что и запросы в BatchGetPhotos .

Пакетное обновлениеФотографииЗапрос

Запрос на обновление метаданных фотографий. Обновление пикселей фотографий не поддерживается.

Поля
update_photo_requests[]

UpdatePhotoRequest

Необходимый. Список UpdatePhotoRequests .

Пакетное обновление фотографийОтвет

Ответ на пакетное обновление метаданных одной или нескольких Photos .

Поля
results[]

PhotoResponse

Список результатов для каждой отдельной Photo обновляется в том же порядке, что и запрос.

Связь

Соединение — это связь между исходной фотографией и конечной фотографией.

Поля
target

PhotoId

Необходимый. Назначение соединения содержащейся фотографии с другой фотографией.

СоздатьФотоЗапрос

Запрос на создание Photo .

Поля
photo

Photo

Необходимый. Фото для создания.

СоздатьФотопоследовательностьЗапрос

Запрос на создание PhotoSequence из видео.

Поля
photo_sequence

PhotoSequence

Необходимый. PhotoSequence для создания.

input_type

InputType

Необходимый. Форма ввода PhotoSequence .

Тип ввода

Формы ввода PhotoSequence .

Перечисления
INPUT_TYPE_UNSPECIFIED Не указан. Сервер вернет google.rpc.Code.INVALID_ARGUMENT .
VIDEO 360 Видео.
XDM Расширяемые метаданные устройства, http://www.xdm.org.

Удалить фотозапрос

Запрос на удаление Photo .

Поля
photo_id

string

Необходимый. Идентификатор Photo .

Удалить фотопоследовательностьзапрос

Запрос на удаление PhotoSequence .

Поля
sequence_id

string

Необходимый. Идентификатор PhotoSequence .

Получить фотозапрос

Запросить Photo .

По умолчанию

  • не возвращает URL-адрес загрузки байтов фотографии.

Параметры:

  • view контролирует, возвращается ли URL-адрес загрузки для байтов фотографии.
Поля
photo_id

string

Необходимый. Идентификатор Photo .

view

PhotoView

Необходимый. Указывает, следует ли возвращать URL-адрес загрузки байтов фотографии в ответе Photo .

language_code

string

Код языка BCP-47, например «en-US» или «sr-Latn». Для получения дополнительной информации см. http://www.unicode.org/reports/tr35/#Unicode_locale_identifier . Если языковой_код не указан, используются языковые предпочтения пользователя для служб Google.

GetPhotoSequenceRequest

Запрос на получение PhotoSequence .

По умолчанию

  • не возвращает URL-адрес загрузки PhotoSequence .

Параметры:

  • view контролирует, возвращается ли URL-адрес загрузки для PhotoSequence .
Поля
sequence_id

string

Необходимый. Идентификатор серии фотографий.

view
(deprecated)

PhotoView

Указывает, должен ли URL-адрес загрузки последовательности фотографий возвращаться в download_url отдельных фотографий в ответе PhotoSequence .

Примечание. В настоящее время не реализовано.

filter

string

Необязательный. Выражение фильтра. Например: published_status=PUBLISHED .

Поддерживаются следующие фильтры: published_status . См. https://google.aip.dev/160 для получения дополнительной информации.

GpsDataGapFailureПодробности

Подробности, связанные с ProcessingFailureReason#GPS_DATA_GAP. Если имеется несколько пробелов в данных GPS, здесь указывается только тот, который имеет наибольшую продолжительность.

Поля
gap_duration

Duration

Продолжительность обнаруженного пробела в данных GPS.

gap_start_time

Duration

Относительное время (от начала видеопотока), когда начался разрыв.

Иму

Данные IMU от датчиков устройства.

Поля
accel_mpsps[]

Measurement3d

Измерения акселерометра в метрах/сек^2 с увеличением меток времени от устройств.

gyro_rps[]

Measurement3d

Измерения гироскопа в радианах/сек с увеличением меток времени от устройств.

mag_ut[]

Measurement3d

Магнитометрические измерения магнитного поля в микротеслах (мкТл) с увеличением временных меток от приборов.

Измерение3d

Общий образец 3D-измерений.

Поля
capture_time

Timestamp

Временная метка измерения IMU.

x

float

Измерение датчика по оси X.

y

float

Измерение датчика по оси Y.

z

float

Измерение датчика по оси z.

ImuDataGapFailureDetails

Подробности, связанные с ProcessingFailureReason#IMU_DATA_GAP. Если имеется несколько пробелов в данных IMU, здесь указывается только тот, который имеет наибольшую продолжительность.

Поля
gap_duration

Duration

Продолжительность обнаруженного пробела в данных IMU.

gap_start_time

Duration

Относительное время (от начала видеопотока), когда начался разрыв.

Недостаточный GPS-сбойПодробнее

Подробности, связанные с ProcessingFailureReason#INSUFFICIENT_GPS.

Поля
gps_points_found

int32

Количество GPS-точек, найденных на видео.

LatLngГраницы

Прямоугольник в географических координатах.

Поля
southwest

LatLng

Юго-западный угол этих границ.

northeast

LatLng

Северо-восточный угол этих границ.

Уровень

Информация об уровне, содержащая номер уровня и соответствующее ему имя.

Поля
number

double

Необязательный. Номер этажа, используемый для заказа. 0 указывает уровень земли, 1 указывает первый уровень над уровнем земли, -1 указывает первый уровень под уровнем земли. Нецелые значения допустимы.

name

string

Необходимый. Имя, присвоенное этому уровню, ограниченное тремя символами. Подумайте, как бы были помечены кнопки лифта на этом уровне, если бы там был лифт.

СписокФотопоследовательностиЗапрос

Запрос на получение списка всех последовательностей фотографий, принадлежащих пользователю, отправившему запрос.

Параметры:

  • pageSize определяет максимальное количество возвращаемых последовательностей фотографий.
  • pageToken — это значение токена следующей страницы, возвращенное из предыдущего запроса ListPhotoSequences , если таковой имеется.
Поля
page_size

int32

Необязательный. Максимальное количество возвращаемых последовательностей фотографий. pageSize не должен быть отрицательным. Если pageSize равен нулю или не указан, используется размер страницы по умолчанию, равный 100. Количество последовательностей фотографий, возвращаемых в ответе, может быть меньше, чем pageSize , если количество совпадений меньше, чем pageSize . В настоящее время это не реализовано, но находится в процессе.

page_token

string

Необязательный. Значение nextPageToken возвращенное из предыдущего запроса ListPhotoSequences , если таковой имеется.

filter

string

Необязательный. Выражение фильтра. Например: imagery_type=SPHERICAL .

Поддерживаются следующие фильтры: imagery_type , processing_state , min_latitude , max_latitude , min_longitude , max_longitude , filename_query , min_capture_time_seconds , `макс_захват_время_секунды. См. https://google.aip.dev/160 для получения дополнительной информации. Запросы имени файла следует отправлять в виде фразы, чтобы поддерживать несколько слов и специальных символов путем добавления экранированных кавычек. Пример: filename_query="пример фразы.mp4"

ListPhotoSequencesОтвет

Ответ на список всех последовательностей фотографий, принадлежащих пользователю.

Поля
photo_sequences[]

Operation

Список последовательностей фотографий через интерфейс Operation .

Максимальное количество возвращаемых элементов зависит от поля pageSize в запросе.

Каждый элемент в списке может иметь три возможных состояния:

  • Operation.done = false, если обработка PhotoSequence еще не завершена.
  • Operation.done = true и Operation.error заполняется, если при обработке произошла ошибка.
  • Operation.done = true, а Operation.response содержит сообщение PhotoSequence . В каждой последовательности заполняется только Id .
next_page_token

string

Токен для получения следующей страницы результатов или пустой, если в списке больше нет результатов.

СписокФотографииЗапрос

Запрос на перечисление всех фотографий, принадлежащих пользователю, отправившему запрос.

По умолчанию

  • не возвращает URL-адрес загрузки байтов фотографии.

Параметры:

  • view контролирует, возвращается ли URL-адрес загрузки для байтов фотографии.
  • pageSize определяет максимальное количество возвращаемых фотографий.
  • pageToken — это значение токена следующей страницы, возвращенное из предыдущего запроса ListPhotos , если таковой имеется.
  • filter позволяет фильтровать по заданному параметру. PlaceId — единственный поддерживаемый на данный момент параметр.
Поля
view

PhotoView

Необходимый. Указывает, следует ли возвращать URL-адрес загрузки байтов фотографий в ответе «Фотографии».

page_size

int32

Необязательный. Максимальное количество фотографий для возврата. pageSize не должен быть отрицательным. Если pageSize равен нулю или не указан, используется размер страницы по умолчанию, равный 100. Количество фотографий, возвращаемых в ответе, может быть меньше pageSize если количество фотографий, принадлежащих пользователю, меньше pageSize .

page_token

string

Необязательный. Значение nextPageToken возвращенное из предыдущего запроса ListPhotos , если таковой имеется.

filter

string

Необязательный. Выражение фильтра. Например: placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw .

Поддерживаются следующие фильтры: placeId , min_latitude , max_latitude , min_longitude , max_longitude . См. https://google.aip.dev/160 для получения дополнительной информации.

language_code

string

Необязательный. Код языка BCP-47, например «en-US» или «sr-Latn». Для получения дополнительной информации см. http://www.unicode.org/reports/tr35/#Unicode_locale_identifier . Если языковой_код не указан, используются языковые предпочтения пользователя для служб Google.

СписокФотоОтвет

Ответ на список всех фотографий, принадлежащих пользователю.

Поля
photos[]

Photo

Список фотографий. Поле pageSize в запросе определяет количество возвращаемых элементов.

next_page_token

string

Токен для получения следующей страницы результатов или пустой, если в списке больше нет результатов.

NoOverlapGpsFailureПодробнее

Подробности, связанные с PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS.

Поля
gps_start_time

Timestamp

Время первой записанной точки GPS.

gps_end_time

Timestamp

Время последней записанной точки GPS.

video_start_time

Timestamp

Время начала видео.

video_end_time

Timestamp

Время окончания видео.

NotOutdoorsFailureПодробности

Подробности, связанные с ProcessingFailureReason#NOT_OUTDOORS. Если обнаружено несколько внутренних кадров, здесь записывается первый кадр.

Поля
start_time

Duration

Относительное время (от начала видеопотока), когда был найден внутренний кадр.

Фото

Фотография используется для хранения панорамных фотографий вместе с метаданными фотографий.

Поля
photo_id

PhotoId

Необходимый. Только вывод. Требуется при обновлении фотографии. Вывод только при создании фотографии. Идентификатор фотографии, уникальный среди всех фотографий в Google.

upload_reference

UploadRef

Только ввод. Требуется при создании фотографии. Только ввод. URL-адрес ресурса, куда загружаются байты фотографии.

download_url

string

Только вывод. URL-адрес загрузки байтов фотографий. Это поле устанавливается только в том случае, если для GetPhotoRequest.view установлено значение PhotoView.INCLUDE_DOWNLOAD_URL .

thumbnail_url

string

Только вывод. URL-адрес миниатюры для предварительного просмотра данной фотографии.

pose

Pose

Необязательный. Поза фотографии.

connections[]

Connection

Необязательный. Связь с другими фотографиями. Соединение представляет собой ссылку с этой фотографии на другую фотографию.

capture_time

Timestamp

Необязательный. Абсолютное время, когда была сделана фотография. Если фотография не имеет метки времени exif, она используется для установки метки времени в метаданных фотографии.

upload_time

Timestamp

Только вывод. Время загрузки изображения.

places[]

Place

Необязательный. Места, которым принадлежит это фото.

view_count

int64

Только вывод. Количество просмотров фотографии.

transfer_status

TransferStatus

Только вывод. Статус передачи прав на это фото.

maps_publish_status

MapsPublishStatus

Только вывод. Статус в Картах Google, была ли эта фотография опубликована или отклонена.

КартыОпубликоватьСтатус

Статус публикации фотографии в Google Maps.

Перечисления
UNSPECIFIED_MAPS_PUBLISH_STATUS Статус фото неизвестен.
PUBLISHED Фотография опубликована в открытом доступе через Google Maps.
REJECTED_UNKNOWN Фотография была отклонена по неизвестной причине.

Статус трансфера

Статус передачи прав.

Перечисления
TRANSFER_STATUS_UNKNOWN Статус этого перевода не указан.
NEVER_TRANSFERRED Это фото никогда не было в передаче.
PENDING Передача фотографии была начата, но получатель еще не ответил.
COMPLETED Передача фотографии завершена, и эта фотография передана получателю.
REJECTED Получатель отклонил передачу фотографии.
EXPIRED Срок передачи фотографии истек до того, как получатель предпринял какие-либо действия.
CANCELLED Отправитель отменил передачу фотографии.
RECEIVED_VIA_TRANSFER Получатель владеет этой фотографией в связи с передачей прав.

Идентификатор фотографии

Идентификатор Photo .

Поля
id

string

Уникальный идентификатор фотографии.

Фотоответ

Полезная нагрузка ответа для одной Photo в пакетных операциях, включая BatchGetPhotos и BatchUpdatePhotos .

Поля
status

Status

Статус операции по получению или обновлению одной фотографии в пакетном запросе.

photo

Photo

Ресурс Photo , если запрос прошел успешно.

ФотоПоследовательность

Последовательность из панорамных фотографий с метаданными.

Поля
id

string

Только вывод. Уникальный идентификатор серии фотографий. Он также действует как идентификатор длительной операции, если загрузка выполняется асинхронно.

photos[]

Photo

Только вывод. Фотографии с увеличивающимися временными метками.

upload_reference

UploadRef

Только ввод. Требуется при создании фоторяда. Имя ресурса, куда загружаются байты серии фотографий (в виде видео).

capture_time_override

Timestamp

Необязательный. Абсолютное время, когда начинается съемка серии фотографий. Если серия фотографий представляет собой видео, это время начала видео. Если это поле заполнено во входных данных, оно переопределяет время захвата в видео или файле XDM.

upload_time

Timestamp

Только вывод. Время создания этой серии фотографий в сервисе uSV Store.

raw_gps_timeline[]

Pose

Только ввод. Необработанные измерения GPS с увеличивающимися временными метками с устройства, которые не синхронизированы по времени с каждой фотографией. Эти необработанные измерения будут использоваться для определения позы каждого кадра. Требуется во входных данных, когда Тип ввода — ВИДЕО и необработанные измерения GPS не находятся в дорожке метаданных движения камеры (CAMM). Пользователь может указать, что имеет приоритет, используя gps_source, если необработанные измерения GPS предоставляются как в raw_gps_timeline, так и в треке метаданных движения камеры (CAMM).

gps_source

GpsSource

Только ввод. Если и raw_gps_timeline, и дорожка метаданных движения камеры (CAMM) содержат измерения GPS, укажите, что имеет приоритет.

imu

Imu

Только ввод. Трехосные данные IMU для коллекции. Если эти данные слишком велики для размещения в запросе, их следует поместить в дорожку CAMM для видео. Эти данные всегда имеют приоритет над эквивалентными данными CAMM, если они существуют.

processing_state

ProcessingState

Только вывод. Состояние обработки этой последовательности.

failure_reason

ProcessingFailureReason

Только вывод. Если эта последовательность имеет Processing_state = FAILED, это будет содержать причину, по которой она не удалась. Если в поле Processing_state указано любое другое значение, это поле будет не установлено.

failure_details

ProcessingFailureDetails

Только вывод. Если для этой последовательности установлена failure_reason , она может содержать дополнительные сведения об ошибке.

distance_meters

double

Только вывод. Вычисленное расстояние до серии фотографий в метрах.

sequence_bounds

LatLngBounds

Только вывод. Прямоугольная коробка, в которой заключены все изображения в этой серии фотографий.

view_count

int64

Только вывод. Общее количество просмотров, полученных всеми опубликованными изображениями в этой PhotoSequence.

filename

string

Только вывод. Имя файла загрузки. Не включает путь к каталогу. Доступно только в том случае, если эпизод был загружен на платформу, предоставляющую имя файла.

GPSИсточник

Основной источник измерений GPS.

Перечисления
PHOTO_SEQUENCE GPS в raw_gps_timeline имеет приоритет, если он существует.
CAMERA_MOTION_METADATA_TRACK GPS в отслеживании метаданных движения камеры (CAMM) имеет приоритет, если он существует.

Фотопросмотр

Указывает, какой вид Photo включить в ответ.

Перечисления
BASIC Ответы сервера не включают URL-адрес загрузки байтов фотографий. Значение по умолчанию.
INCLUDE_DOWNLOAD_URL Ответы сервера включают URL-адрес загрузки байтов фотографий.

Место

Разместите метаданные для сущности.

Поля
place_id

string

Идентификатор места, как описано в https://developers.google.com/places/place-id .

name

string

Только вывод. Название места, локализованное по языковому_коду.

language_code

string

Только вывод. Код_языка, с помощью которого локализовано имя. Это должен быть код языка, указанный в запросе, но это может быть запасной вариант.

Поза

Необработанные измерения позы объекта.

Поля
lat_lng_pair

LatLng

Пара широты и долготы позы, как описано здесь: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng . При создании Photo , если пара широты и долготы не указана, используется геолокация из заголовка exif. Пара широты и долготы, не указанная в фотографии или заголовке exif, приводит к сбою процесса обработки фотографии.

altitude

double

Высота позы в метрах над эллипсоидом WGS84. NaN указывает на неизмеренное количество.

heading

double

Следующие параметры позы относятся к центру фотографии. Они соответствуют https://developers.google.com/streetview/spherical-metadata . Курс по компасу, измеренный в центре фотографии в градусах по часовой стрелке от севера. Значение должно быть >=0 и <360. NaN указывает на неизмеренное количество.

pitch

double

Угол наклона измеряется в центре фотографии в градусах. Значение должно быть >=-90 и <= 90. Значение -90 означает взгляд прямо вниз, а значение 90 означает взгляд прямо вверх. NaN указывает на неизмеренное количество.

roll

double

Рулон, измеряемый в градусах. Значение должно быть >= 0 и <360. Значение 0 означает уровень горизонта. NaN указывает на неизмеренное количество.

gps_record_timestamp_unix_epoch

Timestamp

Время записи GPS с эпохи UTC.

level

Level

Уровень (пол в здании), используемый для настройки вертикальной навигации.

accuracy_meters

float

Предполагаемая горизонтальная точность этой позы в метрах с достоверностью 68 % (одно стандартное отклонение). Например, в Android это значение можно получить с помощью этого метода: https://developer.android.com/reference/android/location/Location#getAccuracy() . На других платформах используются разные методы получения аналогичных оценок точности.

Сбой обработкиПодробности

Дополнительные сведения, сопровождающие перечисление ProcessingFailureReason. Ожидается, что это сообщение всегда будет использоваться вместе с ProcessingFailureReason, и значение oneof, установленное в этом сообщении, должно соответствовать FailureReason.

Поля
details поля объединения. Будет установлен только один набор сведений, который должен соответствовать соответствующему перечислению в ProcessingFailureReason. details могут быть только одним из следующих:
insufficient_gps_details

InsufficientGpsFailureDetails

См. сведения о недостаточном GpsFailureDetails.

gps_data_gap_details

GpsDataGapFailureDetails

См. раздел GpsDataGapFailureDetails.

imu_data_gap_details

ImuDataGapFailureDetails

См. ImuDataGapFailureDetails.

not_outdoors_details

NotOutdoorsFailureDetails

См. раздел NotOutdoorsFailureDetails.

no_overlap_gps_details

NoOverlapGpsFailureDetails

См. раздел NoOverlapGpsFailureDetails.

Причина сбоя обработки

Возможные причины, по которым 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 Недостаточно движущихся данных.

Состояние обработки

Состояние обработки последовательности. Государства действуют следующим образом:

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

Последовательность может перейти в состояние FAILED из любого состояния. Кроме того, обработанная последовательность может быть повторно обработана в любое время.

Перечисления
PROCESSING_STATE_UNSPECIFIED Состояние не указано, это значение по умолчанию.
PENDING Последовательность еще не начала обработку.
PROCESSING Последовательность в настоящее время находится в обработке.
PROCESSED Последовательность завершила обработку, включая уточнение позиции.
FAILED Последовательность не удалось обработать. Дополнительные сведения см. в разделе «Причина сбоя».

ОбновлениеФотоЗапрос

Запрос на обновление метаданных Photo . Обновление пикселей фотографии не поддерживается.

Поля
photo

Photo

Необходимый. Объект Photo , содержащий новые метаданные.

update_mask

FieldMask

Необходимый. Маска, определяющая поля метаданных фотографии, которые необходимо обновить. Если они отсутствуют, старые метаданные Photo полностью заменяются новыми метаданными Photo в этом запросе. Обновление завершается неудачно, если указаны недопустимые поля. Несколько полей можно указать в списке, разделенном запятыми.

Следующие поля действительны:

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

Примечание. Если updateMask содержит повторяющиеся поля, весь набор повторяющихся значений заменяется новым содержимым. Например, если updateMask содержит connections , а UpdatePhotoRequest.photo.connections пуст, все подключения удаляются.

ЗагрузитьRef

Загрузите ссылку на медиафайлы.

Поля
Поле объединения file_source . Необходимый. file_source может быть только одним из следующих:
upload_url

string

Ссылка на загрузку должна быть уникальной для каждого пользователя. Он имеет форму: «https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}».