บริการรูปภาพสถานที่ (ใหม่) เป็น API แบบอ่านอย่างเดียวที่ช่วยให้คุณสามารถเพิ่มเนื้อหารูปภาพคุณภาพสูงลงในแอปพลิเคชันของคุณ บริการ Place Photo ช่วยให้คุณเข้าถึงรูปภาพนับล้านที่เก็บอยู่ในฐานข้อมูล Places
เมื่อคุณได้รับข้อมูลสถานที่โดยใช้คำขอ "รายละเอียดสถานที่" "การค้นหาใกล้เคียง" หรือ "การค้นหาข้อความ" คุณยังสามารถขอแหล่งข้อมูลรูปภาพสำหรับเนื้อหาภาพถ่ายที่เกี่ยวข้องได้อีกด้วย เมื่อใช้บริการรูปภาพ คุณจะเข้าถึงรูปภาพที่อ้างอิงและปรับขนาดรูปภาพให้เป็นขนาดที่เหมาะสมที่สุดสำหรับแอปพลิเคชันได้
API Explorer ช่วยให้คุณสามารถสร้างคำขอแบบเรียลไทม์เพื่อทำความคุ้นเคยกับ API และตัวเลือก API ดังนี้
ลองใช้งานคำขอรูปภาพสถานที่
คำขอรูปภาพสถานที่เป็นคำขอ HTTP GET ไปยัง URL ในแบบฟอร์มต่อไปนี้https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS
ที่ที่ต้องระบุพารามิเตอร์ต่อไปนี้
- NAME มีชื่อทรัพยากรของรูปภาพ
- API_KEY มีคีย์ API
- PARAMETERS มีพารามิเตอร์
maxHeightPx
, พารามิเตอร์maxWidthPx
หรือทั้ง 2 อย่าง
ด้านล่างนี้เป็นรายการพารามิเตอร์ที่จําเป็นและไม่บังคับทั้งหมด
พารามิเตอร์ที่จำเป็น
ชื่อรูปภาพ
ตัวระบุสตริงที่ระบุรูปภาพได้โดยไม่ซ้ำกัน ชื่อรูปภาพจะแสดงจากคำขอรายละเอียดสถานที่ (ใหม่) การค้นหาใกล้เคียง (ใหม่) หรือการค้นหาข้อความ (ใหม่) ในพร็อพเพอร์ตี้ name
ขององค์ประกอบแต่ละรายการของอาร์เรย์ photos[]
ดูตัวอย่างได้ที่ขอชื่อรูปภาพ
maxHeightPx และ maxWidthPx
ระบุความสูงและความกว้างสูงสุดที่ต้องการเป็นพิกเซลของรูปภาพ หากรูปภาพมีขนาดเล็กกว่าที่ระบุไว้ ระบบจะแสดงรูปภาพต้นฉบับ หากรูปภาพมีขนาดใหญ่กว่าขนาดใดขนาดหนึ่ง จะมีการปรับขนาดให้ตรงกับขนาดที่เล็กกว่า โดยจำกัดตามอัตราส่วนเดิม ทั้งพร็อพเพอร์ตี้ maxheight และ maxwidth จะยอมรับจำนวนเต็มระหว่าง 1 ถึง 4800
คุณต้องระบุ maxHeightPx
หรือ maxWidthPx
หรือทั้ง 2 อย่าง
พารามิเตอร์ที่ไม่บังคับ
skipHttpRedirect
หากเป็น false
(ค่าเริ่มต้น) ให้เปลี่ยนเส้นทาง HTTP ไปยังรูปภาพเพื่อส่งรูปภาพ
หากเป็น true
ให้ข้ามการเปลี่ยนเส้นทางและแสดงผลการตอบสนอง JSON ที่มีรูปภาพล้มเหลว
เช่น
{ "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/Aaw_FcKly0DEv3EWmDJyHiEqXIP5mowOc99lN1GzBun6KHH52AZ5fFA/media", "photoUri": "https://lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo" }
ระบบจะไม่สนใจตัวเลือกนี้สำหรับคำขอที่ไม่ใช่ HTTP
รับชื่อรูปภาพ
คำขอทั้งหมดที่ส่งไปยังบริการรูปภาพสถานที่ต้องมีชื่อทรัพยากรรูปภาพ ซึ่งแสดงในการตอบกลับคำขอการค้นหาใกล้เคียง การค้นหาข้อความ หรือรายละเอียดสถานที่ การตอบกลับคำขอเหล่านี้จะมีอาร์เรย์ photos[]
หากสถานที่นั้นมีเนื้อหาภาพถ่ายที่เกี่ยวข้อง
องค์ประกอบแต่ละรายการของ photo[]
จะมีช่องต่อไปนี้
name
— สตริงที่มีชื่อทรัพยากรของรูปภาพเมื่อคุณส่งคำขอรูปภาพ สตริงนี้อยู่ในรูปแบบต่อไปนี้places/PLACE_ID/photos/PHOTO_RESOURCE
heightPx
— ความสูงสูงสุดของรูปภาพในหน่วยพิกเซลwidthPx
— ความกว้างสูงสุดของรูปภาพในหน่วยพิกเซลauthorAttributions[]
— การระบุแหล่งที่มาที่ต้องระบุ ช่องนี้จะปรากฏขึ้นเสมอ แต่อาจว่างเปล่า
รูปภาพที่ส่งโดยบริการรูปภาพจะมาจากสถานที่หลายแห่ง ซึ่งรวมถึงเจ้าของธุรกิจและรูปภาพที่ผู้ใช้ส่งมา ในกรณีส่วนใหญ่ รูปภาพเหล่านี้จะใช้ได้โดยไม่ต้องแสดงที่มา หรือจะมีการระบุแหล่งที่มาที่จำเป็นรวมอยู่ในรูปภาพด้วย อย่างไรก็ตาม หากองค์ประกอบ photo
ที่แสดงผลมีค่าในช่อง authorAttributions
คุณต้องใส่การระบุแหล่งที่มาเพิ่มเติมในแอปพลิเคชันด้วยทุกที่ที่แสดงรูปภาพ
ตัวอย่างต่อไปนี้แสดงคำขอรายละเอียดสถานที่ที่มี photos
ในมาสก์ของช่อง เพื่อให้การตอบกลับรวมอาร์เรย์ photos[]
ในคำตอบ
curl -X GET \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,photos" \ https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6Eตัวอย่างอาร์เรย์
photos[]
ในการตอบกลับจะแสดงอยู่ด้านล่าง
... "photos" : [ { "name": "places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1", "widthPx": 6000, "heightPx": 4000, "authorAttributions": [ { "displayName": "John Smith", "uri": "//maps.google.com/maps/contrib/101563", "photoUri": "//lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo" } ] }, ...
ขอรูปภาพสถานที่
คำขอตัวอย่างด้านล่างแสดงผลรูปภาพโดยใช้ทรัพยากร name
ของรูปภาพนั้น โดยจะปรับขนาดให้สูงและกว้างไม่เกิน 400 พิกเซล
https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1/media?maxHeightPx=400&maxWidthPx=400&key=API_KEY
การตอบกลับของคำขอรูปภาพสถานที่ที่สำเร็จจะเป็นรูปภาพ ประเภทรูปภาพจะขึ้นอยู่กับประเภทรูปภาพที่ส่งครั้งแรก
หากคำขอเกินโควต้าที่มีอยู่ เซิร์ฟเวอร์จะแสดงสถานะ HTTP 403 และแสดงรูปภาพด้านล่างเพื่อระบุว่าเกินโควต้าแล้ว
หากเซิร์ฟเวอร์ไม่เข้าใจคำขอของคุณ เซิร์ฟเวอร์จะแสดงสถานะ HTTP 400 ซึ่งระบุคำขอที่ไม่ถูกต้อง สาเหตุที่พบบ่อยที่สุดของคำขอที่ไม่ถูกต้อง ได้แก่
- ระบุชื่อรูปภาพที่ส่งไม่ถูกต้อง
- คำขอไม่มีพารามิเตอร์
maxHeightPx
หรือmaxWidthPx
- ตั้งค่า
maxHeightPx
หรือพารามิเตอร์maxWidthtPx
เป็นnull
name
หมดอายุแล้ว หากname
หมดอายุ ให้ส่งคำขอไปยังรายละเอียดสถานที่ (ใหม่) การค้นหาใกล้เคียง (ใหม่) หรือการค้นหาข้อความ (ใหม่) เพื่อรับname
ใหม่
ลองใช้เลย
โปรแกรมสำรวจ API ให้คุณสร้างคำขอตัวอย่างเพื่อทำความคุ้นเคยกับ API และตัวเลือก API
วิธีส่งคำขอ
- เลือกไอคอน API ทางด้านขวาของหน้า
- ตั้งค่าพารามิเตอร์
name
เป็นplaces/PLACE_ID/photos/PHOTO_RESOURCE/media
- ตั้งค่า
skipHttpRedirect
เป็นtrue
เพื่อให้คำขอแสดงผลการตอบกลับ JSON โดยค่าเริ่มต้น คำขอจะแสดงผลรูปภาพ ซึ่ง API Explorer ไม่สามารถแสดงได้ - เลือกปุ่มดำเนินการ ในป๊อปอัป ให้เลือกบัญชีที่ต้องการใช้ส่งคำขอ
ในแผง API Explorer ให้เลือกไอคอนขยาย เพื่อขยายหน้าต่าง API Explorer