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

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

รีเฟรชรหัสภาพพาโนรามาที่ลบไปแล้ว

หากคุณพยายามเรียกข้อมูลรหัสพาโนรามาและได้รับค่า ZERO_RESULTS หรือไม่มีค่า แสดงว่ารหัสพาโนรามาถูกลบไปแล้วและต้องรีเฟรช

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

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

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

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

  หมายเหตุ: สำหรับอดีตลูกค้าแพ็กเกจ Premium ของ Google Maps Platform คุณจะต้องลงนามแบบดิจิทัล ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์การตรวจสอบสิทธิ์สำหรับลูกค้าแพ็กเกจ 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 จำกัดการค้นหาไว้เฉพาะคอลเล็กชันกลางแจ้ง ผลงานในอาคารจะไม่รวมอยู่ในผลการค้นหา โปรดทราบว่าภาพพาโนรามากลางแจ้งอาจไม่พร้อมใช้งานสำหรับสถานที่ที่ระบุ นอกจากนี้ โปรดทราบว่าการค้นหาจะแสดงเฉพาะภาพพาโนรามาที่ระบุได้ว่าถ่ายในอาคารหรือกลางแจ้ง เช่น ระบบจะไม่แสดงภาพ 360 องศาเนื่องจากไม่ทราบว่าภาพนั้นถ่ายทำในอาคารหรือกลางแจ้ง

นี่เป็นตัวอย่างคำขอ

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