คำขอภาพ 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 Premium จะต้องมีลายเซ็นดิจิทัล ดูข้อมูลเพิ่มเติมเกี่ยวกับ พารามิเตอร์การตรวจสอบสิทธิ์สำหรับ ลูกค้าแพ็กเกจพรีเมียม
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 เพื่อพิจารณาว่ามีภาพสำหรับตำแหน่งที่ระบุหรือไม่ก่อนที่จะส่งคำขอ