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

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
uploadTime

string (Timestamp format)

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

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "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 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.
}
ช่อง
ฟิลด์ Union 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 ตั้งแต่ Epoch ของ UTC

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "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

ออบเจ็กต์ที่แสดงคู่ละติจูด/ลองจิจูด โดยจะแสดงเป็นคู่ของ Double เพื่อแสดงองศาละติจูดและองศาลองจิจูด ออบเจ็กต์นี้ต้องเป็นไปตาม มาตรฐาน 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 ที่ระบุในคำขอ แต่ก็อาจเป็นภาษาสำรองได้

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 เช่น ท่าทาง การเชื่อมโยงสถานที่ การเชื่อมต่อ ฯลฯ