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의 메타데이터를 가져옵니다.

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

  • PhotoSequence의 처리가 아직 완료되지 않은 경우 Operation.done = false입니다.
  • 처리 중에 오류가 발생하면 Operation.done = true이며 Operation.error가 채워집니다.
  • Operation.done = true이고 Operation.response가 시뮬레이션되며 PhotoSequence 메시지가 포함됩니다.

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

승인 범위

다음 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

사진 시퀀스의 다운로드 URL을 PhotoSequence 응답에서 개별 사진의 download_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

기기 센서의 IMU 데이터

필드
accel_mpsps[]

Measurement3d

가속도계 측정값(미터/초^2)이며 기기에서 타임스탬프가 증가함

gyro_rps[]

Measurement3d

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

mag_ut[]

Measurement3d

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

3일 측정

일반 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="구문.mp4의 예"

ListPhotoSequencesResponse

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

필드
photo_sequences[]

Operation

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

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

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

  • PhotoSequence의 처리가 아직 완료되지 않은 경우 Operation.done = false입니다.
  • 처리 중에 오류가 발생하면 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

PhotoSequenceProcessingFailureReason#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

BatchGetPhotos, BatchUpdatePhotos 등의 일괄 작업에서 단일 Photo의 응답 페이로드입니다.

필드
status

Status

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

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 측정값과 카메라 모션 메타데이터 트랙 (CAMM)에 모두 제공되는 경우 사용자는 gps_source를 사용하여 우선 순위를 표시할 수 있습니다.

gps_source

GpsSource

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

imu

Imu

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

processing_state

ProcessingState

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

failure_reason

ProcessingFailureReason

출력 전용입니다. 이 시퀀스에 process_state = FAILED가 있는 경우 실패 이유가 포함됩니다. Processing_state가 다른 값인 경우 이 필드가 설정 해제됩니다.

failure_details

ProcessingFailureDetails

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

distance_meters

double

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

sequence_bounds

LatLngBounds

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

view_count

int64

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

filename

string

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

GpsSource

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

열거형
PHOTO_SEQUENCE 원본_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 열거형에 수반되는 추가 세부정보입니다. 이 메시지는 항상 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}'와 같습니다.