ข้อมูลเมตาของรูปภาพ Street View

บทนำ

คำขอข้อมูลเมตาของ Street View Static API จะแสดงข้อมูลเกี่ยวกับภาพพาโนรามาของ Street View การใช้ข้อมูลเมตาช่วยให้คุณทราบว่ามีรูปภาพ Street View ที่ตำแหน่งหนึ่งๆ หรือไม่ รวมถึงรับสิทธิ์เข้าถึงแบบเป็นโปรแกรมสำหรับพิกัดละติจูดและลองจิจูด รหัสภาพพาโนรามา วันที่ถ่ายภาพ และข้อมูลลิขสิทธิ์ของรูปภาพ การเข้าถึงข้อมูลเมตานี้ช่วยให้คุณปรับแต่งลักษณะการทํางานของข้อผิดพลาดในแอปพลิเคชันได้

คำขอข้อมูลเมตาของ Street View Static API ไม่มีค่าใช้จ่าย ระบบจะไม่ใช้โควต้าเมื่อคุณขอข้อมูลเมตา ระบบจะใช้โควต้าก็ต่อเมื่อคุณโหลดรูปภาพโดยใช้ Street View Static API เท่านั้น

เมื่อส่งคำขอข้อมูลเมตาของภาพ Street View ภาพพาโนรามาจะมีความแม่นยำถึง 50 เมตร

เข้าถึงข้อมูลเมตาของภาพ

คำขอข้อมูลเมตารูปภาพ Street View คือ HTTP URL ในรูปแบบต่อไปนี้

https://maps.googleapis.com/maps/api/streetview/metadata?parameters

พารามิเตอร์ทั้งหมดจะคั่นด้วยเครื่องหมายแอมเพอร์แซนด์ (&) ตามมาตรฐานใน URL

พารามิเตอร์ที่จำเป็นสำหรับคำขอข้อมูลเมตา

คำขอข้อมูลเมตาจะยอมรับพารามิเตอร์ URL เดียวกันกับคำขอภาพ Street View Static API แม้ว่าจะต้องใช้พารามิเตอร์ต่อไปนี้เท่านั้น

ดังนี้

  • location — อาจเป็นสตริงข้อความ (เช่น Chagrin Falls, OH) หรือคู่พิกัดละติจูดและลองจิจูดที่คั่นด้วยคอมมา (40.457375,-80.009353)

หรือ

  • pano — รหัสพาโนรามาที่เฉพาะเจาะจง ภาพพาโนรามาอาจเปลี่ยนรหัสเมื่อเวลาผ่านไป ดังนั้นอย่าเก็บรหัสนี้ไว้ แต่ให้บันทึกที่อยู่ของสถานที่หรือพิกัดละติจูดและลองจิจูดแทนเพื่อให้รีเฟรชรหัสภาพพาโนรามาได้ โปรดดูรายละเอียดที่รีเฟรชรหัสภาพพาโนรามาที่ลบไปแล้ว

รวมถึง

  • key และ signature - ต้องระบุคีย์ API เพื่อตรวจสอบสิทธิ์คำขอ นอกจากนี้ คุณยังต้องใช้ลายเซ็นดิจิทัลในบางกรณีและเราขอแนะนำให้ใช้เสมอ ดูข้อมูลเพิ่มเติมได้ที่รับคีย์และลายเซ็น

คำขอข้อมูลเมตาที่มีเฉพาะพารามิเตอร์ที่จำเป็นจะมีลักษณะดังนี้

https://maps.googleapis.com/maps/api/streetview/metadata?location=&key=YOUR_API_KEY&signature=

หรือทำดังนี้

https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=

รีเฟรชรหัสภาพพาโนรามาที่ลบไปแล้ว

หากคุณพยายามเรียกข้อมูลรหัสพาโนรามาและได้รับค่า ZERO_RESULTS หรือไม่มีค่า แสดงว่ารหัสพาโนรามาถูกลบไปแล้วและต้องรีเฟรช

  1. บันทึกที่อยู่หรือพิกัดละติจูดและลองจิจูดของสถานที่ที่คุณใช้รับรหัสภาพพาโนรามาเพื่อให้รีเฟรชได้เมื่อจำเป็น

  2. เมื่อตรวจพบว่ารหัสภาพพาโนรามามีการเปลี่ยนแปลง ให้ใช้ที่อยู่ตำแหน่งเดิมหรือพิกัดละติจูดและลองจิจูดเพื่อค้นหาภาพพาโนรามาที่ใกล้ที่สุดกับตำแหน่งนั้นอีกครั้งและรับรหัสภาพพาโนรามาใหม่

พารามิเตอร์ที่ไม่บังคับสำหรับคำขอข้อมูลเมตา

คุณสามารถใส่พารามิเตอร์ต่อไปนี้ในคำขอข้อมูลเมตาได้ size, heading, fov และ pitch โปรดทราบว่าพารามิเตอร์เหล่านี้ไม่มีผลต่อข้อมูลเกี่ยวกับภาพพาโนรามาหรือภาพพาโนรามาที่พบ API อนุญาตให้รวมพารามิเตอร์เดียวกับคำขอภาพเพื่อให้สร้างคำขอข้อมูลเมตาที่เกี่ยวข้องกับคำขอภาพหนึ่งๆ ได้ง่ายขึ้น แต่สำหรับคำขอข้อมูลเมตา API จะละเว้นพารามิเตอร์ที่ไม่บังคับและค่าของพารามิเตอร์เหล่านั้น ดูข้อมูลเกี่ยวกับการใช้พารามิเตอร์เหล่านี้ได้ที่คู่มือนักพัฒนาซอฟต์แวร์ของ Street View Static API

รูปแบบคำตอบ

ระบบจะแสดงผลข้อมูลเมตาเป็นรูปแบบ JSON เท่านั้น

ตัวอย่าง

ตัวอย่างที่ 1: พบภาพพาโนรามา

URL ต่อไปนี้ขอข้อมูลเมตาและรูปภาพของการพาโนรามาเดียวกันได้สําเร็จ

คำขอและคำตอบเกี่ยวกับข้อมูลเมตา

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "copyright" : "© 2017 Google",
   "date" : "2016-05",
   "location" : {
      "lat" : 48.85783227207914,
      "lng" : 2.295226175151347
   },
   "pano_id" : "tu510ie_z4ptBZYo2BGEJg",
   "status" : "OK"
}

คำขอและคำตอบเกี่ยวกับภาพซึ่งคาดว่าจะมีรูปภาพหายไป

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
หอไอเฟล

ตัวอย่างที่ 2: ไม่พบภาพพาโนรามา

URL ต่อไปนี้จะขอข้อมูลเมตาและรูปภาพสำหรับภาพพาโนรามาที่ไม่พบที่หรือใกล้กับตำแหน่งที่ระบุ

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

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "status" : "ZERO_RESULTS"
}

คำขอและคำตอบเกี่ยวกับภาพ

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
ตัวยึดตําแหน่ง "ไม่มีภาพที่นี่"

รหัสสถานะ

ช่อง status ภายในออบเจ็กต์การตอบกลับข้อมูลเมตามีสถานะของคำขอ และอาจมีข้อมูลการแก้ไขข้อบกพร่องเพื่อช่วยคุณแก้ปัญหาว่าเหตุใดคำขอ Street View จึงใช้งานไม่ได้ ช่อง status อาจมีค่าต่อไปนี้

สถานะ คำอธิบาย
"OK" บ่งบอกว่าไม่เกิดข้อผิดพลาดใดๆ ระบบพบภาพพาโนรามาและแสดงข้อมูลเมตา
"ZERO_RESULTS" บ่งบอกว่าไม่พบภาพพาโนรามาใกล้กับสถานที่ที่ระบุ คำตอบนี้อาจเกิดขึ้นหากคุณระบุรหัสพาโนรามาที่ไม่เป็นจริงหรือไม่ถูกต้อง ดู [รีเฟรชรหัสภาพพาโนรามาที่ลบไปแล้ว](#refresh-pano)
"NOT_FOUND" บ่งบอกว่าไม่พบสตริงที่อยู่ในพารามิเตอร์ location ข้อความนี้อาจปรากฏขึ้นหากระบุที่อยู่ที่ไม่มีอยู่
"OVER_QUERY_LIMIT" บ่งบอกว่าคุณใช้โควต้ารายวันหรือโควต้าต่อวินาทีสำหรับ API นี้เกินโควต้าแล้ว
"REQUEST_DENIED" บ่งบอกว่าคำขอของคุณถูกปฏิเสธ ข้อความนี้อาจปรากฏขึ้นหากคุณไม่ได้ให้สิทธิ์คําขอ หรือหากไม่ได้เปิดใช้งาน Street View Static API ในโปรเจ็กต์ Google Cloud Console ที่มีคีย์ API ของคุณ
"INVALID_REQUEST" โดยทั่วไปจะระบุว่าไม่มีพารามิเตอร์การค้นหา (ที่อยู่ พิกัดละติจูดและลองจิจูด หรือคอมโพเนนต์)
"UNKNOWN_ERROR" บ่งบอกว่าระบบไม่สามารถดำเนินการกับคำขอได้เนื่องจากข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ ปัญหานี้มักเกิดขึ้นชั่วคราว คำขออาจสำเร็จหากคุณลองอีกครั้ง

ข้อมูลเพิ่มเติม

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ Street View Static API หรือผลิตภัณฑ์อื่นๆ ของ Google Maps API ได้ที่หน้าการสนับสนุนของ Maps API