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

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

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

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

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

  • "เดิน 1-5 นาทีก็มีร้านอาหารและแหล่งช็อปปิ้งให้เลือกมากมาย ทั้งร้านเขาคังไทย โรเจอร์ส์เดลิแอนด์โดนัท และลาคอสเตนญา สำหรับซูชิ Joy Sashi ก็เป็นตัวเลือกที่ดี สำหรับของชำ ต้นไม้ดอลลาร์ มีสินค้าหลากหลายในราคาหลังหักส่วนลด"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Gemini คืออะไร

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ตัวอย่างการค้นหาข้อความนี้จะแสดงข้อมูลสรุป 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"
        }
      }
    },
  . . .
}

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

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

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

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

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

  • 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 คุณต้องใส่ข้อมูลเกี่ยวกับแหล่งที่มาของสรุปที่เรียกว่าreferences

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

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

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

เช่น

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

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

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

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