คำขอรูปภาพ Street View คือ HTTP URL ในรูปแบบต่อไปนี้
https://maps.googleapis.com/maps/api/streetview?parameters
รูปภาพจะระบุโดยใช้พารามิเตอร์คำขอ พารามิเตอร์ทั้งหมดจะคั่นด้วยอักขระแอมเพอร์แซนด์ (&) ตามมาตรฐานใน URL พารามิเตอร์ที่อนุญาตและค่าที่เป็นไปได้มีดังนี้
พารามิเตอร์ที่จำเป็น
ดังนี้
locationอาจเป็นสตริงข้อความ (เช่นChagrin Falls, OH) หรือคู่พิกัดละติจูดและลองจิจูด (40.457375,-80.009353) และควรเข้ารหัส URL ดังนั้นให้แปลงที่อยู่ เช่น "City Hall, New York, NY" เป็น "City+Hall,New+York,NY" ก่อนส่งคำขอ Street View Static API จะสแนปไปยังภาพพาโนรามาที่อยู่ใกล้กับสถานที่นั้นมากที่สุด เมื่อคุณระบุสตริงข้อความที่อยู่ API อาจใช้ตำแหน่งกล้องอื่นเพื่อแสดงตำแหน่งที่ระบุได้ดียิ่งขึ้น เมื่อคุณระบุพิกัดละติจูดและลองจิจูด API จะค้นหารัศมี 50 เมตรเพื่อหารูปภาพที่อยู่ใกล้กับสถานที่นั้นมากที่สุด เนื่องจากภาพ Street View จะมีการรีเฟรชเป็นระยะๆ และอาจมีการถ่ายภาพจากตำแหน่งที่แตกต่างกันเล็กน้อยในแต่ละครั้ง จึงเป็นไปได้ว่าlocationของคุณอาจสแนปไปยังภาพพาโนรามาอื่นเมื่อมีการอัปเดตภาพ
หรือ
panoคือรหัสพาโนรามาที่เฉพาะเจาะจง ภาพพาโนรามาอาจเปลี่ยนรหัสเมื่อเวลาผ่านไป ดังนั้นอย่าเก็บรหัสนี้ไว้ แต่ให้บันทึกที่อยู่ของสถานที่หรือพิกัดละติจูดและลองจิจูดแทน เพื่อให้คุณรีเฟรชรหัสพาโนรามาได้ โปรดดูรายละเอียดที่หัวข้อรีเฟรชรหัสพาโนรามาที่ถูกลบ
รวมถึง
sizeระบุขนาดเอาต์พุตของรูปภาพเป็นพิกเซล ขนาดจะระบุเป็น{width}x{height}เช่นsize=600x400จะแสดงรูปภาพที่มีความกว้าง 600 พิกเซลและความสูง 400 พิกเซลkeyช่วยให้คุณตรวจสอบการใช้งาน API ของแอปพลิเคชันในคอนโซล Google Cloud และช่วยให้ Google ติดต่อคุณเกี่ยวกับแอปพลิเคชันได้หากจำเป็น ดูข้อมูลเพิ่มเติมได้ที่รับคีย์และลายเซ็น
รีเฟรชรหัสพาโนรามาที่ลบไปแล้ว
หากคุณพยายามดึงข้อมูลรหัสพาโนรามาและได้รับ ZERO_RESULTS หรือไม่มีค่า แสดงว่ารหัสพาโนรามาถูกลบไปแล้วและต้องรีเฟรช
บันทึกที่อยู่ของสถานที่หรือพิกัดละติจูดและลองจิจูดที่คุณใช้เพื่อรับรหัสภาพพาโนรามา เพื่อให้คุณรีเฟรชได้เมื่อจำเป็น
เมื่อตรวจพบว่ารหัสพาโนรามามีการเปลี่ยนแปลง ให้ใช้ที่อยู่ตำแหน่งเดิมหรือพิกัดละติจูดและลองจิจูดเพื่อค้นหาพาโนรามาที่ใกล้ที่สุดกับตำแหน่งนั้นอีกครั้งและรับรหัสพาโนรามาใหม่
พารามิเตอร์ที่ไม่บังคับ
signature(แนะนำ) คือลายเซ็นดิจิทัลที่ใช้เพื่อยืนยันว่าเว็บไซต์ที่สร้างคำขอโดยใช้คีย์ API ของคุณได้รับอนุญาตให้ดำเนินการดังกล่าว คำขอที่ไม่มีลายเซ็นดิจิทัลอาจดำเนินการไม่สำเร็จ ดูข้อมูลเพิ่มเติมได้ที่รับคีย์และลายเซ็นหมายเหตุ: สำหรับลูกค้าเดิมของแพ็กเกจพรีเมียมของ Google Maps Platform ต้องใช้ลายเซ็นดิจิทัล ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์การตรวจสอบสิทธิ์สำหรับลูกค้าแพ็กเกจพรีเมียม
headingระบุทิศทางเข็มทิศของกล้อง ค่าที่ยอมรับคือตั้งแต่0ถึง360(ทั้ง 2 ค่าแสดงถึงทิศเหนือ โดย90แสดงถึงทิศตะวันออก และ180แสดงถึงทิศใต้) หากคุณไม่ระบุทิศทาง ระบบจะคำนวณค่าที่กำหนดให้กล้องหันไปยังlocationที่ระบุจากจุดที่ถ่ายภาพที่ใกล้ที่สุดfov(ค่าเริ่มต้นคือ90) กำหนดขอบเขตการมองเห็นแนวนอนของรูปภาพที่แสดงเป็นองศา โดยมีค่าสูงสุดที่อนุญาตคือ120เมื่อใช้วิวพอร์ตขนาดคงที่ เช่น ภาพ Street View ที่มีขนาดที่กำหนดไว้ ขอบเขตการมองเห็นจะแสดงการซูม โดยตัวเลขที่น้อยกว่าจะแสดงระดับการซูมที่สูงกว่า
(ซ้าย:fov=120; ขวา:fov=20)pitch(ค่าเริ่มต้นคือ0) ระบุมุมขึ้นหรือลงของกล้องที่สัมพันธ์กับรถ Street View ซึ่งมักจะเป็นแนวนอนราบ แต่ก็ไม่เสมอไป ค่าบวกจะปรับมุมกล้องขึ้น (โดย90องศาหมายถึงชี้ขึ้นตรงๆ) ค่าลบจะปรับมุมกล้องลง (โดย-90หมายถึงชี้ลงตรงๆ)radius(ค่าเริ่มต้นคือ50) ตั้งค่ารัศมีที่ระบุเป็นเมตรเพื่อค้นหาภาพพาโนรามา โดยมีศูนย์กลางอยู่ที่ละติจูดและลองจิจูดที่ระบุ ค่าที่ใช้ได้คือจำนวนเต็มที่ไม่ติดลบreturn_error_codeระบุว่า API ควรแสดงรหัสข้อผิดพลาดเมื่อไม่พบรูปภาพ (404 NOT FOUND) หรือเพื่อตอบสนองต่อคำขอที่ไม่ถูกต้อง (400 BAD REQUEST) หรือไม่ ค่าที่ใช้ได้คือtrueและfalseหากตั้งค่าเป็นtrueระบบจะแสดงข้อความแสดงข้อผิดพลาดแทนรูปภาพสีเทาทั่วไป ซึ่งจะช่วยลดความจำเป็นในการเรียกใช้ API แยกต่างหากเพื่อตรวจสอบความพร้อมใช้งานของรูปภาพsource(ค่าเริ่มต้นคือdefault) จำกัดการค้นหา Street View ไว้เฉพาะแหล่งที่มาที่เลือก ค่าที่ใช้ได้มีดังนี้defaultใช้แหล่งที่มาเริ่มต้นสำหรับ Street View โดยการค้นหาไม่ได้จำกัดเฉพาะแหล่งที่มาที่เจาะจงoutdoorจำกัดการค้นหาไว้ที่คอลเล็กชันกลางแจ้ง คอลเล็กชันในอาคารจะไม่รวมอยู่ในผลการค้นหา โปรดทราบว่าอาจไม่มีภาพพาโนรามากลางแจ้งสำหรับสถานที่ที่ระบุ โปรดทราบว่าการค้นหาจะแสดงเฉพาะภาพพาโนรามาที่ระบุได้ว่าเป็นภาพในอาคารหรือกลางแจ้ง เช่น ระบบจะไม่แสดงผล PhotoSphere เนื่องจากไม่ทราบว่าอยู่ภายในหรือภายนอกอาคาร
นี่คือตัวอย่างคำขอ
https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
ไม่มีภาพที่ใช้ได้
สำหรับสถานที่ที่ไม่มีภาพ Street View, Street View Static API จะแสดงรูปภาพทั่วไปสีเทาพร้อมข้อความ "ขออภัย เราไม่มีภาพที่นี่" ดังที่แสดงในตัวอย่างนี้
แสดงเฉพาะรูปภาพที่ถูกต้อง
หากต้องการหลีกเลี่ยงการแสดงรูปภาพทั่วไป และตรวจสอบว่าหน้าเว็บแสดงเฉพาะรูปภาพ Street View Static API ที่ถูกต้อง ให้ทำตามคำแนะนำต่อไปนี้
- ตั้งค่าพารามิเตอร์
return_error_codeเป็นtrueซึ่งจะทำให้ Street View Static API แสดงข้อผิดพลาด 404 NOT FOUND แทนรูปภาพสีเทาทั่วไป หากไม่มีรูปภาพสำหรับสถานที่ที่ระบุ - ขอข้อมูลเมตาของภาพ Street View เพื่อพิจารณาว่ามีภาพสำหรับสถานที่ที่ระบุหรือไม่ก่อนส่งคำขอ