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

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

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

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

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