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

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

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

โปรแกรมสำรวจ 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[] — การระบุแหล่งที่มาที่ต้องระบุ ช่วงเวลานี้ อยู่เสมอ แต่อาจว่างเปล่า

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

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

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

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

• ระบุชื่อรูปภาพที่ส่งไม่ถูกต้อง
• คำขอไม่มี maxHeightPx หรือ maxWidthPx พารามิเตอร์
• ตั้งค่าพารามิเตอร์ maxHeightPx หรือ maxWidthtPx แล้ว ไปยัง null
• name หมดอายุแล้ว หาก name หมดอายุ ให้สร้าง ส่งคำขอไปยังรายละเอียดสถานที่ (ใหม่) การค้นหาใกล้เคียง (ใหม่) หรือการค้นหาข้อความ (ใหม่) เพื่อดู name ใหม่

ลองใช้งาน

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

โดยวิธีส่งคำขอมีดังนี้

1. เลือกไอคอน API ที่ด้านขวาของหน้า
2. ตั้งค่าพารามิเตอร์ name เป็น วันที่

   places/PLACE_ID/photos/PHOTO_RESOURCE/media

3. ตั้งค่า skipHttpRedirect เป็น true เพื่อให้คำขอแสดงผล JSON คำตอบ ตามค่าเริ่มต้น คำขอจะส่งคืนรูปภาพ ซึ่งไม่สามารถแสดงโดย โปรแกรมสำรวจ API
4. เลือกปุ่มดำเนินการ ในป๊อปอัป ให้เลือกบัญชีที่คุณต้องการ ใช้ในการส่งคำขอ

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