คำขอภาพ Street View คือ HTTP URL ในรูปแบบนี้:
https://maps.googleapis.com/maps/api/streetview?parameters
ระบุรูปภาพโดยใช้พารามิเตอร์คำขอ เช่นเดียวกับมาตรฐานใน URL พารามิเตอร์ทั้งหมดจะถูกคั่นด้วยอักขระเครื่องหมายแอมเพอร์แซนด์ (&) พารามิเตอร์ที่อนุญาตและค่าที่เป็นไปได้มีดังนี้
พารามิเตอร์ที่จำเป็น
ให้ทำอย่างใดอย่างหนึ่งต่อไปนี้
locationอาจเป็นสตริงข้อความ (เช่นChagrin Falls, OH) หรือคู่พิกัดละติจูดและลองจิจูด (40.457375,-80.009353) และควรเข้ารหัส URL ก็ได้ ดังนั้น ให้แปลงที่อยู่อย่าง "ซิตี้ฮอลล์ นิวยอร์ก นิวยอร์ก" เป็น "เมือง + ฮอลล์ นิวยอร์ก นิวยอร์ก" ก่อนส่งคำขอ Street View Static API จะจับภาพภาพพาโนรามาที่ใกล้กับตำแหน่งมากที่สุด เมื่อคุณระบุสตริงข้อความที่อยู่ API อาจใช้ตำแหน่งกล้องที่ต่างกันเพื่อให้แสดงตำแหน่งที่ระบุได้ดียิ่งขึ้น เมื่อคุณระบุพิกัดละติจูดและลองจิจูด API จะค้นหาภาพถ่ายที่อยู่ใกล้กับตำแหน่งมากที่สุดในรัศมี 50 เมตร เนื่องจากภาพ Street View จะมีการรีเฟรชเป็นระยะๆ และอาจมีการถ่ายภาพจากตำแหน่งที่ต่างกันเล็กน้อยในแต่ละครั้ง จึงอาจเป็นไปได้ที่locationของคุณอาจสแนปเป็นภาพพาโนรามาที่แตกต่างกันเมื่ออัปเดตภาพ
หรือ
panoคือรหัสพาโนรามาที่เฉพาะเจาะจง ภาพพาโนรามาอาจเปลี่ยนแปลงรหัสเมื่อเวลาผ่านไป ดังนั้นอย่าเก็บรหัสนี้ไว้ ให้บันทึกที่อยู่ของสถานที่ตั้งหรือพิกัดละติจูดและลองจิจูดแทนเพื่อรีเฟรชรหัสพาโนรามา โปรดดูรายละเอียดที่รีเฟรชรหัสพาโนรามาที่ลบไปแล้ว
รวมถึง
sizeระบุขนาดเอาต์พุตของรูปภาพในหน่วยพิกเซล ขนาดจะระบุเป็น{width}x{height}ตัวอย่างเช่นsize=600x400จะแสดงผลรูปภาพกว้าง 600 พิกเซลและสูง 400 พิกเซลkeyช่วยให้คุณตรวจสอบการใช้งาน API ของแอปพลิเคชันใน Google Cloud Console และมั่นใจได้ว่า 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ระบบจะแสดงผลข้อความแสดงข้อผิดพลาดแทนรูปภาพสีเทาทั่วไป คุณจึงไม่ต้องเรียกรูปภาพเพิ่มเติมเพื่อตรวจสอบความพร้อมใช้งานของรูปภาพsource(ค่าเริ่มต้นคือdefault) จำกัดการค้นหา Street View ไว้เฉพาะแหล่งที่มาที่เลือกไว้ ค่าที่ใช้ได้มีดังนี้defaultใช้แหล่งที่มาเริ่มต้นสำหรับ Street View โดยการค้นหาจะไม่จํากัดเพียงแหล่งที่มาที่เจาะจงoutdoorจํากัดการค้นหาไว้ที่คอลเล็กชันกลางแจ้ง คอลเล็กชันในอาคารจะไม่รวมอยู่ในผลการค้นหา โปรดทราบว่าตำแหน่งที่ระบุอาจไม่มีภาพพาโนรามากลางแจ้ง นอกจากนี้ โปรดทราบว่าการค้นหาจะแสดงเฉพาะภาพพาโนรามาเมื่อสามารถระบุได้ว่าอยู่ในร่มหรือกลางแจ้ง เช่น ระบบจะไม่แสดงผล PhotoSpheres เนื่องจากไม่รู้ว่าอยู่ในร่มหรือกลางแจ้ง
นี่เป็นตัวอย่างคำขอ
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 "ไม่พบ" แทนรูปภาพสีเทาทั่วไป หากไม่มีรูปภาพในตำแหน่งที่ระบุ - ขอข้อมูลเมตาของรูปภาพ Street View เพื่อดูว่ามีภาพในตำแหน่งที่ระบุหรือไม่ก่อนที่จะส่งคำขอ