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

เลือกแพลตฟอร์ม: 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

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

รูปภาพที่บริการ 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