ข้อมูลเมตาของรูปภาพ 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

หมายเหตุ: https:// ต้องมีโปรโตคอลสำหรับคำขอข้อมูลเมตา

ตามมาตรฐานของ 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. เมื่อคุณตรวจพบว่ารหัสพาโนรามามีการเปลี่ยนแปลง ให้ใช้ตำแหน่งเดิม ที่อยู่หรือพิกัดละติจูดและลองจิจูดเพื่อค้นหาข้อมูลที่ใกล้เคียงที่สุดอีกครั้ง พาโนรามาไปยังตำแหน่งนั้น และรับรหัสพาโนรามาใหม่

หมายเหตุ: เนื่องจากมีการรีเฟรชภาพ Street View เป็นระยะๆ และภาพถ่ายอาจ สามารถถ่ายจากตำแหน่งที่ต่างกันเล็กน้อยในแต่ละครั้ง รหัสพาโนรามาที่ระบุ อาจสแนปไปยังภาพพาโนรามาอื่นเมื่อมีการอัปเดตภาพหรือรหัสพาโนรามา

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

คุณรวมพารามิเตอร์ต่อไปนี้ในคําขอข้อมูลเมตาได้: 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 หน้าการสนับสนุน