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

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

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

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

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

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

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

  • heading บ่งบอกทิศทางเข็มทิศของ กล้อง ค่าที่ยอมรับคือตั้งแต่ 0 ถึง 360 (ค่าทั้ง 2 ค่าแสดงทิศเหนือ โดยที่ 90 หมายถึงทิศตะวันออก และ 180 ทางใต้) หากคุณไม่ระบุส่วนหัว ค่าจะเป็น คำนวณซึ่งหันกล้องไปยัง location จากจุดที่มีภาพถ่ายที่ใกล้ที่สุด มีคนใช้
  • fov (ค่าเริ่มต้นคือ 90) กำหนดช่องมุมมองแนวนอนของรูปภาพ โดยระบุเป็นองศา โดยมีค่าสูงสุดที่อนุญาตไว้ที่ 120 เมื่อจัดการกับวิวพอร์ตขนาดคงที่ เช่น ด้วยภาพ Street View ของ ขนาดที่ตั้งไว้, ขอบเขตการมองเห็นในสาระสำคัญหมายถึงการซูม โดยมีจำนวนที่น้อยกว่า แสดงว่าได้ระดับการซูมที่สูงขึ้น


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