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

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

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

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

  • "ใช้เวลาเดิน 2-4 นาทีก็มีร้านอาหารและแหล่งช็อปปิ้งหลายแห่ง มีทั้งร้าน Chef Chu's, Gen Korea Barb House, แอมเบอร์อินเดีย แปซิฟิก และร้านขายของชำมากมาย เช่น Walmart, Whole Foods Market และ Trader Joe's"

  • "เดิน 1-5 นาทีก็มีร้านอาหารและแหล่งช็อปปิ้งหลายแห่ง เช่น ร้านข้าวแกงไทย ร้าน Roger's Deli และ โดนัทและลา Costeña สำหรับซูชิ Joy Sashi ก็เป็นตัวเลือกที่ดี สำหรับของชำ ต้นดอลลาร์ นำเสนอผลิตภัณฑ์ที่หลากหลายในราคาส่วนลด"

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

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

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

สรุปเกี่ยวกับสถานที่จาก Generative

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

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

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

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

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

สรุปเกี่ยวกับพื้นที่ Generative

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Gemini คืออะไร

หากต้องการเรียนรู้เกี่ยวกับโมเดล Gemini โปรดดู คำถามที่พบบ่อย

ขอข้อมูลสรุปเกี่ยวกับสถานที่จาก Generative AI

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

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

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

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

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

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

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

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

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

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

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

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

ตัวอย่างการค้นหาข้อความนี้จะแสดงแค่ข้อมูลสรุป overview สำหรับ "รสจัด" ร้านอาหารมังสวิรัติใน Mountain View, CA:

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"
        }
      }
    },
  . . .
}

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

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

{
  "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": "Anam Qureshi",
                "uri": "https://www.google.com/maps/contrib/116859422317024657778/reviews",
                "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1dl9FTSmec0x00000000-cc-rp-mo"
              },
              "publishTime": "2023-05-09T07:24:36Z"
            },
            . . .
          ]
        }
      }
    },
    {
      "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"
        },
        . . .
}

ขอข้อมูลสรุปพื้นที่จาก Generative AI

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

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

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

หากต้องการรวมสรุปด้านต่างๆ ไว้ในคำตอบ ให้ใส่ใน ฟิลด์มาสก์ ของคำขอ:

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

areaSummary สำหรับสถานที่ในคำตอบจะมีอาร์เรย์สูงสุด 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"
          ]
        }
      }
    ]
  }
}

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

ตัวอย่างนี้ส่งคำขอการค้นหาข้อความไปยังโรงแรมใน Mountain View, CA:

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"
              ]
            }
          }
        ]
      }
    },
    ...
  ]
}

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

คำตอบสำหรับ การค้นหาข้อความ (ใหม่) คำขอมีอาร์เรย์ของสถานที่ที่ตรงกับเกณฑ์ของการค้นหาอินพุต สตริง ตอนนี้คุณสามารถขอข้อมูลการค้นหาตามบริบทในการตอบกลับตาม คำค้นหาที่ป้อนให้กับ 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": "Guillaume Riesen",
            "uri": "https://www.google.com/maps/contrib/1131462893/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwG_WXt1SjB1rJg=s128-c-c0x00000000-cc-rp-mo-br100"
          },
          "publishTime": "2023-04-18T02:48:02Z"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSUNKZzlhTG53RRAB",
          "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": "Paul Sacks",
            "uri": "https://www.google.com/maps/contrib/1106671734435/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9sVQ=s128-c-c0x00000000-cc-rp-mo-ba4-br100"
          },
          "publishTime": "2023-07-03T16:51:49Z"
        },
        . . .
      ],
      "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/113209927655010465422",
              "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgycOLDgOqPRYhzJ0EJlBFyKo9OrmacOo3C5YvrtR4Q=s100-p-k-no-mo"
            }
          ]
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9YNzyjkjDMD15gyobIQtIYg1GFPy3BdQHAaA3iNwhk24vK212hZo",
          "widthPx": 960,
          "heightPx": 720,
          "authorAttributions": [
            {
              "displayName": "Toast"
            }
          ]
        },
        . . .
      ],
      "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": "Harpal Kochar",
                "uri": "https://www.google.com/maps/contrib/1166232959/reviews",
                "photoUri": "https://lh3.googleusercoEnzB1zdrNbR00000-cc-rp-mo"
              },
              "publishTime": "2023-06-18T06:12:41Z"
            }
          }
        },
        {
          "businessAvailabilityAttributesJustification": {
            "dineIn": true
          }
        }
      ]
    },
    . . .
  ]
}

หลักเกณฑ์การใช้งานสำหรับ Use Case ยานยนต์

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

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

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

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

เมื่อคุณแสดงรีวิว รูปภาพ และข้อมูลสรุปของ 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 จัดข้อความชิดขวา:

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

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

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

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

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

ข้อมูลสรุปสถานที่จาก Generative AI จะแสดงข้อมูลต่อไปนี้

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

เช่น

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

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

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

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