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

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

บทนำ

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

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

โปรแกรมสำรวจ 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 อย่าง

รายการพารามิเตอร์ที่จำเป็นและไม่บังคับทั้งหมดจะอธิบายไว้ด้านล่าง

พารามิเตอร์ที่จำเป็น

ชื่อรูปภาพ

ตัวระบุสตริงที่ระบุรูปภาพโดยไม่ซ้ำกัน ชื่อรูปภาพจะแสดงจากคำขอ Place Details (ใหม่), Nearby Search (ใหม่) หรือ Text Search (ใหม่) ในพร็อพเพอร์ตี้ 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[] — การระบุแหล่งที่มาที่จำเป็น ฟิลด์นี้ จะแสดงเสมอ แต่ก็อาจว่างเปล่าได้

รูปภาพที่ 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 (ใหม่) ที่สำเร็จคือรูปภาพ

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

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

เกินโควต้า (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 Explorer แสดงไม่ได้
  4. เลือกปุ่มดำเนินการ ในกล่องโต้ตอบ ให้เลือกบัญชีที่ต้องการใช้เพื่อส่งคำขอ

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