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

บทนำ

คำขอข้อมูลเมตา Street View Static API ให้ข้อมูลเกี่ยวกับ Street ดูภาพพาโนรามา เมื่อใช้ข้อมูลเมตา คุณจะทราบได้ว่ารูปภาพ 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" โดยทั่วไป พารามิเตอร์การค้นหา (address, พิกัดละติจูดและลองจิจูด หรือคอมโพเนนต์) หายไป
"UNKNOWN_ERROR" บ่งบอกว่าดำเนินการตามคำขอไม่ได้เนื่องจากข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ ปัญหานี้มักเกิดขึ้นเพียงชั่วคราว คำขออาจสำเร็จหากคุณลองอีกครั้ง

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

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