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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ข้อมูลสรุปเกี่ยวกับการสร้างพื้นที่

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Gemini คืออะไร

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

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

ข้อมูลสรุปสถานที่คือข้อมูลสรุปที่สร้างขึ้นจาก 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 รายการเพื่อมอบเนื้อหาสำหรับสรุปคำอธิบาย หากไม่มีสรุปคำอธิบาย อาร์เรย์นี้จะว่างเปล่า

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

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

ขอสรุปพื้นที่การสร้าง

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

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

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

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

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

ช่อง areaSummary ของสถานที่หนึ่งๆ ในการตอบกลับมีอาร์เรย์สูงสุด 4 รายการ contentBlocks หัวข้อของแต่ละบล็อกจะขึ้นอยู่กับประเภทของสถานที่ ดังนี้

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

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

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

ตัวอย่างคำขอรายละเอียดสถานที่นี้จะแสดงข้อมูลสรุปพื้นที่ของสถานีชาร์จ EV ที่เจาะจงใน Mountain View ซึ่งระบุด้วยรหัสสถานที่ 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"
          ]
        }
      }
    ]
  }
}

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

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

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

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

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

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

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

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

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

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

เมื่อแสดงข้อมูลสรุปของ 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 ตอบสนองต่อการกด/คลิก

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

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

เช่น

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

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

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

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