- แหล่งข้อมูล: รูปภาพ
- รหัสรูปภาพ
- การอัปโหลดการอ้างอิง
- ท่าทาง
- ละ/ลอง
- ระดับ
- การเชื่อมต่อ
- สถานที่
- TransferStatus
- MapsPublishStatus
- เมธอด
แหล่งข้อมูล: ภาพถ่าย
ระบบใช้รูปภาพเพื่อจัดเก็บภาพมุมมอง 360 พร้อมกับข้อมูลเมตาของรูปภาพ
การแสดง JSON |
---|
{ "photoId": { object ( |
ช่อง | |
---|---|
photoId |
ต้องระบุ เอาต์พุตเท่านั้น ต้องระบุเมื่ออัปเดตรูปภาพ แสดงผลลัพธ์เมื่อมีการสร้างรูปภาพเท่านั้น ตัวระบุรูปภาพซึ่งไม่ซ้ํากันในรูปภาพทั้งหมดใน Google |
uploadReference |
อินพุตเท่านั้น ต้องระบุเมื่อสร้างรูปภาพ อินพุตเท่านั้น URL ของแหล่งข้อมูลที่มีการอัปโหลดไบต์ของรูปภาพ |
downloadUrl |
เอาต์พุตเท่านั้น URL การดาวน์โหลดสําหรับไบต์ของรูปภาพ ช่องนี้จะถูกตั้งค่าเมื่อตั้งค่า |
thumbnailUrl |
เอาต์พุตเท่านั้น URL ของภาพขนาดย่อสําหรับการแสดงพรีวิวรูปภาพที่ระบุ |
shareLink |
เอาต์พุตเท่านั้น ลิงก์สําหรับแชร์ของรูปภาพ |
pose |
ไม่บังคับ วางรูปภาพ |
connections[] |
ไม่บังคับ การเชื่อมต่อกับรูปภาพอื่นๆ การเชื่อมต่อจะแสดงลิงก์จากรูปภาพนี้ไปยังรูปภาพอื่น |
captureTime |
ไม่บังคับ เวลาจริงที่ถ่ายภาพ เมื่อรูปภาพไม่มีการประทับเวลา Exex จะใช้การประทับเวลาในข้อมูลเมตาของรูปภาพ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "ซูลู" ที่มีความละเอียดนาโนวินาทีและตัวเลขเศษไม่เกิน 9 หลัก ตัวอย่าง: |
uploadTime |
เอาต์พุตเท่านั้น เวลาที่อัปโหลดรูปภาพ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "ซูลู" ที่มีความละเอียดนาโนวินาทีและตัวเลขเศษไม่เกิน 9 หลัก ตัวอย่าง: |
places[] |
ไม่บังคับ สถานที่ที่มีรูปภาพนี้ |
viewCount |
เอาต์พุตเท่านั้น จํานวนการดูรูปภาพ |
transferStatus |
เอาต์พุตเท่านั้น สถานะการโอนสิทธิ์ในรูปภาพนี้ |
mapsPublishStatus |
เอาต์พุตเท่านั้น สถานะใน Google Maps ไม่ว่าจะเป็นรูปภาพที่เผยแพร่หรือถูกปฏิเสธ |
รหัสรูปภาพ
ตัวระบุสําหรับ Photo
การแสดง JSON |
---|
{ "id": string } |
ช่อง | |
---|---|
id |
ตัวระบุที่ไม่ซ้ํากันสําหรับรูปภาพ |
การอัปโหลดที่อ้างถึง
อัปโหลดข้อมูลอ้างอิงสําหรับไฟล์สื่อ
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่อง Union 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 แนนจะระบุปริมาณที่ไม่ได้วัด |
heading |
พารามิเตอร์ท่าทางต่อไปนี้เกี่ยวข้องกับกึ่งกลางของรูปภาพ พารามิเตอร์เหล่านี้จะตรงกับ https://developers.google.com/streetview/spherical-metadata ทิศทางของเข็มทิศ ซึ่งวัดที่กึ่งกลางรูปภาพแบบองศาตามเข็มนาฬิกาจากทิศเหนือ ค่าต้องเท่ากับ >=0 และ <360 แนนจะระบุปริมาณที่ไม่ได้วัด |
pitch |
ระดับความสูงต่ํา วัดที่กึ่งกลางของรูปภาพเป็นองศา ค่าต้องเท่ากับ >=-90 และ <= 90 ค่า -90 หมายถึงการมองลงโดยตรง และค่า 90 หมายถึงการมองขึ้นโดยตรง แนนจะระบุปริมาณที่ไม่ได้วัด |
roll |
ม้วน วัดเป็นองศา ค่าต้องเท่ากับ >= 0 และ <360 ค่า 0 หมายถึงระดับที่มีแนวเส้นขอบฟ้า แนนจะระบุปริมาณที่ไม่ได้วัด |
gpsRecordTimestampUnixEpoch |
เวลาของบันทึก GPS ตั้งแต่ UTC Epoch การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "ซูลู" ที่มีความละเอียดนาโนวินาทีและตัวเลขเศษไม่เกิน 9 หลัก ตัวอย่าง: |
level |
ระดับ (ชั้นในอาคาร) ที่ใช้เพื่อกําหนดค่าการนําทางแนวตั้ง |
accuracyMeters |
ความแม่นยําของตําแหน่งโดยประมาณนี้ในหน่วยเมตรด้วยความมั่นใจ 68% (ค่าเบี่ยงเบนมาตรฐาน 1) เช่น ใน Android ค่านี้จะใช้วิธีนี้ได้จาก https://developer.android.com/reference/android/location/Location#getAccuracy() ส่วนแพลตฟอร์มอื่นๆ จะมีวิธีการหาค่าประมาณความถูกต้องที่คล้ายกันแตกต่างกันไป |
ละติจูดและลองจิจูด
วัตถุที่แสดงคู่ละติจูด/ลองจิจูด ซึ่งจะแสดงเป็นคู่ของค่าสองเท่าเพื่อแสดงละติจูดองศาและลองจิจูดองศา ออบเจ็กต์นี้ต้องเป็นไปตาม มาตรฐาน 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 ที่ระบุในคําขอ แต่สามารถเป็นทางเลือกได้ |
สถานะการโอน
สถานะการโอนสิทธิ์
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 |
รูปภาพถูกปฏิเสธโดยไม่ทราบสาเหตุ |
วิธีการ |
|
---|---|
|
หลังจากที่ลูกค้าอัปโหลดรูปภาพที่มี UploadRef เสร็จแล้ว CreatePhoto จะเผยแพร่ภาพ Photo ที่อัปโหลดไปยัง Street View บน Google Maps |
|
ลบ Photo และข้อมูลเมตา |
|
รับข้อมูลเมตาของ Photo ที่ระบุ |
|
สร้างเซสชันการอัปโหลดเพื่อเริ่มอัปโหลดไบต์รูปภาพ |
|
อัปเดตข้อมูลเมตาของ Photo เช่น ท่าทาง การเชื่อมโยงสถานที่ การเชื่อมต่อ ฯลฯ |