คำขอภาพ 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
เป็นรหัสพาโนรามาที่เฉพาะเจาะจง ภาพพาโนรามาอาจมีการเปลี่ยนแปลง ID เมื่อเวลาผ่านไป ดังนั้น ไม่เก็บรหัสนี้ แต่ให้บันทึกที่อยู่ของสถานที่ตั้งแทน หรือ พิกัดละติจูดและลองจิจูด เพื่อให้คุณสามารถรีเฟรชรหัสพาโนรามาได้ สำหรับ โปรดดูรายละเอียดที่หัวข้อรีเฟรชรหัสพาโนรามาที่ลบไปแล้ว
รวมถึง
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 ไม่พบ) หรือตอบสนองต่อ คำขอไม่ถูกต้อง (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 "NOT FOUND" แทนรูปภาพสีเทาทั่วไป หากไม่มีรูปภาพสำหรับ ตำแหน่งที่ระบุ - ขอข้อมูลเมตาของรูปภาพ Street View เพื่อพิจารณาว่ามีภาพพร้อมใช้งานสำหรับสถานที่ที่ระบุก่อนหน้านี้หรือไม่ ในการส่งคำขอ