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

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

บทนำ

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

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

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

คำขอ Place Photos (ใหม่)

คำขอ 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[] \- การระบุแหล่งที่มาที่จำเป็น ฟิลด์นี้ จะปรากฏอยู่เสมอ แต่ก็อาจว่างเปล่า

รูปภาพที่แสดงผลโดย Place 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/ATKogpeivkIjQ1FT7QmbeT33nBSwqLhdPvIWHfrG1WfmgrFjeZYpS_Ls7c7rj8jejN9QGzlx4GoAH0atSvUzATDrgrZic_tTEJdeITdWL-oG3TWi5HqZoLozrjTaxoAIxmROHfV5KXVcLeTdCC6kmZExSy0CLVIG3lAPIgmvUiewNf-ZHYE4-jXYwPQpWHJgqVosvZJ6KWEgowEA-qRAzNTu9VH6BPFqHakGQ7EqBAeYOiU8Dh-xIQC8FcBJiTi0xB4tr-MYXUaF0p_AqzAhJcDE6FAgLqG1s7EsME0o36w2nDRHA-IuoISBC3SIahINE3Xwq2FzEZE6TpNTFVfgTpdPhV8CGLeqrauHn2I6ePm-2hA8-87aO7aClXKJJVzlQ1dc_JuHz6Ks07d2gglw-ZQ3ibCTF5lMtCF9O-9JHyRQXsfuXw/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. เลือกปุ่มExecute ในกล่องโต้ตอบ ให้เลือกบัญชีที่ต้องการใช้ ส่งคำขอ

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