Package google.streetview.publish.v1

색인

StreetViewPublishService

사용자가 제공한 사진을 스트리트 뷰에 게시하고 연결합니다.

BatchDeletePhotos

rpc BatchDeletePhotos(BatchDeletePhotosRequest) returns (BatchDeletePhotosResponse)

Photos 및 그 메타데이터를 삭제합니다.

BatchDeletePhotos가 실패하면 중요한 필드가 누락되거나 인증 오류가 발생합니다. BatchDeletePhotos에 성공해도 배치의 개별 사진에 오류가 발생할 수 있습니다. 이러한 실패는 BatchDeletePhotosResponse.results의 각 PhotoResponse.status에 지정됩니다. 사진별로 발생할 수 있는 구체적인 실패는 DeletePhoto를 참고하세요.

승인 범위

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

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

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

BatchGetPhotos

rpc BatchGetPhotos(BatchGetPhotosRequest) returns (BatchGetPhotosResponse)

지정된 Photo 배치의 메타데이터를 가져옵니다.

BatchGetPhotos가 실패하면 중요한 필드가 누락되거나 인증 오류가 발생합니다. BatchGetPhotos에 성공해도 배치의 개별 사진에 오류가 발생할 수 있습니다. 이러한 실패는 BatchGetPhotosResponse.results의 각 PhotoResponse.status에 지정됩니다. 사진별로 발생할 수 있는 구체적인 실패는 GetPhoto를 참고하세요.

승인 범위

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

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

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

BatchUpdatePhotos

rpc BatchUpdatePhotos(BatchUpdatePhotosRequest) returns (BatchUpdatePhotosResponse)

포즈, 장소 연결, 연결 등의 Photos 메타데이터를 업데이트합니다. 사진 픽셀 변경은 지원되지 않습니다.

BatchUpdatePhotos가 실패하면 중요한 필드가 누락되거나 인증 오류가 발생합니다. BatchUpdatePhotos에 성공해도 배치의 개별 사진에 오류가 발생할 수 있습니다. 이러한 실패는 BatchUpdatePhotosResponse.results의 각 PhotoResponse.status에 지정됩니다. 사진별로 발생할 수 있는 구체적인 실패는 UpdatePhoto를 참고하세요.

updateMask 필드에 지정된 필드만 사용됩니다. updateMask가 없으면 업데이트가 모든 필드에 적용됩니다.

BatchUpdatePhotosRequestUpdatePhotoRequest 메시지 수는 20개를 초과할 수 없습니다.

참고: Pose.altitude를 업데이트하려면 Pose.latLngPair도 채워야 합니다. 그렇지 않으면 요청이 실패합니다.

승인 범위

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

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

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

CreatePhoto

rpc CreatePhoto(CreatePhotoRequest) returns (Photo)

클라이언트가 반환된 UploadRef로 사진 업로드를 완료하면 CreatePhoto는 업로드된 Photo를 Google 지도의 스트리트 뷰에 게시합니다.

현재 CreatePhoto에서 방향, 피치, 롤을 설정하는 유일한 방법은 사진 바이트에서 Photo Sphere XMP 메타데이터를 사용하는 것입니다. CreatePhoto는 Pose에서 pose.heading, pose.pitch, pose.roll, pose.altitude, pose.level 필드를 무시합니다.

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

승인 범위

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

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

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

CreatePhotoSequence

rpc CreatePhotoSequence(CreatePhotoSequenceRequest) returns (Operation)

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

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

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

승인 범위

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

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

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

DeletePhoto

rpc DeletePhoto(DeletePhotoRequest) returns (Empty)

Photo 및 메타데이터를 삭제합니다.

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

승인 범위

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

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

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

DeletePhotoSequence

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)

Operation 인터페이스를 통해 지정된 PhotoSequence의 메타데이터를 가져옵니다.

이 메서드는 다음 세 가지 유형의 응답을 반환합니다.

  • Operation.done = false: PhotoSequence 처리가 아직 완료되지 않은 경우
  • 처리 중에 오류가 발생한 경우 Operation.done = true이고 Operation.error가 채워집니다.
  • Operation.done = true이고 Operation.responsePhotoSequence 메시지를 포함하는 더 많은 데이터로 수집됩니다.

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

승인 범위

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

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

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

ListPhotoSequences

rpc ListPhotoSequences(ListPhotoSequencesRequest) returns (ListPhotoSequencesResponse)

사용자에게 속한 모든 PhotoSequences를 CreatePhotoSequence 타임스탬프 내림차순으로 나열합니다.

승인 범위

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

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

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

ListPhotos

rpc ListPhotos(ListPhotosRequest) returns (ListPhotosResponse)

사용자에게 속한 모든 Photos를 나열합니다.

참고: 아직 색인이 생성 중인 최근에 만든 사진은 응답에 반환되지 않습니다.

승인 범위

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

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

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

StartPhotoSequenceUpload

rpc StartPhotoSequenceUpload(Empty) returns (UploadRef)

사진 시퀀스 데이터 업로드를 시작하기 위한 업로드 세션을 만듭니다. 반환된 UploadRef의 업로드 URL은 photoSequence의 데이터를 업로드하는 데 사용됩니다.

업로드가 완료되면 UploadRefCreatePhotoSequence와 함께 사용하여 PhotoSequence 객체 항목을 만듭니다.

승인 범위

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

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

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

StartUpload

rpc StartUpload(Empty) returns (UploadRef)

사진 바이트 업로드를 시작하기 위한 업로드 세션을 만듭니다. 이 메서드는 반환된 UploadRef의 업로드 URL을 사용하여 Photo의 바이트를 업로드합니다.

사진은 https://support.google.com/maps/answer/7012050?ref_topic=6275604에 표시된 사진 요구사항 외에도 다음 요구사항을 충족해야 합니다.

업로드가 완료되면 메서드는 UploadRefCreatePhoto와 함께 사용하여 Photo 객체 항목을 만듭니다.

승인 범위

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

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

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

UpdatePhoto

rpc UpdatePhoto(UpdatePhotoRequest) returns (Photo)

포즈, 장소 연결, 연결 등의 Photo 메타데이터를 업데이트합니다. 사진의 픽셀 변경은 지원되지 않습니다.

updateMask 필드에 지정된 필드만 사용됩니다. updateMask가 없으면 업데이트가 모든 필드에 적용됩니다.

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

승인 범위

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

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

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

BatchDeletePhotosRequest

여러 Photos 삭제 요청입니다.

필드
photo_ids[]

string

필수 항목입니다. Photos의 ID입니다. HTTP GET 요청에는 URL 쿼리 매개변수에 photoIds=<id1>&photoIds=<id2>&... 구문이 필요합니다.

BatchDeletePhotosResponse

하나 이상의 Photos 일괄 삭제에 대한 응답입니다.

필드
status[]

Status

일괄 요청에서 단일 Photo를 삭제하는 작업의 상태입니다.

BatchGetPhotosRequest

하나 이상의 Photos 가져오기 요청입니다. 기본적으로

  • 는 사진 바이트에 대한 다운로드 URL을 반환하지 않습니다.

매개변수:

  • view는 사진 바이트의 다운로드 URL의 반환 여부를 제어합니다.
필드
photo_ids[]

string

필수 항목입니다. Photos의 ID입니다. 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를 참조하세요. language_code가 지정되지 않으면 Google 서비스에서 사용자의 언어 환경설정이 사용됩니다.

BatchGetPhotosResponse

Photos의 일괄 가져오기에 대한 응답입니다.

필드
results[]

PhotoResponse

요청된 각 개별 Photo의 결과 목록으로, BatchGetPhotos의 요청과 동일한 순서로 표시됩니다.

BatchUpdatePhotosRequest

사진의 메타데이터 업데이트 요청입니다. 사진의 픽셀 업데이트는 지원되지 않습니다.

필드
update_photo_requests[]

UpdatePhotoRequest

필수 항목입니다. UpdatePhotoRequests 목록입니다.

BatchUpdatePhotosResponse

하나 이상의 Photos의 메타데이터 일괄 업데이트에 대한 응답입니다.

필드
results[]

PhotoResponse

각 개별 Photo의 결과 목록이 요청과 동일한 순서로 업데이트되었습니다.

연대감

연결은 원본 사진에서 대상 사진으로 연결되는 링크입니다.

필드
target

PhotoId

필수 항목입니다. 포함하는 사진에서 다른 사진으로의 연결 대상입니다.

CreatePhotoRequest

Photo 생성 요청입니다.

필드
photo

Photo

필수 항목입니다. 만들 사진입니다.

CreatePhotoSequenceRequest

동영상에서 PhotoSequence 만들기 요청입니다.

필드
photo_sequence

PhotoSequence

필수 항목입니다. 만들려면 PhotoSequence하세요.

input_type

InputType

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

InputType

PhotoSequence의 입력 형식입니다.

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

DeletePhotoRequest

Photo 삭제 요청입니다.

필드
photo_id

string

필수 항목입니다. Photo의 ID입니다.

DeletePhotoSequenceRequest

PhotoSequence 삭제 요청입니다.

필드
sequence_id

string

필수 항목입니다. PhotoSequence의 ID입니다.

GetPhotoRequest

Photo 가져오기 요청입니다.

기본적으로

  • 는 사진 바이트에 대한 다운로드 URL을 반환하지 않습니다.

매개변수:

  • view는 사진 바이트의 다운로드 URL의 반환 여부를 제어합니다.
필드
photo_id

string

필수 항목입니다. Photo의 ID입니다.

view

PhotoView

필수 항목입니다. 사진 바이트의 다운로드 URL을 Photo 응답에서 반환해야 하는지 여부를 지정합니다.

language_code

string

BCP-47 언어 코드(예: 'en-US' 또는 'sr-Latn')입니다. 자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참조하세요. language_code가 지정되지 않으면 Google 서비스에서 사용자의 언어 환경설정이 사용됩니다.

GetPhotoSequenceRequest

PhotoSequence 가져오기 요청입니다.

기본적으로

  • PhotoSequence의 다운로드 URL을 반환하지 않습니다.

매개변수:

  • viewPhotoSequence의 다운로드 URL의 반환 여부를 제어합니다.
필드
sequence_id

string

필수 항목입니다. 사진 시퀀스의 ID입니다.

view
(deprecated)

PhotoView

PhotoSequence 응답에서 개별 사진의 download_url에서 사진 시퀀스의 다운로드 URL을 반환해야 하는지 여부를 지정합니다.

참고: 현재 구현되지 않았습니다.

filter

string

선택사항입니다. 필터 표현식입니다. 예를 들면 published_status=PUBLISHED입니다.

지원되는 필터는 published_status입니다. 자세한 내용은 https://google.aip.dev/160을 참고하세요.

GpsDataGapFailureDetails

ProcessingFailureReason#GPS_DATA_GAP와 관련된 세부정보입니다. GPS 데이터 간격이 여러 개인 경우 기간이 가장 긴 간격만 여기에 보고됩니다.

필드
gap_duration

Duration

발견된 GPS 데이터에서 간격의 지속 시간입니다.

gap_start_time

Duration

간격이 시작된 시점의 상대 시간 (동영상 스트림 시작 시점 기준)입니다.

이무

기기 센서의 IMU 데이터입니다.

필드
accel_mpsps[]

Measurement3d

기기에서 타임스탬프가 증가하는 가속도계 측정값(미터/초^2)입니다.

gyro_rps[]

Measurement3d

기기에서 타임스탬프가 증가하는 자이로스코프 측정값(라디안/초)입니다.

mag_ut[]

Measurement3d

기기에서 타임스탬프가 증가하는 마이크로테슬라 (uT) 단위로 자기장의 자기계 측정값을 표시한 것입니다.

Measurement3D

일반 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

간격이 시작된 시점의 상대 시간 (동영상 스트림 시작 시점 기준)입니다.

InsufficientGpsFailureDetails

ProcessingFailureReason#INSUFFICIENT_GPS와 관련된 세부정보입니다.

필드
gps_points_found

int32

동영상에서 발견된 GPS 지점의 개수입니다.

LatLngBounds

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

필드
southwest

LatLng

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

northeast

LatLng

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

수준

층 번호와 해당 이름을 포함하는 층 정보입니다.

필드
number

double

선택사항입니다. 주문 시 사용되는 층 번호입니다. 0은 지면을 나타내고 1은 지면보다 높은 첫 번째 층을 나타내며 -1은 지면 아래의 첫 번째 층을 나타냅니다. 정수가 아닌 값은 괜찮습니다.

name

string

필수 항목입니다. 이 레벨에 할당된 이름이며, 3자(영문 기준)로 제한됩니다. 엘리베이터가 있다면 이 층의 승강기 버튼에 어떻게 라벨을 지정할지 생각해 보세요.

ListPhotoSequencesRequest

요청을 전송하는 사용자에게 속한 모든 사진 시퀀스를 나열하도록 요청합니다.

매개변수:

  • pageSize는 반환할 사진 시퀀스의 최대 개수를 결정합니다.
  • pageToken는 이전 ListPhotoSequences 요청에서 반환된 다음 페이지 토큰 값입니다(있는 경우).
필드
page_size

int32

선택사항입니다. 반환할 사진 시퀀스의 최대 개수입니다. pageSize은 음수가 아니어야 합니다. pageSize가 0이거나 제공되지 않으면 기본 페이지 크기인 100이 사용됩니다. 일치 항목 수가 pageSize 미만인 경우 응답에 반환되는 사진 시퀀스의 수가 pageSize보다 작을 수도 있습니다. 이는 현재 구현되지 않았지만 처리 중입니다.

page_token

string

선택사항입니다. 이전 ListPhotoSequences 요청에서 반환된 nextPageToken 값입니다(있는 경우).

filter

string

선택사항입니다. 필터 표현식입니다. 예를 들면 imagery_type=SPHERICAL입니다.

지원되는 필터는 imagery_type, processing_state, min_latitude, max_latitude, min_longitude, max_longitude, filename_query, min_capture_time_seconds, `max_capture_time_seconds입니다. 자세한 내용은 https://google.aip.dev/160을 참고하세요. 여러 단어 및 특수문자를 지원하려면 이스케이프된 따옴표를 추가하여 파일 이름 검색어를 구문으로 전송해야 합니다. 예: filename_query="example of aphrase.mp4"

ListPhotoSequencesResponse

사용자에게 속한 모든 사진 시퀀스를 나열하기 위한 응답입니다.

필드
photo_sequences[]

Operation

Operation 인터페이스를 통한 사진 시퀀스 목록입니다.

반환되는 최대 항목 수는 요청의 pageSize 필드를 기준으로 합니다.

목록의 각 항목은 세 가지 상태를 가질 수 있습니다.

  • Operation.done = false: PhotoSequence 처리가 아직 완료되지 않은 경우
  • 처리 중에 오류가 발생한 경우 Operation.done = true이고 Operation.error가 채워집니다.
  • Operation.done = true이고 Operation.responsePhotoSequence 메시지를 포함합니다. 각 시퀀스에서 Id만 채워집니다.
next_page_token

string

결과의 다음 페이지를 검색하는 토큰으로, 목록에 결과가 더 이상 없으면 비어 있습니다.

ListPhotosRequest

요청을 전송하는 사용자의 모든 사진을 나열하도록 요청합니다.

기본적으로

  • 는 사진 바이트에 대한 다운로드 URL을 반환하지 않습니다.

매개변수:

  • view는 사진 바이트의 다운로드 URL의 반환 여부를 제어합니다.
  • pageSize는 반환할 최대 사진 수를 결정합니다.
  • pageToken는 이전 ListPhotos 요청에서 반환된 다음 페이지 토큰 값입니다(있는 경우).
  • filter는 지정된 매개변수로 필터링할 수 있습니다. 현재 지원되는 유일한 매개변수는 'placeId'입니다.
필드
view

PhotoView

필수 항목입니다. 포토 응답에서 사진 바이트의 다운로드 URL을 반환해야 하는지 여부를 지정합니다.

page_size

int32

선택사항입니다. 반환할 최대 사진 수입니다. pageSize은 음수가 아니어야 합니다. pageSize가 0이거나 제공되지 않으면 기본 페이지 크기인 100이 사용됩니다. 사용자에게 속한 사진 수가 pageSize보다 적으면 응답에 반환되는 사진 수가 pageSize보다 작을 수 있습니다.

page_token

string

선택사항입니다. 이전 ListPhotos 요청에서 반환된 nextPageToken 값입니다(있는 경우).

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를 참조하세요. language_code가 지정되지 않으면 Google 서비스에서 사용자의 언어 환경설정이 사용됩니다.

ListPhotosResponse

사용자에게 속한 모든 사진을 나열하기 위한 응답입니다.

필드
photos[]

Photo

사진 목록입니다. 요청의 pageSize 필드는 반환되는 항목 수를 결정합니다.

next_page_token

string

결과의 다음 페이지를 검색하는 토큰으로, 목록에 결과가 더 이상 없으면 비어 있습니다.

NoOverlapGpsFailureDetails

PhotoSequence ProcessingFailureReason#NO_OVERLAP_GPS와 관련된 세부정보입니다.

필드
gps_start_time

Timestamp

처음 기록된 GPS 지점의 시간입니다.

gps_end_time

Timestamp

마지막으로 기록된 GPS 지점의 시간입니다.

video_start_time

Timestamp

동영상의 시작 시간입니다.

video_end_time

Timestamp

동영상 종료 시간입니다.

NotOutdoorsFailureDetails

ProcessingFailureReason#NOT_OUTDOORS와 관련된 세부정보입니다. 실내 프레임이 여러 개 있는 경우 첫 번째 프레임이 여기에 기록됩니다.

필드
start_time

Duration

실내 프레임이 발견된 경우의 상대 시간입니다 (동영상 스트림 시작 부분부터).

사진

사진은 사진 메타데이터와 함께 360도 파노라마 사진을 저장하는 데 사용됩니다.

필드
photo_id

PhotoId

필수 항목입니다. 출력 전용. 사진을 업데이트할 때 필요합니다. 사진을 만들 때만 출력합니다. 사진의 식별자로, Google에 있는 모든 사진 중에서 고유합니다.

upload_reference

UploadRef

입력 전용. 사진을 만들 때 필요합니다. 입력 전용. 사진 바이트가 업로드된 리소스 URL입니다.

download_url

string

출력 전용. 사진 바이트의 다운로드 URL입니다. 이 필드는 GetPhotoRequest.viewPhotoView.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 지도의 상태입니다.

MapsPublishStatus

Google 지도에 있는 사진의 게시 상태입니다.

열거형
UNSPECIFIED_MAPS_PUBLISH_STATUS 사진의 상태를 알 수 없습니다.
PUBLISHED 사진이 Google 지도를 통해 공개되었습니다.
REJECTED_UNKNOWN 알 수 없는 이유로 사진이 거부되었습니다.

TransferStatus

권리 이전 상태입니다.

열거형
TRANSFER_STATUS_UNKNOWN 이 전송의 상태가 지정되지 않았습니다.
NEVER_TRANSFERRED 전송된 적이 없는 사진입니다.
PENDING 사진 전송이 시작되었지만 수신자가 아직 응답하지 않았습니다.
COMPLETED 사진 전송이 완료되어 사진이 수신자에게 전송되었습니다.
REJECTED 수신자가 사진 전송을 거부했습니다.
EXPIRED 수신자가 조치를 취하기 전에 사진 전송이 만료되었습니다.
CANCELLED 발신자가 사진 전송을 취소했습니다.
RECEIVED_VIA_TRANSFER 권리 이전으로 인해 수신자가 이 사진을 소유하고 있습니다.

PhotoId

Photo의 식별자입니다.

필드
id

string

사진의 고유 식별자입니다.

PhotoResponse

BatchGetPhotosBatchUpdatePhotos를 포함한 일괄 작업에서 단일 Photo에 대한 응답 페이로드

필드
status

Status

일괄 요청에서 사진 1장을 가져오거나 업데이트하는 작업의 상태입니다.

photo

Photo

Photo 리소스(요청이 성공한 경우)

PhotoSequence

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

필드
id

string

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

photos[]

Photo

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

upload_reference

UploadRef

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

capture_time_override

Timestamp

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

upload_time

Timestamp

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

raw_gps_timeline[]

Pose

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

gps_source

GpsSource

입력 전용. 원시_gps_timeline 및 카메라 모션 메타데이터 트랙 (CAMM)에 모두 GPS 측정이 포함되어 있는 경우 어느 것이 우선하는지 표시합니다.

imu

Imu

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

processing_state

ProcessingState

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

failure_reason

ProcessingFailureReason

출력 전용. 이 시퀀스의 Processing_state = FAILED(처리_상태 = FAILED)에는 실패 이유가 포함됩니다. Processing_state가 다른 값이면 이 필드가 설정 해제됩니다.

failure_details

ProcessingFailureDetails

출력 전용. 이 시퀀스에 failure_reason가 설정된 경우 실패에 관한 추가 세부정보가 포함될 수 있습니다.

distance_meters

double

출력 전용. 사진 시퀀스에서 계산된 거리(미터)입니다.

sequence_bounds

LatLngBounds

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

view_count

int64

출력 전용. 이 PhotoSequence의 모든 게시된 이미지에서 발생한 총 조회수입니다.

filename

string

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

GpsSource

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

열거형
PHOTO_SEQUENCE raw_gps_timeline의 GPS가 있는 경우 우선합니다.
CAMERA_MOTION_METADATA_TRACK CAMM (카메라 모션 메타데이터 트랙)의 GPS가 있는 경우 우선 적용됩니다.

PhotoView

응답에 포함할 Photo의 뷰를 지정합니다.

열거형
BASIC 서버 응답에 사진 바이트의 다운로드 URL이 포함되지 않습니다. 기본값입니다.
INCLUDE_DOWNLOAD_URL 서버 응답에는 사진 바이트의 다운로드 URL이 포함됩니다.

순위

항목의 배치 메타데이터입니다.

필드
place_id

string

https://developers.google.com/places/place-id에 설명된 장소 식별자입니다.

name

string

출력 전용. language_code로 현지화된 장소 이름입니다.

language_code

string

출력 전용. 이름이 현지화되는 language_code입니다. 요청에 지정된 language_code여야 하지만 대체일 수 있습니다.

자세

항목의 원시 포즈 측정

필드
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

UTC 에포크 이후 GPS 기록 시간입니다.

level

Level

수직 탐색을 구성하는 데 사용되는 층 (건물의 층)입니다.

accuracy_meters

float

신뢰도가 68% 인 이 포즈의 예상 수평 정확도(미터 단위)입니다(표준 편차 1개). 예를 들어 Android에서는 https://developer.android.com/reference/android/location/Location#getAccuracy() 메서드에서 이 값을 사용할 수 있습니다. 다른 플랫폼에는 유사한 정확도 추정을 가져오는 여러 메서드가 있습니다.

ProcessingFailureDetails

ProcessingFailureReason enum과 함께 제공되는 추가 세부정보입니다. 이 메시지는 항상 ProcessingFailureReason과 함께 사용되어야 하며 이 메시지에 설정된 값 중 하나는 FailureReason과 일치해야 합니다.

필드
통합 필드 details. 하나의 세부정보 세트만 설정되며 ProcessingFailureReason의 해당 enum과 일치해야 합니다. 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를 참고하세요.

ProcessingFailureReason

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 또는 시간)이 누락되었거나, 형식이 올바르게 지정되지 않았거나, Google 시스템에서 파싱할 수 없는 문제가 발생했을 수 있습니다.
INSUFFICIENT_IMU IMU 포인트가 너무 적습니다.
INSUFFICIENT_OVERLAP_TIME_SERIES GPS, IMU 및 기타 시계열 데이터 간의 시간 프레임이 충분하지 않습니다.
IMU_DATA_GAP IMU (가속도계, 자이로스코프 등) 데이터에 0.1초가 넘는 시간 간격이 포함되어 있습니다.
UNSUPPORTED_CAMERA 지원되지 않는 카메라입니다.
NOT_OUTDOORS 일부 프레임은 실내에 있었으며 이는 지원되지 않습니다.
INSUFFICIENT_VIDEO_FRAMES 동영상 프레임이 충분하지 않습니다.
INSUFFICIENT_MOVEMENT 데이터 이동이 충분하지 않습니다.

ProcessingState

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

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

시퀀스는 임의의 상태에서 FAILED 상태로 이동할 수 있습니다. 또한 처리된 시퀀스는 언제든지 재처리될 수 있습니다.

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

UpdatePhotoRequest

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에 반복되는 필드가 포함되어 있으면 반복되는 값의 전체 세트가 새 콘텐츠로 바뀝니다. 예를 들어 updateMaskconnections이 포함되어 있고 UpdatePhotoRequest.photo.connections가 비어 있으면 모든 연결이 삭제됩니다.

UploadRef

미디어 파일용 참조 업로드

필드
통합 필드 file_source. 필수 항목입니다. file_source은 다음 중 하나여야 합니다.
upload_url

string

업로드 참조는 사용자마다 고유해야 합니다. 'https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}' 형식을 따릅니다.