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