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

เลือกแพลตฟอร์ม: Android iOS เว็บเซอร์วิส

บริการ Place Photo (ใหม่) เป็น API แบบอ่านอย่างเดียวที่ช่วยให้คุณเพิ่มเนื้อหารูปภาพคุณภาพสูงลงในแอปพลิเคชันได้ บริการรูปภาพสถานที่ช่วยให้คุณเข้าถึงรูปภาพหลายล้านรูปที่จัดเก็บไว้ในฐานข้อมูลของสถานที่

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

เครื่องมือสํารวจ 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

ระบุความสูงและความกว้างสูงสุดที่ต้องการของรูปภาพเป็นพิกเซล หากรูปภาพมีขนาดเล็กกว่าค่าที่ระบุ ระบบจะแสดงผลรูปภาพต้นฉบับ หากรูปภาพมีขนาดใหญ่กว่าในมิติข้อมูลใดมิติข้อมูลหนึ่ง ระบบจะปรับขนาดรูปภาพให้ตรงกับมิติข้อมูลขนาดเล็กกว่าโดยจำกัดอัตราส่วนภาพเดิม ทั้งพร็อพเพอร์ตี้ 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[] — การระบุแหล่งที่มาที่จำเป็น ช่องนี้จะแสดงอยู่เสมอ แต่อาจว่างเปล่า

รูปภาพที่บริการ Photos แสดงจะมาจากแหล่งที่มาที่หลากหลาย ซึ่งรวมถึงรูปภาพจากเจ้าของธุรกิจและรูปภาพที่ผู้ใช้ส่งเข้ามา ในกรณีส่วนใหญ่ คุณสามารถใช้รูปภาพเหล่านี้ได้โดยไม่ต้องระบุแหล่งที่มา หรือจะมีแหล่งที่มาที่จำเป็นรวมอยู่ในรูปภาพ อย่างไรก็ตาม หากองค์ประกอบ 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

คำตอบของคำขอ Place Photo ที่สำเร็จจะเป็นรูปภาพ ประเภทของรูปภาพจะขึ้นอยู่กับประเภทของรูปภาพที่ส่งมาครั้งแรก

หากคำขอเกินโควต้าที่ใช้ได้ เซิร์ฟเวอร์จะแสดงสถานะ HTTP 403 และแสดงรูปภาพด้านล่างเพื่อระบุว่าใช้โควต้าเกิน

รูปภาพเกินโควต้า

หากเซิร์ฟเวอร์ไม่เข้าใจคําขอของคุณ ก็จะแสดงสถานะ HTTP 400 ซึ่งบ่งบอกว่าคําขอไม่ถูกต้อง สาเหตุที่พบบ่อยที่สุดของคำขอที่ไม่ถูกต้องมีดังนี้

ลองใช้งาน

เครื่องมือสำรวจ API ช่วยให้คุณส่งคําขอตัวอย่างได้เพื่อให้คุ้นเคยกับ API และตัวเลือก API

วิธีส่งคำขอ

  1. เลือกไอคอน API ขยายโปรแกรมสำรวจ API ที่ด้านขวาของหน้า
  2. ตั้งค่าพารามิเตอร์ name เป็นค่าต่อไปนี้ 
    places/PLACE_ID/photos/PHOTO_RESOURCE/media
  3. ตั้งค่า skipHttpRedirect เป็น true เพื่อให้คําขอแสดงผลลัพธ์เป็น JSON โดยค่าเริ่มต้น คำขอจะแสดงผลรูปภาพ ซึ่งเครื่องมือสํารวจ API แสดงไม่ได้
  4. เลือกปุ่มดำเนินการ ในป๊อปอัป ให้เลือกบัญชีที่ต้องการใช้ส่งคําขอ

  5. ในแผงโปรแกรมสำรวจ API ให้เลือกไอคอนขยาย ขยายโปรแกรมสำรวจ API เพื่อขยายหน้าต่างโปรแกรมสำรวจ API