REST Resource: 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 ระบบจะใช้การตั้งค่าการประทับเวลาในข้อมูลเมตาของรูปภาพ

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
uploadTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่อัปโหลดรูปภาพ

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
places[]

object (Place)

ไม่บังคับ สถานที่ที่มีรูปภาพนี้
viewCount

string (int64 format)

เอาต์พุตเท่านั้น จำนวนการดูรูปภาพ
transferStatus

enum (TransferStatus)

เอาต์พุตเท่านั้น สถานะการโอนสิทธิ์ในรูปภาพนี้
mapsPublishStatus

enum (MapsPublishStatus)

เอาต์พุตเท่านั้น สถานะใน Google Maps ระบุว่ารูปภาพนี้เผยแพร่หรือปฏิเสธไปแล้ว

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)

เวลาของระเบียน GPS ตั้งแต่ UTC Epoch

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
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

เอาต์พุตเท่านั้น รหัสภาษาที่ใช้แปลชื่อ ซึ่งควรเป็นรหัสภาษาที่ระบุไว้ในคำขอ แต่อาจเป็นรหัสสำรอง

TransferStatus

สถานะการโอนสิทธิ์

Enum
TRANSFER_STATUS_UNKNOWN ไม่มีการระบุสถานะของการโอนนี้
NEVER_TRANSFERRED รูปภาพนี้ไม่เคยได้รับการโอน
PENDING เริ่มการโอนรูปภาพนี้แล้ว แต่ผู้รับยังไม่ตอบกลับ
COMPLETED การโอนรูปภาพเสร็จสมบูรณ์ และระบบได้โอนรูปภาพนี้ไปยังผู้รับแล้ว
REJECTED ผู้รับปฏิเสธการโอนรูปภาพนี้
EXPIRED การโอนรูปภาพหมดอายุก่อนที่ผู้รับจะดำเนินการใดๆ
CANCELLED ผู้ส่งยกเลิกการโอนรูปภาพนี้
RECEIVED_VIA_TRANSFER ผู้รับเป็นเจ้าของรูปภาพนี้เนื่องจากมีการโอนสิทธิ์

MapsPublishStatus

สถานะการเผยแพร่ของรูปภาพใน Google Maps

Enum
UNSPECIFIED_MAPS_PUBLISH_STATUS ไม่ทราบสถานะของรูปภาพ
PUBLISHED รูปภาพได้รับการเผยแพร่ต่อสาธารณะผ่าน Google Maps
REJECTED_UNKNOWN รูปภาพถูกปฏิเสธโดยไม่ทราบสาเหตุ

เมธอด

create

 หลังจากที่ลูกค้าอัปโหลดรูปภาพที่มี UploadRef ที่ส่งกลับมาเรียบร้อยแล้ว CreatePhoto จะเผยแพร่ Photo ที่อัปโหลดลงใน Street View ใน Google Maps

delete

 ลบ Photo และข้อมูลเมตา

get

 รับข้อมูลเมตาของ Photo ที่ระบุ

startUpload

 สร้างเซสชันการอัปโหลดเพื่อเริ่มการอัปโหลดไบต์ของรูปภาพ

update

 อัปเดตข้อมูลเมตาของ Photo เช่น ท่าทาง การเชื่อมโยงสถานที่ การเชื่อมต่อ และอื่นๆ