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