คำขอและการตอบสนองของ Street View

คำขอภาพ Street View คือ URL ของ HTTP ในรูปแบบต่อไปนี้

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 หรือไม่มีค่า แสดงว่ารหัสพาโนรามาถูกลบไปแล้วและต้องรีเฟรช

1. บันทึกที่อยู่ของสถานที่ตั้งหรือพิกัดละติจูดและลองจิจูดที่คุณใช้เพื่อ รับรหัสพาโนรามาเพื่อให้คุณรีเฟรชได้เมื่อจำเป็น

2. เมื่อตรวจพบว่ารหัสพาโนรามามีการเปลี่ยนแปลง ให้ใช้ที่อยู่ของตำแหน่งเดิม หรือพิกัดละติจูดและลองจิจูดเพื่อค้นหาพาโนรามาที่ใกล้ที่สุด กับตำแหน่งนั้นอีกครั้งและรับรหัสพาโนรามาใหม่

พารามิเตอร์ที่ไม่บังคับ

• signature (แนะนํา) คือลายเซ็นดิจิทัลที่ใช้ เพื่อยืนยันว่าเว็บไซต์ที่สร้างคําขอโดยใช้คีย์ API ของคุณได้รับอนุญาต ให้ทําเช่นนั้น คําขอที่ไม่มีลายเซ็นดิจิทัลอาจไม่สําเร็จ ดูข้อมูลเพิ่มเติมได้ที่รับคีย์และลายเซ็น

  หมายเหตุ: สำหรับลูกค้าเดิมของ Google Maps Platform Premium Plan ต้องมีลายเซ็นดิจิทัล ดูข้อมูลเพิ่มเติมเกี่ยวกับ พารามิเตอร์การตรวจสอบสิทธิ์สำหรับ ลูกค้าแพ็กเกจ Premium

• heading ระบุทิศทางเข็มทิศของ กล้องถ่ายรูป ค่าที่รับได้มีตั้งแต่ 0 ถึง 360 (ค่าทั้งสองจะแสดง "ทิศเหนือ" โดย 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 คำขอไม่ถูกต้อง) ค่าที่ใช้ได้คือ true และ false หากตั้งค่าเป็น true ระบบจะแสดงข้อความแสดงข้อผิดพลาดแทนรูปภาพสีเทาทั่วไป จึงไม่ต้อง โทรแยกต่างหากเพื่อตรวจสอบความพร้อมใช้งานของรูปภาพ
• source (ค่าเริ่มต้นคือ default) จำกัดการค้นหา Street View ให้แสดงเฉพาะแหล่งที่มาที่เลือก ค่าที่ใช้ได้มีดังนี้
  • default ใช้แหล่งที่มาเริ่มต้นสำหรับ Street View การค้นหาไม่ได้จำกัดอยู่เพียงแหล่งที่มาที่เฉพาะเจาะจง
  • outdoor จำกัดการค้นหาเฉพาะคอลเล็กชันกลางแจ้ง คอลเล็กชันในอาคาร จะไม่รวมอยู่ในผลการค้นหา โปรดทราบว่าพาโนรามากลางแจ้งอาจไม่มีสำหรับสถานที่ที่ระบุ โปรดทราบว่าการค้นหาจะแสดงเฉพาะภาพพาโนรามา ที่ระบุได้ว่าเป็นภาพในร่มหรือกลางแจ้ง เช่น ระบบจะไม่แสดงผล Photo Sphere เนื่องจากไม่ทราบว่าอยู่ภายในหรือภายนอกอาคาร

นี่คือตัวอย่างคำขอ

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 เพื่อตรวจสอบว่ามีภาพสำหรับตำแหน่งที่ระบุหรือไม่ก่อน ที่จะส่งคำขอ