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

บทนำ

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

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

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

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

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

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=<YOUR_SIGNATURE>

หรือดังนี้

https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=<YOUR_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 อาจมีค่าต่อไปนี้

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

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