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

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

บทนำ

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

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

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

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

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

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

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

รูปภาพสถานที่ (ใหม่) 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

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

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