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

เลือกแพลตฟอร์ม: Android iOS เว็บเซอร์วิส
นักพัฒนาแอปในเขตเศรษฐกิจยุโรป (EEA)

บทนำ

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

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

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

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

คำขอ Place Photos (ใหม่) คือคำขอ 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

ดูชื่อรูปภาพ

คำขอ Place Photos (ใหม่) ทั้งหมดต้องมีชื่อแหล่งข้อมูลรูปภาพที่แสดงในการตอบกลับคำขอการค้นหาใกล้เคียง (ใหม่) การค้นหาข้อความ (ใหม่) หรือรายละเอียดสถานที่ (ใหม่) การตอบกลับคำขอเหล่านี้จะมีอาร์เรย์ 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

คำตอบของคําขอ Place Photos (ใหม่) ที่ดำเนินการสำเร็จจะเป็นรูปภาพ ประเภทของรูปภาพจะขึ้นอยู่กับประเภทของรูปภาพที่ส่งมาครั้งแรก

รหัสข้อผิดพลาด

คำขอ Place Photos (ใหม่) อาจแสดงรหัสข้อผิดพลาดต่อไปนี้

เกินโควต้า (403)

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

การแจ้งเตือนการใช้งานเกินโควต้า

คำขอไม่ถูกต้อง (404)

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

มีคำขอมากเกินไป (429)

Google ขอแนะนำให้โหลดรูปภาพตามต้องการ หากคุณพยายามแสดงรูปภาพทั้งหมดของสถานที่พร้อมกัน เซิร์ฟเวอร์อาจแสดงสถานะ HTTP 429 ซึ่งบ่งบอกว่ามีการโหลดรูปภาพพร้อมกันมากเกินไป หากได้รับข้อความแสดงข้อผิดพลาดนี้ ให้ติดต่อทีมสนับสนุนและขอเพิ่มโควต้า

ลองใช้งาน

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

วิธีส่งคำขอ

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

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