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)

ไม่บังคับ เวลาจริงที่ถ่ายภาพ เมื่อรูปภาพไม่มีการประทับเวลา Exex จะใช้การประทับเวลาในข้อมูลเมตาของรูปภาพ

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

string (Timestamp format)

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

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "ซูลู" ที่มีความละเอียดนาโนวินาทีและตัวเลขเศษไม่เกิน 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 ไม่ว่าจะเป็นรูปภาพที่เผยแพร่หรือถูกปฏิเสธ

รหัสรูปภาพ

ตัวระบุสําหรับ Photo

การแสดง JSON 
{
  "id": string
}
ช่อง
id

string

ตัวระบุที่ไม่ซ้ํากันสําหรับรูปภาพ

การอัปโหลดที่อ้างถึง

อัปโหลดข้อมูลอ้างอิงสําหรับไฟล์สื่อ

การแสดง 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 แนนจะระบุปริมาณที่ไม่ได้วัด
heading

number

พารามิเตอร์ท่าทางต่อไปนี้เกี่ยวข้องกับกึ่งกลางของรูปภาพ พารามิเตอร์เหล่านี้จะตรงกับ https://developers.google.com/streetview/spherical-metadata ทิศทางของเข็มทิศ ซึ่งวัดที่กึ่งกลางรูปภาพแบบองศาตามเข็มนาฬิกาจากทิศเหนือ ค่าต้องเท่ากับ >=0 และ <360 แนนจะระบุปริมาณที่ไม่ได้วัด
pitch

number

ระดับความสูงต่ํา วัดที่กึ่งกลางของรูปภาพเป็นองศา ค่าต้องเท่ากับ >=-90 และ <= 90 ค่า -90 หมายถึงการมองลงโดยตรง และค่า 90 หมายถึงการมองขึ้นโดยตรง แนนจะระบุปริมาณที่ไม่ได้วัด
roll

number

ม้วน วัดเป็นองศา ค่าต้องเท่ากับ >= 0 และ <360 ค่า 0 หมายถึงระดับที่มีแนวเส้นขอบฟ้า แนนจะระบุปริมาณที่ไม่ได้วัด
gpsRecordTimestampUnixEpoch

string (Timestamp format)

เวลาของบันทึก GPS ตั้งแต่ UTC Epoch

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "ซูลู" ที่มีความละเอียดนาโนวินาทีและตัวเลขเศษไม่เกิน 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() ส่วนแพลตฟอร์มอื่นๆ จะมีวิธีการหาค่าประมาณความถูกต้องที่คล้ายกันแตกต่างกันไป

ละติจูดและลองจิจูด

วัตถุที่แสดงคู่ละติจูด/ลองจิจูด ซึ่งจะแสดงเป็นคู่ของค่าสองเท่าเพื่อแสดงละติจูดองศาและลองจิจูดองศา ออบเจ็กต์นี้ต้องเป็นไปตาม มาตรฐาน 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

string

เอาต์พุตเท่านั้น รหัสภาษาที่มีการแปลชื่อ ค่านี้ควรเป็น languageCode ที่ระบุในคําขอ แต่สามารถเป็นทางเลือกได้

สถานะการโอน

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

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

สถานะการเผยแพร่แผนที่

สถานะการเผยแพร่ของรูปภาพใน 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 เช่น ท่าทาง การเชื่อมโยงสถานที่ การเชื่อมต่อ ฯลฯ