รูปภาพสถานที่ (ใหม่)

บริการรูปภาพสถานที่ (ใหม่) เป็น 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[] หากสถานที่นั้นมีเนื้อหาภาพถ่ายที่เกี่ยวข้อง

หมายเหตุ: หากต้องการรวมอาร์เรย์ photos[] ในคำตอบ อย่าลืมใส่ photos (รายละเอียดสถานที่) หรือ places.photos (การค้นหาใกล้เคียงและการค้นหาข้อความ) ในช่องมาสก์ของคำขอ API แต่ละรายการสามารถแสดงผลรูปภาพสำหรับสถานที่แต่ละแห่งได้สูงสุด 10 รูป

องค์ประกอบแต่ละรายการของ photo[] จะมีช่องต่อไปนี้

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

  places/PLACE_ID/photos/PHOTO_RESOURCE

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

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

ข้อควรระวัง: คุณไม่สามารถแคชชื่อรูปภาพได้ นอกจากนี้ ชื่ออาจมีวันหมดอายุ ตรวจสอบว่าคุณเห็นชื่อจากการตอบกลับคำขอรายละเอียดสถานที่ (ใหม่) การค้นหาใกล้เคียง (ใหม่) หรือการค้นหาข้อความ (ใหม่) เสมอ ดูข้อมูลเพิ่มเติมได้ที่ข้อจำกัดการแคชที่ระบุไว้ในส่วนที่ 3.2.3(ข)(ไม่มีการแคช) ของข้อกำหนดในการให้บริการของ Google Maps Platform

ตัวอย่างต่อไปนี้แสดงคำขอรายละเอียดสถานที่ที่มี 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

วิธีส่งคำขอ

1. เลือกไอคอน API ทางด้านขวาของหน้า
2. ตั้งค่าพารามิเตอร์ name เป็น

   places/PLACE_ID/photos/PHOTO_RESOURCE/media

   หมายเหตุ: ตรวจสอบให้แน่ใจว่าคุณใช้ name จากคำขอรายละเอียดสถานที่ล่าสุด เนื่องจาก name อาจมีวันหมดอายุ
3. ตั้งค่า skipHttpRedirect เป็น true เพื่อให้คำขอแสดงผลการตอบกลับ JSON โดยค่าเริ่มต้น คำขอจะแสดงผลรูปภาพ ซึ่ง API Explorer ไม่สามารถแสดงได้
4. เลือกปุ่มดำเนินการ ในป๊อปอัป ให้เลือกบัญชีที่ต้องการใช้ส่งคำขอ

5. ในแผง API Explorer ให้เลือกไอคอนขยาย เพื่อขยายหน้าต่าง API Explorer