- HTTP 요청
- 쿼리 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- PhotoSequence
- 소스 소스
- 임뮤
- 측정3d
- ProcessingState
- processingFailureReason
- LatLngBounds
- 입력 유형
- 실습
클라이언트가 반환된 UploadRef
를 사용하여 PhotoSequence
업로드를 완료하면 photoSequence.create
는 동영상 또는 확장 가능한 기기 메타데이터 (XDM, http://www.xdm.org/)에서 360도 파노라마 사진을 추출하여 Google 지도의 스트리트 뷰에 게시합니다.
photoSequence.create
은 Operation.name
필드에 PhotoSequence
ID가 설정된 Operation
를 반환합니다.
이 메서드는 다음 오류 코드를 반환합니다.
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 개요를 참고하세요.
사진 시퀀스
메타데이터와 함께 360도 파노라마 사진 시퀀스
JSON 표현 |
---|
{ "id": string, "photos": [ { object ( |
필드 | |
---|---|
id |
출력 전용. 사진 시퀀스의 고유 식별자입니다. 업로드가 비동기적으로 실행되는 경우에도 장기 실행 작업 ID 역할을 합니다. |
photos[] |
출력 전용. 타임스탬프가 증가하는 사진. |
uploadReference |
입력 전용. 사진 시퀀스를 만들 때 필요합니다. 사진 시퀀스의 바이트 (동영상 형식)가 업로드된 리소스 이름입니다. |
captureTimeOverride |
선택사항. 사진 시퀀스가 캡처되기 시작하는 절대 시간입니다. 사진 시퀀스가 동영상인 경우 동영상의 시작 시간입니다. 이 필드를 입력으로 채우면 동영상 또는 XDM 파일의 캡처 시간이 재정의됩니다. RFC3339 UTC "Zulu' 형식의 타임스탬프로, 나노초 해상도와 최대 9자리 소수를 나타냅니다. 예: |
uploadTime |
출력 전용. uSV 스토어 서비스에서 이 사진 시퀀스가 생성된 시간입니다. RFC3339 UTC "Zulu' 형식의 타임스탬프로, 나노초 해상도와 최대 9자리 소수를 나타냅니다. 예: |
rawGpsTimeline[] |
입력 전용. 각 사진과 동기화되지 않은 기기의 타임스탬프가 증가하여 원시 GPS 측정값 이러한 원시 측정값은 각 프레임의 포즈를 추론하는 데 사용됩니다. InputType이 VIDEO이고 원본 GPS 측정값이 Camera Motion Metadata Track (CAMM)에 없는 경우 입력에 필요합니다. 원시 GPS 측정값이 rawGps타임라인과 카메라 모션 메타데이터 트랙 (CAMM)에 모두 제공되는 경우 사용자는 gpsSource를 사용하여 어떤 것이 우선시되는지 나타낼 수 있습니다. |
gpsSource |
입력 전용. rawGps타임라인과 카메라 모션 메타데이터 트랙 (CAMM) 둘 다에 GPS 측정값이 포함된 경우 이를 우선시합니다. |
imu |
입력 전용. 컬렉션에 대한 3축 IMU 데이터입니다. 이 데이터가 너무 커서 요청에 넣을 수 없는 경우 동영상의 CAMM 트랙에 배치해야 합니다. 이 데이터는 동등한 CAMM 데이터(있는 경우)보다 항상 우선합니다. |
processingState |
출력 전용. 이 시퀀스의 처리 상태입니다. |
failureReason |
출력 전용. 이 시퀀스의 ProcessingState = FAILED가 있으면 실패 이유가 포함됩니다. processingState가 다른 값이면 이 필드가 설정 해제됩니다. |
distanceMeters |
출력 전용. 계산된 사진 시퀀스의 거리(단위: 미터)입니다. |
sequenceBounds |
출력 전용. 이 사진 시퀀스의 모든 이미지를 캡슐화하는 직사각형 상자입니다. |
viewCount |
출력 전용. 이 PhotoSequence에 게시된 모든 이미지가 받은 총 조회수입니다. |
filename |
출력 전용. 업로드의 파일 이름입니다. 디렉터리 경로는 포함되지 않습니다. 파일 이름을 제공하는 플랫폼에 시퀀스가 업로드된 경우에만 사용할 수 있습니다. |
GPS 소스
GPS 측정의 기본 소스입니다.
열거형 | |
---|---|
PHOTO_SEQUENCE |
rawGps타임라인에 GPS가 있는 경우 우선 적용됩니다. |
CAMERA_MOTION_METADATA_TRACK |
카메라 모션 메타데이터 트랙 (CAMM)에 GPS가 있으면 우선 적용됩니다. |
이무어
기기 센서의 IMU 데이터
JSON 표현 |
---|
{ "accelMpsps": [ { object ( |
필드 | |
---|---|
accelMpsps[] |
기기에서 타임스탬프가 증가하면서 가속도계가 미터/초^2로 측정됩니다. |
gyroRps[] |
기기의 타임스탬프가 증가하는 자이로스코프/초 단위로 측정 |
magUt[] |
기기에서 타임스탬프가 증가하는 마이크로테슬라 (uT) 자기장의 자기계 측정값. |
측정3D
일반 3D 측정 샘플
JSON 표현 |
---|
{ "captureTime": string, "x": number, "y": number, "z": number } |
필드 | |
---|---|
captureTime |
IMU 측정의 타임스탬프입니다. RFC3339 UTC "Zulu' 형식의 타임스탬프로, 나노초 해상도와 최대 9자리 소수를 나타냅니다. 예: |
x |
x축의 센서 측정값입니다. |
y |
y축의 센서 측정값입니다. |
z |
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 ( |
필드 | |
---|---|
southwest |
이 경계의 남서쪽 모서리입니다. |
northeast |
이 경계의 북동쪽 모서리입니다. |
입력 유형
PhotoSequence
의 입력 형식입니다.
열거형 | |
---|---|
INPUT_TYPE_UNSPECIFIED |
지정되지 않음 서버에서 google.rpc.Code.INVALID_ARGUMENT 를 반환합니다. |
VIDEO |
360도 동영상 |
XDM |
확장 가능한 기기 메타데이터, http://www.xdm.org |