리소스: Photo
사진은 사진 메타데이터와 함께 360도 파노라마 사진을 저장하는 데 사용됩니다.
JSON 표현 |
---|
{ "photoId": { object ( |
필드 | |
---|---|
photoId |
필수 항목입니다. 출력 전용. 사진을 업데이트할 때 필요합니다. 사진을 만들 때만 출력됩니다. 사진의 식별자로, Google의 모든 사진에서 고유합니다. |
uploadReference |
입력 전용. 사진을 만들 때 필요합니다. 입력 전용. 사진 바이트가 업로드되는 리소스 URL입니다. |
downloadUrl |
출력 전용. 사진 바이트의 다운로드 URL입니다. 이 필드는 |
thumbnailUrl |
출력 전용. 지정된 사진의 미리보기를 표시하는 썸네일 URL입니다. |
shareLink |
출력 전용. 사진의 공유 링크입니다. |
pose |
선택사항입니다. 사진 포즈. |
connections[] |
선택사항입니다. 다른 사진에 연결 연결은 이 사진에서 다른 사진으로의 링크를 나타냅니다. |
captureTime |
선택사항입니다. 사진이 캡처된 절대 시간입니다. 사진에 EXIF 타임스탬프가 없는 경우 사진 메타데이터에 타임스탬프를 설정하는 데 사용됩니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프(나노초 해상도 및 최대 9자리 소수) 예: |
uploadTime |
출력 전용. 이미지가 업로드된 시간입니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프(나노초 해상도 및 최대 9자리 소수) 예: |
places[] |
선택사항입니다. 사진이 속한 장소입니다. |
viewCount |
출력 전용. 사진 조회수 |
transferStatus |
출력 전용. 이 사진의 권리 이전 상태입니다. |
mapsPublishStatus |
출력 전용. 이 사진이 게시되었는지 또는 거부되었는지에 대한 Google 지도의 상태입니다. |
사진 ID
Photo
의 식별자입니다.
JSON 표현 |
---|
{ "id": string } |
필드 | |
---|---|
id |
사진의 고유 식별자입니다. |
업로드 참조
미디어 파일 참조를 업로드합니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 file_source . 필수 항목입니다. file_source 은 다음 중 하나여야 합니다. |
|
uploadUrl |
업로드 참조는 사용자별로 고유해야 합니다. 'https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}' 형식을 따릅니다. |
자세
항목의 원시 자세 측정입니다.
JSON 표현 |
---|
{ "latLngPair": { object ( |
필드 | |
---|---|
latLngPair |
포즈의 위도 및 경도 쌍은 다음을 참조하세요. https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng |
altitude |
WGS84 타원체 위의 미터 단위 포즈의 고도입니다. NaN은 측정되지 않은 수량을 나타냅니다. |
heading |
다음 포즈 매개변수는 사진의 중심과 관련이 있습니다. https://developers.google.com/streetview/spherical-metadata와 일치합니다. 북쪽에서 시계 방향으로 도 단위로 측정된 나침반 방향입니다. 값은 0보다 크고 360보다 작아야 합니다. NaN은 측정되지 않은 수량을 나타냅니다. |
pitch |
피치로, 사진의 중심에서 도 단위로 측정됩니다. 값은 >=-90 및 <= 90이어야 합니다. -90은 똑바로 아래를 바라보며 90은 바로 위를 향한다는 의미입니다. NaN은 측정되지 않은 수량을 나타냅니다. |
roll |
도 단위로 측정된 롤. 값은 0보다 크고 360보다 작아야 합니다. 값이 0인 경우 수평선이 있는 레벨입니다. NaN은 측정되지 않은 수량을 나타냅니다. |
gpsRecordTimestampUnixEpoch |
UTC 에포크 이후의 GPS 레코드 시간 RFC3339 UTC 'Zulu' 형식의 타임스탬프(나노초 해상도 및 최대 9자리 소수) 예: |
level |
세로 탐색을 구성하는 데 사용되는 층 (건물의 층)입니다. |
accuracyMeters |
이 포즈의 예상 수평 정확도는 68% 이며 신뢰도는 미터입니다 (표준 편차 1개). 예를 들어 Android의 경우 https://developer.android.com/reference/android/location/Location#getAccuracy() 메서드에서 이 값을 사용할 수 있습니다. 다른 플랫폼에는 비슷한 정확성 추정치를 얻는 다양한 방법이 있습니다. |
LatLng
위도/경도 쌍을 나타내는 객체로 위도와 경도를 나타내는 double의 쌍으로 표현됩니다. 달리 명시되지 않는 한 이 객체는 WGS84 표준을 준수해야 합니다. 값은 정규화된 범위 내에 있어야 합니다.
JSON 표현 |
---|
{ "latitude": number, "longitude": number } |
필드 | |
---|---|
latitude |
위도입니다. 범위는 [-90.0, +90.0]입니다. |
longitude |
경도입니다. 범위는 [-180.0, +180.0]여야 합니다. |
수준
등급 번호 및 해당 이름이 포함된 등급 정보입니다.
JSON 표현 |
---|
{ "number": number, "name": string } |
필드 | |
---|---|
number |
선택사항입니다. 층 번호이며 주문에 사용됩니다. 0은 지면 수준, 1은 지상 위의 첫 번째 층, -1은 지상 층의 첫 번째 층을 나타냅니다. 정수가 아닌 값을 사용해도 괜찮습니다. |
name |
필수 항목입니다. 이 레벨에 할당된 이름이며 3자로 제한됩니다. 엘리베이터가 있는 경우 엘리베이터 버튼에 이 층의 라벨을 지정해 보세요. |
연대감
연결은 소스 사진에서 대상 사진으로 연결되는 링크입니다.
JSON 표현 |
---|
{
"target": {
object ( |
필드 | |
---|---|
target |
필수 항목입니다. 포함된 사진에서 다른 사진으로 연결되는 연결입니다. |
장소
항목의 메타데이터를 배치합니다.
JSON 표현 |
---|
{ "placeId": string, "name": string, "languageCode": string } |
필드 | |
---|---|
placeId |
https://developers.google.com/places/place-id에 설명된 장소 식별자입니다. |
name |
출력 전용. languageCode로 현지화된 장소의 이름입니다. |
languageCode |
출력 전용. 이름이 현지화된 languageCode입니다. 요청에 지정된 languageCode여야 하지만 대체일 수 있습니다. |
전송 상태
권리 이전 상태입니다.
열거형 | |
---|---|
TRANSFER_STATUS_UNKNOWN |
이 전송의 상태가 지정되지 않았습니다. |
NEVER_TRANSFERRED |
이 사진은 전송된 적이 없습니다. |
PENDING |
사진 전송이 시작되었지만 수신자가 아직 응답하지 않았습니다. |
COMPLETED |
사진 전송이 완료되었으며 수신자에게 사진이 전송되었습니다. |
REJECTED |
수신자가 이 사진 전송을 거부했습니다. |
EXPIRED |
수신자가 다른 작업을 하기 전에 사진 전송이 만료되었습니다. |
CANCELLED |
발신자가 이 사진 전송을 취소했습니다. |
RECEIVED_VIA_TRANSFER |
권리 이전으로 인해 수신자가 사진을 소유합니다. |
지도 게시 상태
Google 지도에 표시된 사진의 게시 상태입니다.
열거형 | |
---|---|
UNSPECIFIED_MAPS_PUBLISH_STATUS |
사진 상태를 알 수 없습니다. |
PUBLISHED |
사진이 Google 지도를 통해 공개적으로 게시됩니다. |
REJECTED_UNKNOWN |
알 수 없는 이유로 사진이 거부되었습니다. |
방법 |
|
---|---|
|
클라이언트가 반환된 UploadRef 를 사용하여 사진 업로드를 완료하면 CreatePhoto 는 업로드된 Photo 을 Google 지도의 스트리트 뷰에 게시합니다. |
|
Photo 및 관련 메타데이터를 삭제합니다. |
|
지정된 Photo 의 메타데이터를 가져옵니다. |
|
사진 바이트 업로드를 시작하는 업로드 세션을 만듭니다. |
|
포즈, 장소 연결, 연결 등 Photo 의 메타데이터를 업데이트합니다. |