REST Resource: photo

{
  "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)
}

object (PhotoId)

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

object (UploadRef)

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

string

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

string

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

string

출력 전용. 사진 공유 링크입니다.

object (Pose)

선택사항. 사진 자세를 취합니다.

object (Connection)

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

string (Timestamp format)

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

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

string (Timestamp format)

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

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

object (Place)

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

string (int64 format)

출력 전용. 사진 조회수

enum (TransferStatus)

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

enum (MapsPublishStatus)

출력 전용. Google 포토 내 상태(사진 게시 또는 거부 여부)

{
  "id": string
}

string

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

{
  "uploadUrl": string
}

string

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

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

object (LatLng)

https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng에서 설명된 것처럼 포즈의 위도 및 경도 쌍입니다. Photo을 생성할 때 위도와 경도 쌍이 제공되지 않으면 exif 헤더의 위치정보가 사용됩니다. 사진 또는 exif 헤더에 위도 및 경도 쌍이 없으면 사진 처리가 실패합니다.

number

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

number

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

number

피치, 사진의 중앙에서 도 단위로 측정됨 값은 >=-90 및 <= 90이어야 합니다. 값 -90은 직접 아래를 바라보며 값이 90이면 직접 위를 바라보는 것을 의미합니다. NaN은 측정되지 않은 수량을 나타냅니다.

number

롤(도 단위) 값은 >= 0 &360이어야 합니다. 값이 0이면 지평선이 있는 수준입니다. NaN은 측정되지 않은 수량을 나타냅니다.

string (Timestamp format)

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

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

object (Level)

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

number

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

{
  "latitude": number,
  "longitude": number
}

number

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

number

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

{
  "number": number,
  "name": string
}

number

선택사항. 층수이며 주문에 사용됩니다. 0은 지면 층을, 1은 지상 위의 첫 번째 층을, -1은 지상 층 아래의 첫 번째 층을 나타냅니다. 정수가 아닌 값은 허용됩니다.

string

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

{
  "target": {
    object (PhotoId)
  }
}

object (PhotoId)

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

{
  "placeId": string,
  "name": string,
  "languageCode": string
}

string

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

string

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

string

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