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

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

บทนำ

Places API รองรับ Place Photos (ดั้งเดิม) หากคุณคุ้นเคยกับ Place Photos (แบบเดิม) Place Photos (ใหม่) จะทำการเปลี่ยนแปลงดังต่อไปนี้:

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

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

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

เพิ่มขนาดรูปภาพ

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

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

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

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

Find Place (เดิม), Nearby Search (เดิม), Text Search (เดิม) และ Place Details (เดิม) จะแสดงอาร์เรย์ photos[] ใน การตอบกลับที่รองรับรูปแบบนี้ องค์ประกอบ photo แต่ละรายการในคำตอบเดิม จะมีฟิลด์ต่อไปนี้

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