REST Resource: photo

리소스: Photo

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

JSON 표현 
{
  "photoId": {
    object (PhotoId)
  },
  "uploadReference": {
    object (UploadRef)
  },
  "downloadUrl": string,
  "thumbnailUrl": string,
  "shareLink": string,
  "pose": {
    object (Pose)
  },
  "connections": [
    {
      object (Connection)
    }
  ],
  "captureTime": string,
  "uploadTime": string,
  "places": [
    {
      object (Place)
    }
  ],
  "viewCount": string,
  "transferStatus": enum (TransferStatus),
  "mapsPublishStatus": enum (MapsPublishStatus)
}
필드
photoId

object (PhotoId)

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

object (UploadRef)

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

string

출력 전용입니다. 사진 바이트의 다운로드 URL입니다. 이 필드는 GetPhotoRequest.view이 PhotoView.INCLUDE_DOWNLOAD_URL로 설정된 경우에만 설정됩니다.
thumbnailUrl

string

출력 전용입니다. 지정된 사진의 미리보기를 표시하는 썸네일 URL입니다.
pose

object (Pose)

선택사항입니다. 사진의 포즈입니다.
connections[]

object (Connection)

선택사항입니다. 다른 사진과의 연결 연결은 이 사진에서 다른 사진으로 연결되는 링크를 나타냅니다.
captureTime

string (Timestamp format)

선택사항입니다. 사진이 캡처된 절대 시간입니다. 사진에 exif 타임스탬프가 없는 경우 사진 메타데이터에 타임스탬프를 설정하는 데 사용됩니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
uploadTime

string (Timestamp format)

출력 전용입니다. 이미지가 업로드된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
places[]

object (Place)

선택사항입니다. 이 사진이 속한 장소입니다.
viewCount

string (int64 format)

출력 전용입니다. 사진의 조회수입니다.
transferStatus

enum (TransferStatus)

출력 전용입니다. 이 사진의 권리 이전 상태입니다.
mapsPublishStatus

enum (MapsPublishStatus)

출력 전용입니다. Google 지도에서의 상태입니다. 사진이 게시되었는지 아니면 거부되었는지 나타냅니다.

PhotoId

Photo의 식별자입니다.

JSON 표현 
{
  "id": string
}
필드
id

string

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

UploadRef

미디어 파일의 참조를 업로드합니다.

JSON 표현 
{

  // Union field file_source can be only one of the following:
  "uploadUrl": string
  // End of list of possible types for union field file_source.
}
필드
통합 필드 file_source. 필수 항목입니다. file_source은 다음 중 하나여야 합니다.
uploadUrl

string

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

포즈

항목의 원시 포즈 측정값입니다.

JSON 표현 
{
  "latLngPair": {
    object (LatLng)
  },
  "altitude": number,
  "heading": number,
  "pitch": number,
  "roll": number,
  "gpsRecordTimestampUnixEpoch": string,
  "level": {
    object (Level)
  },
  "accuracyMeters": number
}
필드
latLngPair

object (LatLng)

자세의 위도 및 경도 쌍입니다(https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng 참고). Photo를 만들 때 위도 및 경도 쌍이 제공되지 않으면 exif 헤더의 지리적 위치가 사용됩니다. 사진 또는 exif 헤더에 위도와 경도 쌍이 제공되지 않으면 사진 처리가 실패합니다.
altitude

number

WGS84 타원체 위의 포즈 고도(미터)입니다. NaN은 측정되지 않은 수량을 나타냅니다.
heading

number

다음 포즈 매개변수는 사진의 중심과 관련이 있습니다. https://developers.google.com/streetview/spherical-metadata와 일치합니다. 나침반 방향입니다. 사진의 중앙에서 북쪽을 기준으로 시계 방향으로 측정됩니다(단위: 도). 값은 0 이상 360 미만이어야 합니다. NaN은 측정되지 않은 수량을 나타냅니다.
pitch

number

사진 중앙에서 측정된 피치(단위: 도)입니다. 값은 -90 이상 90 이하여야 합니다. -90은 똑바로 아래를 향하는 것을 의미하고 90은 똑바로 위를 향하는 것을 의미합니다. NaN은 측정되지 않은 수량을 나타냅니다.
roll

number

롤(도 단위)입니다. 값은 0 이상 360 미만이어야 합니다. 0은 지평선과 같은 높이를 의미합니다. NaN은 측정되지 않은 수량을 나타냅니다.
gpsRecordTimestampUnixEpoch

string (Timestamp format)

UTC 에포크 이후의 GPS 레코드 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
level

object (Level)

세로 탐색을 구성하는 데 사용되는 레벨 (건물의 층)입니다.
accuracyMeters

number

이 자세의 추정 수평 정확도(미터)입니다(신뢰도 68%, 표준 편차 1). 예를 들어 Android에서는 https://developer.android.com/reference/android/location/Location#getAccuracy() 메서드에서 이 값을 사용할 수 있습니다. 다른 플랫폼에는 유사한 정확도 추정치를 얻는 다른 방법이 있습니다.

LatLng

위도/경도 쌍을 나타내는 객체로 위도와 경도를 나타내는 복식 쌍으로 표현됩니다. 달리 명시되지 않는 한 이 객체는 WGS84 표준을 준수해야 합니다. 값은 정규화된 범위 내에 있어야 합니다.

JSON 표현 
{
  "latitude": number,
  "longitude": number
}
필드
latitude

number

위도입니다. 범위는 [-90.0, +90.0]입니다.
longitude

number

경도입니다. 범위는 [-180.0, +180.0]입니다.

수준

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

JSON 표현 
{
  "number": number,
  "name": string
}
필드
number

number

선택사항입니다. 주문에 사용되는 층 번호입니다. 0은 지상 수준을 나타내고, 1은 지상 수준 위의 첫 번째 수준을 나타내며, -1은 지상 수준 아래의 첫 번째 수준을 나타냅니다. 정수가 아닌 값도 괜찮습니다.
name

string

필수 항목입니다. 이 레벨에 할당된 이름으로, 3자로 제한됩니다. 엘리베이터가 있는 경우 이 층의 엘리베이터 버튼에 어떤 라벨이 지정될지 고려합니다.

연결

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

JSON 표현 
{
  "target": {
    object (PhotoId)
  }
}
필드
target

object (PhotoId)

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

장소

엔티티의 메타데이터를 배치합니다.

JSON 표현 
{
  "placeId": string,
  "name": string,
  "languageCode": string
}
필드
placeId

string

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

string

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

string

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

TransferStatus

권리 이전 상태입니다.

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

MapsPublishStatus

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

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

메서드

create

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

delete

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

get

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

startUpload

 사진 바이트 업로드를 시작하기 위한 업로드 세션을 만듭니다.

update

 자세, 장소 연결, 연결 등 Photo의 메타데이터를 업데이트합니다.