รูปภาพสถานที่ (ใหม่) บริการคือ API แบบอ่านอย่างเดียวที่ ให้คุณเพิ่มคุณภาพสูง ลงในแอปพลิเคชันของคุณได้ บริการรูปภาพสถานที่ให้ คุณจะเข้าถึงภาพถ่ายนับล้านๆ ภาพที่จัดเก็บไว้ในฐานข้อมูลสถานที่ได้
เมื่อคุณได้รับข้อมูลสถานที่โดยใช้รายละเอียดสถานที่ การค้นหาใกล้เคียง หรือคำขอการค้นหาข้อความ คุณยังสามารถขอแหล่งข้อมูลรูปภาพ สำหรับเนื้อหาภาพถ่ายที่เกี่ยวข้องได้ด้วย ในการใช้บริการรูปภาพ จากนั้นคุณจะเข้าถึงภาพถ่ายที่อ้างอิงและปรับขนาดภาพให้ได้ขนาดที่เหมาะสมที่สุดสำหรับ แอปพลิเคชัน
โปรแกรมสำรวจ API ช่วยให้คุณสร้างคำขอแบบเรียลไทม์ได้เพื่อทำความคุ้นเคยกับ 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
ระบุความสูงและความกว้างที่ต้องการสูงสุดเป็นพิกเซลของรูปภาพ หากรูปภาพเล็กลง กว่าค่าที่ระบุ ระบบจะแสดงผลรูปภาพต้นฉบับ หากรูปภาพมีขนาดใหญ่ขึ้น มิติข้อมูลนั้นจะได้รับการปรับขนาดให้เหมือนกับขนาดที่เล็กกว่าของทั้ง 2 ขนาด โดยจำกัดไว้เฉพาะขนาดเดิม ของคุณ ทั้งพร็อพเพอร์ตี้ 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 และแสดงรูปภาพด้านล่างเพื่อระบุว่าโควต้ามี เกินกำหนด:
![รูปภาพเกินโควต้า](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/maps-static/images/quota.png?authuser=0000&hl=th)
หากเซิร์ฟเวอร์ไม่เข้าใจคำขอของคุณ ระบบจะแสดง 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 - เลือกปุ่มดำเนินการ ในป๊อปอัป ให้เลือกบัญชีที่คุณต้องการ ใช้ในการส่งคำขอ
ในแผงโปรแกรมสำรวจ API ให้เลือกไอคอนขยาย
เพื่อขยายหน้าต่างโปรแกรมสำรวจ API