ย้ายข้อมูลไปยัง "รูปภาพสถานที่" (ใหม่)

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

บทนำ

Places API รองรับรูปภาพสถานที่ (เดิม) หากคุณคุ้นเคยกับรูปภาพสถานที่ (เดิม) รูปภาพสถานที่ (ใหม่) จะมีการเปลี่ยนแปลงต่อไปนี้

  • Place Photos (ใหม่) กำหนดให้คุณส่งชื่อทรัพยากรของรูปภาพ ซึ่งรวมถึงรหัสสถานที่ใน URL คำขอ แทนที่จะส่งเฉพาะข้อมูลอ้างอิงรูปภาพ ดูข้อมูลเพิ่มเติมได้ที่การเปลี่ยนแปลงการอ้างอิงรูปภาพ
  • Place Photos (ใหม่) รองรับทั้งคีย์ API และโทเค็น OAuth เป็นกลไกการตรวจสอบสิทธิ์

ตารางต่อไปนี้แสดงพารามิเตอร์ใน Place Photos (เดิม) ที่เปลี่ยนชื่อหรือแก้ไขสำหรับ Place Photos (ใหม่) หรือพารามิเตอร์ที่ไม่รองรับอีกต่อไป

พารามิเตอร์ปัจจุบัน พารามิเตอร์ใหม่ หมายเหตุ
maxheight maxHeightPx คุณต้องระบุ maxHeightPx, maxWidthPx หรือทั้ง 2 อย่าง
maxwidth maxWidthPx คุณต้องระบุ maxHeightPx, maxWidthPx หรือทั้ง 2 อย่าง

ขนาดรูปภาพที่เพิ่มขึ้น

Place Photos (เดิม) รองรับขนาดรูปภาพสูงสุด 1600 x 1600 พิกเซล รูปภาพของสถานที่ (ใหม่) รองรับขนาดสูงสุด 4,800 x 4,800 พิกเซล

เปลี่ยนเป็นรูปภาพอ้างอิง

Place Photos (ใหม่) API กำหนดให้คุณส่งชื่อทรัพยากรของรูปภาพที่ขอ ซึ่งรวมถึงรหัสสถานที่และข้อมูลอ้างอิงรูปภาพในรูปแบบต่อไปนี้

https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY

การค้นหาในบริเวณใกล้เคียง (ใหม่) การค้นหาข้อความ (ใหม่) และ รายละเอียดสถานที่ (ใหม่) ทั้งหมดจะแสดงผลอาร์เรย์ photos[] ในการตอบกลับที่รองรับรูปแบบนี้ องค์ประกอบแต่ละรายการของ photos[] ในการตอบกลับใหม่จะมีฟิลด์ต่อไปนี้

  • name — สตริงที่มีชื่อทรัพยากรของรูปภาพ สตริงนี้จะอยู่ในรูปแบบต่อไปนี้

    places/PLACE_ID/photos/PHOTO_REFERENCE
  • heightPx — ความสูงสูงสุดของรูปภาพในหน่วยพิกเซล
  • widthPx — ความกว้างสูงสุดของรูปภาพในหน่วยพิกเซล
  • authorAttributions[] — การระบุแหล่งที่มาที่จำเป็น ช่องนี้จะแสดงอยู่เสมอ แต่อาจว่างเปล่า

เมื่อใช้ API เดิม คุณจะต้องส่งเฉพาะข้อมูลอ้างอิงรูปภาพในรูปแบบต่อไปนี้

https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY

การค้นหาสถานที่ (เดิม), การค้นหาในบริเวณใกล้เคียง (เดิม), การค้นหาข้อความ (เดิม) และรายละเอียดสถานที่ (เดิม) ทั้งหมดจะแสดงผลอาร์เรย์ photos[] ในการตอบกลับที่รองรับรูปแบบนี้ องค์ประกอบ photo แต่ละรายการในการตอบกลับเดิมจะมีฟิลด์ต่อไปนี้

  • photo_reference — สตริงที่ใช้ระบุรูปภาพเมื่อคุณส่งคำขอรูปภาพ
  • height — ความสูงสูงสุดของรูปภาพ
  • width — ความกว้างสูงสุดของรูปภาพ
  • html_attributions[] — การระบุแหล่งที่มาที่จำเป็น ช่องนี้จะแสดงอยู่เสมอ แต่อาจว่างเปล่า