ความสามารถของโมเดล Gemini สำหรับ Places API

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

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

แต่คุณอาจต้องศึกษาพื้นที่รอบๆ สถานีชาร์จให้ดีขึ้นด้วย โดยเฉพาะในกรณีที่คุณจะต้องอยู่ที่นั่นนานกว่า 1 ชั่วโมงขณะชาร์จรถ เมื่อใช้ความสามารถของโมเดล Gemini ในการค้นหาเดียวกัน คำตอบอาจมีคำอธิบายแบบไดนามิกที่สร้างขึ้นสำหรับสถานที่แต่ละแห่งในการตอบกลับ รวมถึงข้อมูลเกี่ยวกับบริเวณรอบๆ สถานีชาร์จ

  • "ใช้เวลาเดิน 2-4 นาทีก็มีร้านอาหารและแหล่งช็อปปิ้งมากมายให้เลือก ทั้งเชฟชู ร้านปิ้งย่างเกาหลียุคใหม่ แอมเบอร์อินเดีย แปซิฟิกแคทช์ และร้านขายของชำมากมาย เช่น Walmart, ตลาดอาหารทั้งหมด และร้านเทรเดอร์ โจ"

  • "มีร้านอาหารและร้านค้าให้เลือกมากมายในระยะเดินเพียง 1-5 นาที รวมถึง Khao Kang Thai Kitchen, Roger's Deli & Donuts และ La Costeña สำหรับซูชิ Joy Sushi เป็นตัวเลือกที่ดี สำหรับของใช้ทั่วไป Dollar Tree มีผลิตภัณฑ์หลากหลายในราคาลดพิเศษ"

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

เพิ่มฟีเจอร์ใหม่ที่ทำงานด้วยระบบ AI ลงใน Places API (ใหม่)

ความสามารถเหล่านี้จะเพิ่มข้อมูลต่อไปนี้ในการตอบกลับของ Places API (ใหม่)

ข้อมูลสรุปสถานที่แบบ Generative

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

Places API (ใหม่) มีข้อมูลสรุปสถานที่แบบ Generative 2 ประเภท ได้แก่

  • ข้อมูลสรุปภาพรวม: ภาพรวมคร่าวๆ ของสถานที่โดยเฉลี่ยประมาณ 100 อักขระ ซึ่งช่วยให้ผู้ใช้เห็นภาพรวมของสถานที่

  • สรุปคำอธิบาย: ข้อมูลสรุปที่ยาวกว่านี้เกี่ยวกับสถานที่โดยเฉลี่ยประมาณ 400 อักขระ ซึ่งให้ภาพรวมโดยละเอียดที่ครอบคลุมแง่มุมสูงสุดของสถานที่

ปัจจุบันสรุปสถานที่พร้อมใช้งานสำหรับประเภทสถานที่ที่แสดงในประเภทที่รองรับสำหรับหมวดหมู่วัฒนธรรม ความบันเทิงและสันทนาการ อาหารและเครื่องดื่ม การช็อปปิ้ง และกีฬา

ข้อมูลสรุปพื้นที่ที่สร้างขึ้น

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

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

ปัจจุบันข้อมูลสรุปพื้นที่พร้อมใช้งานสำหรับสถานที่ประเภทต่างๆ ที่แสดงในประเภทที่รองรับสำหรับหมวดหมู่ที่พัก รวมถึงสถานที่ประเภทต่างๆ ที่เฉพาะเจาะจง นั่นคือ electric_vehicle_charging_station, geocode และ premise

การสร้างข้อมูลสรุปสถานที่และพื้นที่

Google จะสร้างทั้งข้อมูลสรุปสถานที่แบบ Generative และข้อมูลสรุปพื้นที่แบบ Generative เป็นประจำแบบออฟไลน์ การสร้างข้อมูลสรุปเหล่านี้แบบออฟไลน์จะช่วยให้คุณใช้ประโยชน์จากเนื้อหาที่ขับเคลื่อนโดย Gemini ได้ในขณะที่ยังคงเห็นประสิทธิภาพแบบเดิมจาก Places API (ใหม่) ที่คุณคาดหวังไว้

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

ผลการค้นหาตามบริบท

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

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

  • เหตุใดฉันจึงเห็นสถานที่นี้ในผลการค้นหา
  • เหตุใดฉันจึงควรเลือกสถานที่นี้

ตัวอย่างเช่น คุณส่งคำขอรายละเอียดสถานที่ (ใหม่) การค้นหาข้อความ (ใหม่) หรือการค้นหาในพื้นที่ใกล้เคียง (ใหม่) ในวันนี้ ซึ่งมีการระบุสถานที่ที่เฉพาะเจาะจงในการตอบกลับ ข้อมูลคำตอบสำหรับสถานที่นั้นเหมือนกันสำหรับคำขอทั้ง 3 รายการ เนื่องจากข้อมูลที่แสดงผลเชื่อมโยงกับสถานที่นั้น

อย่างไรก็ตาม สําหรับการค้นหาข้อความ (ใหม่) ที่ใช้ความสามารถใหม่ การตอบกลับอาจรวมข้อมูลที่ได้จากสตริงการค้นหาที่ป้อน ซึ่งหมายความว่าผลการค้นหาตามบริบทจะเฉพาะเจาะจงสำหรับสตริงการค้นหา ตัวอย่างเช่น คุณส่งคำขอการค้นหาข้อความ (ใหม่) ด้วยสตริงการค้นหาต่อไปนี้

"ร้านอาหารมังสวิรัติสไปซี่ในเมาน์เทนวิว แคลิฟอร์เนีย"

จากนั้นให้ปล่อยพารามิเตอร์อินพุตทั้งหมดไว้เหมือนเดิมและเปลี่ยนเฉพาะสตริงการค้นหาเป็น

"ร้านอาหารมังสวิรัติรสเผ็ดในเมาน์เทนวิว รัฐแคลิฟอร์เนีย"

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

เปิดใช้ความสามารถของโมเดล Gemini สำหรับ Places API (ใหม่)

คุณต้องเปิดใช้ Places API (ใหม่) เพื่อใช้ความสามารถของโมเดล Gemini สำหรับ Places API (ใหม่) โปรดดูข้อมูลเพิ่มเติมที่หัวข้อตั้งค่าโปรเจ็กต์ Google Cloud

ข้อจำกัดสำหรับรุ่นทดลอง

เวอร์ชันนี้รองรับเฉพาะข้อมูลสรุปสถานที่และพื้นที่สำหรับสถานที่ในสหรัฐอเมริกาเป็นภาษาอังกฤษเท่านั้น

Gemini คืออะไร

ดูข้อมูลเกี่ยวกับโมเดล Gemini ได้ที่คําถามที่พบบ่อยเกี่ยวกับ Gemini

ขอสรุปสถานที่แบบ Generative

ข้อมูลสรุปสถานที่เป็นข้อมูลสรุปแบบ Generative ที่ LLM สร้างขึ้นสำหรับสถานที่หนึ่งๆ Places API (ใหม่) จะเพิ่มข้อมูลสรุป 2 ประเภทในการตอบกลับ

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

    • สถานที่หลายแห่งไม่มีข้อมูลสรุปโดยบรรณาธิการ จึงช่วยเติมเต็มช่องว่างของข้อมูลที่มีสำหรับสถานที่นั้นๆ

    • ข้อมูลเหล่านี้สร้างขึ้นจาก LLM ดังนั้นเจ้าของสถานที่จึงไม่จำเป็นต้องดูแลรักษา

  • คำอธิบาย ข้อมูลสรุปที่สร้างขึ้นจะมาจากหลายแหล่งที่มา รวมถึงรีวิวจาก Google Maps คำอธิบายมีความยาวโดยเฉลี่ยประมาณ 400 อักขระ รวมถึงรายการรีวิวที่ใช้สร้างคำอธิบายแบบยาว

    หากต้องการสร้างข้อมูลสรุปคำอธิบายด้วยตนเอง จะต้องมีบุคคลรวบรวมข้อมูลจากหลายตำแหน่ง แล้วเขียนและดูแลรักษาเนื้อหาด้วยตนเอง ความสามารถของโมเดล Gemini สําหรับ Places API (ใหม่) จะสร้างข้อมูลสรุปเหล่านี้จาก LLM เพื่อรักษาขอบเขตและความใหม่ของเนื้อหาที่สร้างขึ้น

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

  • รายละเอียดสถานที่: generativeSummary

  • การค้นหาข้อความและการค้นหาใกล้เคียง: places.generativeSummary

ช่อง generativeSummary มีช่องต่อไปนี้

  • generativeSummary.overview: สรุปภาพรวมของ Generative
  • generativeSummary.description: ข้อมูลสรุปของคำอธิบาย Generative
  • generativeSummary.references: อาร์เรย์สูงสุด 5 รายการที่ใช้ในการสร้างเนื้อหาสำหรับสรุปคำอธิบาย หากไม่มีคำอธิบายสรุป อาร์เรย์นี้จะว่างเปล่า
  • overviewFlagContentUri: ลิงก์ที่ผู้ใช้แจ้งปัญหาเกี่ยวกับสรุปภาพรวมได้
  • descriptionFlagContentUri: ลิงก์ที่ผู้ใช้แจ้งปัญหาเกี่ยวกับสรุปคำอธิบายได้

ตัวอย่างคำขอภาพรวมและสรุปคำอธิบาย

ตัวอย่างนี้ใช้มาสก์ช่อง places.generativeSummary เพื่อแสดงผลออบเจ็กต์ generativeSummary ทั้งหมด ซึ่งรวมถึงช่อง generativeSummary.overview, generativeSummary.description และ generativeSummary.references

curl -X  POST -d '{
  "textQuery": "Spicy Vegetarian Food",
  "location_bias":{
    "rectangle":{
      "low": {
        "latitude": 37.415,
       "longitude": -122.091},
    "high":{
      "latitude": 37.429,
      "longitude": -122.065}
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary" \
https://places.googleapis.com/v1/places:searchText

คำตอบอยู่ในรูปแบบ

{
  "places": [
    {
      "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        },
        "description": {
          "text": "Pakistani restaurant dishing up comfort food including vegetarian, vegan, and halal options.
          Offerings include chicken tikka masala, naan, and paratha. There's also a salad bar, and dessert is
          available.\nOpen for breakfast, lunch, and dinner, the venue has a casual atmosphere and outdoor rooftop
          seating. People mention the ambiance and say the service is prompt.\nCustomers typically spend $10–20.",
          "languageCode": "en-US"
        },
        "references": {
          "reviews": [
            {
              "name": "places/ChIJQ8nPjFW3j4ARcAaUg5pF-Ts/reviews/ChZDSUhNMG9nS0VJQ0FnSUN4aUtDbVJREAE",
              "relativePublishTimeDescription": "12 months ago",
              "rating": 5,
              "text": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "John Smith",
                "uri": "https://www.google.com/maps/contrib/11685942231/reviews",
                "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1d-cc-rp-mo"
              },
              "publishTime": "2023-05-09T07:24:36Z"
              "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChRAB&d=17924085&t=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m7558ccfc943:0x3bf9459a83940670"
            },
            . . .
          ]
        },
        "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzU1O085&t=12",
        "descriptionFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOG&t=12"
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Indian restaurant offering comfort food including vegetarian and vegan options.",
          "languageCode": "en-US"
        },
        . . .
}

ตัวอย่างคำขอข้อมูลสรุปภาพรวม

ตัวอย่างการค้นหาข้อความนี้แสดงเฉพาะoverviewสรุปสำหรับร้านอาหารมังสวิรัติรสเผ็ดในเมาน์เทนวิว รัฐแคลิฟอร์เนีย

curl -X  POST -d '{
  "textQuery": "Spicy Vegetarian Food",
  "location_bias":{
    "rectangle":{
      "low": {
        "latitude": 37.415,
       "longitude": -122.091},
    "high":{
      "latitude": 37.429,
      "longitude": -122.065}
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary.overview" \
https://places.googleapis.com/v1/places:searchText

การตอบกลับจะมีช่อง generativeSummary.overview ซึ่งมี overview.text และ overview.languageCode:

{
  "places": [
    {
      "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual eatery offering vegetarian & non-vegetarian Indian fare, plus breads & desserts.",
          "languageCode": "en-US"
        }
      }
    },
  . . .
}

ขอสรุปพื้นที่สร้างรายได้

ข้อมูลสรุปของพื้นที่คือข้อมูลสรุปแบบ Generative ที่ LLM สร้างขึ้นสำหรับพื้นที่ใกล้เคียงของสถานที่ ข้อมูลสรุปพื้นที่อาจมีความสำคัญต่อผู้ใช้ที่ตัดสินใจเกี่ยวกับสถานที่

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

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

หากต้องการรวมข้อมูลสรุปพื้นที่ในการตอบกลับ ให้ใส่ข้อมูลต่อไปนี้ในมาสก์ฟิลด์ของคำขอ

  • areaSummary (รายละเอียดสถานที่)
  • places.areaSummary (การค้นหาข้อความและการค้นหาในบริเวณใกล้เคียง)

ช่อง areaSummary สำหรับสถานที่ในการตอบกลับจะมีช่อง flagContentUri ที่คุณสามารถใช้เพื่อแจ้งว่าเนื้อหาไม่เหมาะสมเพื่อให้ Google นำเนื้อหาดังกล่าวออกได้ นอกจากนี้ยังมีอาร์เรย์สูงสุด 4 contentBlocks รายการ หัวข้อของแต่ละบล็อกจะอิงตามประเภทของสถานที่ดังนี้

  • สำหรับสถานีชาร์จ EV ซึ่งกำหนดว่าเป็นสถานที่ประเภท electric_vehicle_charging_station บล็อกหัวข้อจะมี "overview", "coffee", "restaurant" และ "store"

  • สําหรับสถานที่ที่มีประเภทที่กําหนดโดยหมวดหมู่ที่พัก และประเภทสถานที่ที่เฉพาะเจาะจง geocode และ premise บล็อกหัวข้อจะประกอบด้วย "overview", "activity", "restaurant" และ "store"

ตัวอย่างคำขอข้อมูลสรุประดับพื้นที่ของสถานีชาร์จ EV

ตัวอย่างคำขอรายละเอียดสถานที่นี้แสดงผลสรุปพื้นที่สำหรับสถานีชาร์จ EV ที่เฉพาะเจาะจงในเมืองเมาน์เทนวิว ซึ่งระบุด้วยรหัสสถานที่ ChIJC5b6QKiwj4ARgn2EwlnJnWU

curl -X GET -H 'Content-Type: application/json' \
  -H "X-Goog-Api-Key: API_KEY" \
  -H "X-Goog-FieldMask: id,displayName,areaSummary" \
  https://places.googleapis.com/v1/places/ChIJC5b6QKiwj4ARgn2EwlnJnWU

การตอบกลับมีฟิลด์ areaSummary ซึ่งประกอบด้วยอาร์เรย์ contentBlocks ดังนี้

  • ช่อง topic จะระบุประเภทของบล็อกเนื้อหา เนื่องจากสถานที่ในตัวอย่างนี้เป็นสถานีชาร์จ EV บล็อกเนื้อหา 4 บล็อกคือ "overview", "coffee", "restaurant" และ "store"

  • ช่อง content มีข้อมูลสรุปของหัวข้อนั้น รวมถึงรหัสภาษา

  • อาร์เรย์ references ระบุชื่อทรัพยากรสถานที่ในรูปแบบ places/PLACE_ID ที่ใช้เพื่อระบุเนื้อหาสำหรับบล็อกเนื้อหา

{
  "id": "ChIJC5b6QKiwj4ARgn2EwlnJnWU",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "areaSummary": {
    "contentBlocks": [
      {
        "topic": "overview",
        "content": {
          "text": "Within a 4-minute walk, there are several dining and shopping options from this charging station, including Starbucks and Los Altos Taqueria.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY",
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ"
          ]
        }
      },
      {
        "topic": "coffee",
        "content": {
          "text": "Starbucks offers Wi-Fi, light bites, and its signature roasts in a cozy space.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY"
          ]
        }
      },
      {
        "topic": "restaurant",
        "content": {
          "text": "Los Altos Taqueria serves classic Mexican dishes in a kid-friendly venue.\nHyderabad Dum Biryani specializes in vegetarian and vegan Indian fare, including lunch and dinner options.\nSushi Jin is a popular spot for sushi and other Japanese dishes, featuring a relaxed atmosphere.\nSuper tacos el conrro is a kid-friendly spot for Mexican fare.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ",
            "places/ChIJETHw0F-7j4AR85V_I6OobCI",
            "places/ChIJ-9pg_Qmxj4AR4deSLfZINW0",
            "places/ChIJvcqEhTyxj4AR4ZdQevNxGZk"
          ]
        }
      },
      {
        "topic": "store",
        "content": {
          "text": "Safeway provides a range of groceries, along with a deli and a bakery.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJF7_iDaiwj4ARzdC4NlGzJFI"
          ]
        }
      }
    ],
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=IhkpuV1UwBQ&d=17924085&t=12"
  }
}

ตัวอย่างคำขอข้อมูลสรุปพื้นที่สำหรับโรงแรม

ตัวอย่างคำขอการค้นหาข้อความนี้ขอโรงแรมในเมาน์เทนวิว รัฐแคลิฟอร์เนีย

curl -X  POST -d '{
  "textQuery": "Hotels",
  "location_bias":{
    "rectangle":{
      "low": {
        "latitude": 37.415,
       "longitude": -122.091},
    "high":{
      "latitude": 37.429,
      "longitude": -122.065}
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.areaSummary" \
https://places.googleapis.com/v1/places:searchText

การตอบกลับจะมีช่อง areaSummary รวมถึงอาร์เรย์ contentBlocks การตอบกลับสำหรับสถานที่ประเภทโรงแรมมีบล็อกเนื้อหาสำหรับหัวข้อ "overview", "activity", "restaurant" และ "store"

{
  "places": [
    {
      "id": "ChIJ81X7bC63j4ARNJTuqMFBq-4",
      "displayName": {
        "text": "Shashi Hotel Mountain View, an Urban Resort",
        "languageCode": "en"
      },
      "areaSummary": {
        "contentBlocks": [
          {
            "topic": "overview",
            "content": {
              "text": "This area offers several attractions, including Cinemark Century Mountain View 16 and Computer History Museum. Charleston Park provides picnic spots and the Pear Theatre hosts performances.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJo4za6vi5j4ARMua093RgGGA",
                "places/ChIJ4V-yslC3j4ARE6I2cpvyOeU"
              ]
            }
          },
          {
            "topic": "activity",
            "content": {
              "text": "Cinemark Century Mountain View 16 offers XD and RealD 3D screens, plus comfortable seating and a snack bar.\nComputer History Museum showcases the evolution of technology with interactive exhibits.\nRyptic Room Escape Mountain View presents themed rooms where teams solve puzzles to escape.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJ1_ZkCKqwj4ARPaLA4yiEtdI"
              ]
            }
          },
          {
            "topic": "restaurant",
            "content": {
              "text": "Cucina Venti Restaurant prepares Italian cuisine in a rustic setting with outdoor seating.\nRoger Bar and Restaurant provides cocktails on tap, along with an indoor-outdoor bar and dining area.\nBroma Restaurant serves Spanish-inspired tapas and shareable plates in a trendy atmosphere.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJC_3cdla3j4ARMgf4Pw8Irek",
                "places/ChIJh1Y1MA23j4AREJz6Kxl75Uo",
                "places/ChIJLRvDZtu3j4ARgoNrKZnNw8g"
              ]
            }
          },
          {
            "topic": "store",
            "content": {
              "text": "NASA Gear Store and Food Mart offer a variety of gifts and convenience store items.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJh64-r0O3j4ARy1P41IH2j3k",
                "places/ChIJ5ZJtB8u3j4ARR0gohzD8-ns"
              ]
            }
          }
        ],
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=GQAAAA085&t=12"
      }
    },
    ...
  ]
}

ขอผลการค้นหาตามบริบท

การตอบกลับคําขอการค้นหาข้อความ (ใหม่) จะมีอาร์เรย์ของสถานที่ที่ตรงกับเกณฑ์ของสตริงการค้นหาที่ป้อน ตอนนี้คุณสามารถขอข้อมูลการค้นหาตามบริบทในการตอบกลับโดยอิงตามข้อความค้นหาที่ป้อนไปยัง API

เพื่อรองรับการสรุปตามบริบท การตอบกลับจากการค้นหาข้อความ (ใหม่) มีอาร์เรย์ใหม่ชื่อ contextualContents ที่ระดับเดียวกับอาร์เรย์ places ในการตอบกลับ

{
  "places": [],
  "contextualContents":[]
}

องค์ประกอบแต่ละรายการในอาร์เรย์ contextualContents ประเภท ContextualContent จะอยู่ที่ตำแหน่งอาร์เรย์ที่เกี่ยวข้องเป็นตำแหน่งในอาร์เรย์ places กล่าวคือ องค์ประกอบที่ contextualContents[0] สอดคล้องกับตําแหน่งที่ places[0]

องค์ประกอบอาร์เรย์แต่ละรายการจะมีช่องอาร์เรย์ต่อไปนี้

  • contextualContents.reviews: อาร์เรย์ของรีวิวสูงสุด 3 รายการ
  • contextualContents.photos: อาร์เรย์ของรูปภาพไม่เกิน 5 รูป
  • contextualContents.justifications: อาร์เรย์ของเหตุผลสำหรับสถานที่ ซึ่งรวมถึง

    • reviewJustification: ไฮไลต์ส่วนต่างๆ ของรีวิวผู้ใช้ที่อาจเป็นประโยชน์ต่อผู้ใช้ปลายทาง
    • businessAvailabilityAttributesJustification: มีแอตทริบิวต์สําหรับธุรกิจที่ผู้ใช้ปลายทางอาจสนใจ

หากต้องการรวมผลการค้นหาตามบริบทในการตอบกลับ ให้ใส่ contextualContents ในมาสก์ช่องของคำขอการค้นหาข้อความ (ใหม่)

curl -X  POST  -d '{
  "textQuery": "Spicy vegetarian restaurant in Mountain View, CA",
  "openNow": true,
  "maxResultCount": 3
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,contextualContents" \
https://places.googleapis.com/v1/places:searchText

คำตอบมีอาร์เรย์ contextualContents สำหรับสถานที่แต่ละแห่งในการตอบกลับ ดังนี้

{
  "places": [
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      }
    },
    . . .
  ],
  "contextualContents": [
    {
      "reviews": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSURSeEtMdHZ3RRAB",
          "relativePublishTimeDescription": "a year ago",
          "rating": 5,
          "text": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset to
            the tofu 65) and veg pakoras (very crunchy and awesome flavor). We
            enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset
            to the tofu 65) and veg pakoras (very crunchy and awesome flavor).
            We enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Jane Doe",
            "uri": "https://www.google.com/maps/contrib/113193/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwrp-mo-br100"
          },
          "publishTime": "2023-04-18T02:48:02Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF24085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!1sChZDSUhb1e9679abc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhzlhTG53RRAB",
          "relativePublishTimeDescription": "10 months ago",
          "rating": 5,
          "text": {
            "text": "This is a nice little spot to eat at. I'm a big fan of
            curries, and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "This is a nice little spot to eat at. I'm a big fan of curries,
            and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Bob Jones",
            "uri": "https://www.google.com/maps/contrib/11034435/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9p-mo-ba4-br100"
          },
          "publishTime": "2023-07-03T16:51:49Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF3EAE&d=17924085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhb1e9679abc80b8db"
        },
        . . .
      ],
      "photos": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/Vt2DAKajwJfgC_I-baPKjSeSw-JAXY-tCZOBAe7pBxxIS0Vo1w23sCO9o5RzoxJ",
          "widthPx": 1920,
          "heightPx": 1080,
          "authorAttributions": [
            {
              "displayName": "A Google User",
              "uri": "//maps.google.com/maps/contrib/113010465422",
              "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgyc0-p-k-no-mo"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChZDSWkF3EAE&d=15&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhNbc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9Nwhk24vK212hZo",
          "widthPx": 960,
          "heightPx": 720,
          "authorAttributions": [
            {
              "displayName": "Toast"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId4085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!b1e9679abc80b8db"
        },
        . . .
      ],
      "justifications": [
        {
          "reviewJustification": {
            "highlightedText": {
              "text": "\"Not too spicy or oily.\"",
              "highlightedTextRanges": [
                {
                  "startIndex": 9,
                  "endIndex": 14
                }
              ]
            },
            "review": {
              "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChZDSUhNMG9nS0VJQ0FnSUR4djR2Z1B3EAE",
              "relativePublishTimeDescription": "10 months ago",
              "rating": 5,
              "text": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "Stan Davis",
                "uri": "https://www.google.com/maps/contrib/112959/reviews",
                "photoUri": "https://lh3.googleuser-cc-rp-mo"
              },
              "publishTime": "2023-06-18T06:12:41Z",
              "flagContentUri": "https://www.google.com/local/review/rap/report?postt=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/75a95dd8ebd:0xb1e9679abc80b8db"
            }
          }
        },
        {
          "businessAvailabilityAttributesJustification": {
            "dineIn": true
          }
        }
      ]
    },
    . . .
  ]
}

คำแนะนำการใช้งานสำหรับกรณีการใช้งานยานยนต์

Google ขอแนะนำให้แสดงผลข้อมูลสรุปของ Generative AI ในโหมด "จอดรถ" สำหรับประสบการณ์การใช้งานยานยนต์เพื่อความปลอดภัยของผู้ขับขี่ หากแสดงภาพสรุปในโหมดขับรถ ข้อมูลบนหน้าจอควรเรียบง่าย ชัดเจน และกระชับเพื่อให้แน่ใจว่าความสนใจของผู้ขับจะกลับมาที่ถนนได้อย่างรวดเร็ว

  • ไม่เกิน 3 บรรทัด
  • 120 อักขระหรือ 24 คำหรือน้อยกว่า
  • ขนาดด้านหน้าขั้นต่ำ 24 dp

โดยเฉพาะอย่างยิ่งในบริบทยานยนต์ นักพัฒนาแอปมีหน้าที่รับผิดชอบในการแสดงผลข้อมูลสรุปของ Generative AI ในลักษณะที่ปลอดภัยและเป็นไปตามกฎหมายและกฎระเบียบท้องถิ่นทั้งหมด

การระบุแหล่งที่มา

เมื่อแสดงรีวิว รูปภาพ และข้อมูลสรุปที่ Generative AI สร้างขึ้นในแอป ซึ่งรวมถึงทั้งข้อมูลสรุปสถานที่และพื้นที่ คุณต้องแสดงการระบุแหล่งที่มาที่จําเป็นด้วย

แสดงการระบุแหล่งที่มาของข้อมูลสรุปแบบ Generative

เมื่อแสดงข้อมูลสรุปที่ AI สร้างขึ้นในแอป ซึ่งรวมถึงข้อมูลสรุปสถานที่และพื้นที่ คุณต้องแสดงการระบุแหล่งที่มาที่จำเป็นด้วย ส่วนนี้จะอธิบายวิธีแสดงการระบุแหล่งที่มาโดยอิงตามวิธีแสดงข้อมูลสรุปของ Generative AI ในแอป

ในทุกกรณี การระบุแหล่งที่มาต้องใช้ตัวพิมพ์ประโยค การระบุแหล่งที่มาและโลโก้ Google ต้องเป็นไปตามมาตรฐานสี รูปแบบ และแบบอักษรทั้งหมด ดูข้อมูลเพิ่มเติมเกี่ยวกับมาตรฐานเหล่านี้ได้ที่นโยบายสําหรับ Places API (ใหม่)

ข้อมูลสรุป Generative AI ที่แสดงในบริบทของข้อมูลอื่นๆ ของ Google

ในกรณีนี้ การระบุแหล่งที่มาของ Generative AI จะแสดงเดี่ยวๆ เหนือหรือใต้ข้อมูลสรุป โดยอาศัยการระบุแหล่งที่มาของ Google สำหรับเนื้อหาในที่อื่นๆ

สำหรับข้อมูลระบุแหล่งที่มา ให้ใช้ข้อความ "สรุปโดย AI" ดังที่แสดงในภาพนี้

สำหรับการระบุแหล่งที่มา ให้ใช้ข้อความที่สรุปโดย AI

ข้อมูลสรุป Generative AI ที่แสดงแยกต่างหาก

เมื่อสรุปจาก Generative AI ปรากฏแยกจากเนื้อหาอื่นๆ จาก Google Maps จะต้องมีทั้งการระบุแหล่งที่มาของ Generative AI และการระบุแหล่งที่มาของ Google โดยคั่นด้วยเครื่องหมายวรรคตอน สำหรับการระบุแหล่งที่มา ให้ใช้ข้อความ "สรุปโดย AI" และโลโก้ของ Google ตามที่แสดงในรูปภาพนี้

สําหรับข้อมูลสรุปที่แสดงแยกต่างหาก ให้ใส่การระบุแหล่งที่มาของ Generative AI และการระบุแหล่งที่มาของ Google โดยคั่นด้วยเครื่องหมายวรรคตอน

สรุป Generative AI ที่ซ้ำกันในรายการ

เมื่อใช้ ภาพรวมข้อมูลสรุปของสถานที่ที่ Generative AI สร้างขึ้นซ้ำในรายการสถานที่ โดยที่

  • เนื้อหารายการระบุแหล่งที่มาว่ามาจาก Google
  • ข้อมูลสรุปที่แสดงเป็นข้อมูลที่ AI สร้างขึ้น
  • เนื้อหาพร้อมให้ใช้งานจาก Google

การระบุแหล่งที่มาควรแสดงเหนือหรือใต้รายการเป็นบรรทัดเดียว การระบุแหล่งที่มาของ AI จะจัดชิดซ้าย และการระบุแหล่งที่มาของ Google จะจัดชิดขวา

สำหรับรายการ ให้แสดงการระบุแหล่งที่มาเหนือหรือใต้รายการในบรรทัดเดียว

หากมีการใช้สรุปคำอธิบายแบบยาวที่ AI สร้างขึ้นในรายการ สรุปแต่ละรายการต้องมีการระบุแหล่งที่มาของ AI ("สรุปโดย AI" พร้อมไอคอน/ปุ่มข้อมูล)

แสดงข้อมูลเกี่ยวกับข้อมูลสรุปของ Generative AI ในกล่องโต้ตอบ

นอกจากสรุป Generative AI แล้ว คุณยังต้องสร้างกล่องโต้ตอบสำหรับผู้ใช้ปลายทางที่แสดงข้อมูลเกี่ยวกับสรุป รวมถึงลิงก์สำหรับรายงานปัญหาโดยใช้ตัวระบุที่ไม่ซ้ำกันของสรุปที่อยู่ในช่อง flagContentUri เมื่อใช้สรุปคำอธิบายของ Generative AI คุณต้องใส่ข้อมูลเกี่ยวกับแหล่งที่มาของสรุปที่เรียกว่าข้อมูลอ้างอิง

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

สำหรับสรุปสถานที่แบบ Generative ให้แสดงข้อมูลต่อไปนี้

เกี่ยวกับ ข้อมูลสรุปสถานที่ของ AI สร้างขึ้นจากรีวิวใน Google และข้อมูลอื่นๆ
รายงานปัญหา หากต้องการรายงานปัญหาเกี่ยวกับเนื้อหาของข้อมูลสรุปให้ Google ทราบ ให้ใช้ลิงก์ที่อยู่ในช่อง flagContentUri
ข้อมูลอ้างอิง รีวิวแหล่งที่มา

เช่น

แสดงข้อมูลเกี่ยวกับข้อมูลสรุปของ Generative AI ในกล่องโต้ตอบ

สำหรับข้อมูลสรุปพื้นที่ทั่วไป ให้แสดงข้อมูลต่อไปนี้

เกี่ยวกับ ข้อมูลสรุปพื้นที่ของ AI สร้างขึ้นจากรีวิวใน Google และข้อมูลในพื้นที่
รายงานปัญหา หากต้องการรายงานปัญหาเกี่ยวกับเนื้อหาของข้อมูลสรุปให้ Google ทราบ ให้ใช้ลิงก์ที่อยู่ในช่อง flagContentUri

แสดงการระบุแหล่งที่มาของข้อมูลสรุปพื้นที่