Method: photoSequence.create

클라이언트가 반환된 UploadRef를 사용하여 PhotoSequence 업로드를 완료하면 photoSequence.create는 동영상 또는 확장 가능한 기기 메타데이터 (XDM, http://www.xdm.org/)에서 360도 파노라마 사진을 추출하여 Google 지도의 스트리트 뷰에 게시합니다.

photoSequence.createOperation.name 필드에 PhotoSequence ID가 설정된 Operation를 반환합니다.

이 메서드는 다음 오류 코드를 반환합니다.

HTTP 요청

POST https://streetviewpublish.googleapis.com/v1/photoSequence

URL은 gRPC 트랜스코딩 구문을 사용합니다.

쿼리 매개변수

매개변수
inputType

enum (InputType)

필수 항목입니다. PhotoSequence의 입력 형식입니다.

요청 본문

요청 본문에는 PhotoSequence의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 새로 생성된 Operation의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.

사진 시퀀스

메타데이터와 함께 360도 파노라마 사진 시퀀스

JSON 표현
{
  "id": string,
  "photos": [
    {
      object (Photo)
    }
  ],
  "uploadReference": {
    object (UploadRef)
  },
  "captureTimeOverride": string,
  "uploadTime": string,
  "rawGpsTimeline": [
    {
      object (Pose)
    }
  ],
  "gpsSource": enum (GpsSource),
  "imu": {
    object (Imu)
  },
  "processingState": enum (ProcessingState),
  "failureReason": enum (ProcessingFailureReason),
  "distanceMeters": number,
  "sequenceBounds": {
    object (LatLngBounds)
  },
  "viewCount": string,
  "filename": string
}
필드
id

string

출력 전용. 사진 시퀀스의 고유 식별자입니다. 업로드가 비동기적으로 실행되는 경우에도 장기 실행 작업 ID 역할을 합니다.

photos[]

object (Photo)

출력 전용. 타임스탬프가 증가하는 사진.

uploadReference

object (UploadRef)

입력 전용. 사진 시퀀스를 만들 때 필요합니다. 사진 시퀀스의 바이트 (동영상 형식)가 업로드된 리소스 이름입니다.

captureTimeOverride

string (Timestamp format)

선택사항. 사진 시퀀스가 캡처되기 시작하는 절대 시간입니다. 사진 시퀀스가 동영상인 경우 동영상의 시작 시간입니다. 이 필드를 입력으로 채우면 동영상 또는 XDM 파일의 캡처 시간이 재정의됩니다.

RFC3339 UTC "Zulu' 형식의 타임스탬프로, 나노초 해상도와 최대 9자리 소수를 나타냅니다. 예: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

uploadTime

string (Timestamp format)

출력 전용. uSV 스토어 서비스에서 이 사진 시퀀스가 생성된 시간입니다.

RFC3339 UTC "Zulu' 형식의 타임스탬프로, 나노초 해상도와 최대 9자리 소수를 나타냅니다. 예: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

rawGpsTimeline[]

object (Pose)

입력 전용. 각 사진과 동기화되지 않은 기기의 타임스탬프가 증가하여 원시 GPS 측정값 이러한 원시 측정값은 각 프레임의 포즈를 추론하는 데 사용됩니다. InputType이 VIDEO이고 원본 GPS 측정값이 Camera Motion Metadata Track (CAMM)에 없는 경우 입력에 필요합니다. 원시 GPS 측정값이 rawGps타임라인과 카메라 모션 메타데이터 트랙 (CAMM)에 모두 제공되는 경우 사용자는 gpsSource를 사용하여 어떤 것이 우선시되는지 나타낼 수 있습니다.

gpsSource

enum (GpsSource)

입력 전용. rawGps타임라인과 카메라 모션 메타데이터 트랙 (CAMM) 둘 다에 GPS 측정값이 포함된 경우 이를 우선시합니다.

imu

object (Imu)

입력 전용. 컬렉션에 대한 3축 IMU 데이터입니다. 이 데이터가 너무 커서 요청에 넣을 수 없는 경우 동영상의 CAMM 트랙에 배치해야 합니다. 이 데이터는 동등한 CAMM 데이터(있는 경우)보다 항상 우선합니다.

processingState

enum (ProcessingState)

출력 전용. 이 시퀀스의 처리 상태입니다.

failureReason

enum (ProcessingFailureReason)

출력 전용. 이 시퀀스의 ProcessingState = FAILED가 있으면 실패 이유가 포함됩니다. processingState가 다른 값이면 이 필드가 설정 해제됩니다.

distanceMeters

number

출력 전용. 계산된 사진 시퀀스의 거리(단위: 미터)입니다.

sequenceBounds

object (LatLngBounds)

출력 전용. 이 사진 시퀀스의 모든 이미지를 캡슐화하는 직사각형 상자입니다.

viewCount

string (int64 format)

출력 전용. 이 PhotoSequence에 게시된 모든 이미지가 받은 총 조회수입니다.

filename

string

출력 전용. 업로드의 파일 이름입니다. 디렉터리 경로는 포함되지 않습니다. 파일 이름을 제공하는 플랫폼에 시퀀스가 업로드된 경우에만 사용할 수 있습니다.

GPS 소스

GPS 측정의 기본 소스입니다.

열거형
PHOTO_SEQUENCE rawGps타임라인에 GPS가 있는 경우 우선 적용됩니다.
CAMERA_MOTION_METADATA_TRACK 카메라 모션 메타데이터 트랙 (CAMM)에 GPS가 있으면 우선 적용됩니다.

이무어

기기 센서의 IMU 데이터

JSON 표현
{
  "accelMpsps": [
    {
      object (Measurement3d)
    }
  ],
  "gyroRps": [
    {
      object (Measurement3d)
    }
  ],
  "magUt": [
    {
      object (Measurement3d)
    }
  ]
}
필드
accelMpsps[]

object (Measurement3d)

기기에서 타임스탬프가 증가하면서 가속도계가 미터/초^2로 측정됩니다.

gyroRps[]

object (Measurement3d)

기기의 타임스탬프가 증가하는 자이로스코프/초 단위로 측정

magUt[]

object (Measurement3d)

기기에서 타임스탬프가 증가하는 마이크로테슬라 (uT) 자기장의 자기계 측정값.

측정3D

일반 3D 측정 샘플

JSON 표현
{
  "captureTime": string,
  "x": number,
  "y": number,
  "z": number
}
필드
captureTime

string (Timestamp format)

IMU 측정의 타임스탬프입니다.

RFC3339 UTC "Zulu' 형식의 타임스탬프로, 나노초 해상도와 최대 9자리 소수를 나타냅니다. 예: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

x

number

x축의 센서 측정값입니다.

y

number

y축의 센서 측정값입니다.

z

number

z축의 센서 측정값입니다.

처리 상태

시퀀스의 처리 상태입니다. 상태는 다음과 같이 이동합니다.

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

시퀀스가 어떤 상태에서도 실패로 이동할 수 있습니다. 또한 처리된 순서는 언제든지 다시 처리될 수 있습니다.

열거형
PROCESSING_STATE_UNSPECIFIED 상태는 지정되지 않았습니다. 기본값입니다.
PENDING 시퀀스가 아직 처리를 시작하지 않았습니다.
PROCESSING 현재 시퀀스가 처리되고 있습니다.
PROCESSED 위치 상세검색을 포함한 시퀀스 처리가 완료되었습니다.
FAILED 시퀀스를 처리하지 못했습니다. 자세한 내용은 FailureReason을 참고하세요.

처리 실패 이유

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 캡처 시간이 잘못되었습니다. 타임스탬프가 미래 날짜로 되어 있습니다.

LatLngBounds

지리적 좌표로 직사각형입니다.

JSON 표현
{
  "southwest": {
    object (LatLng)
  },
  "northeast": {
    object (LatLng)
  }
}
필드
southwest

object (LatLng)

이 경계의 남서쪽 모서리입니다.

northeast

object (LatLng)

이 경계의 북동쪽 모서리입니다.

입력 유형

PhotoSequence의 입력 형식입니다.

열거형
INPUT_TYPE_UNSPECIFIED 지정되지 않음 서버에서 google.rpc.Code.INVALID_ARGUMENT를 반환합니다.
VIDEO 360도 동영상
XDM 확장 가능한 기기 메타데이터, http://www.xdm.org