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