ค้นหาสถานที่

เครื่องมือ search_places ช่วยให้ LLM ค้นหาสถานที่ใน Google Maps จากคำค้นหาที่เป็นภาษาธรรมชาติได้ เครื่องมือจะแสดงข้อมูลสรุปที่ AI สร้างขึ้นเกี่ยวกับสถานที่ที่ตรงกัน สำหรับสถานที่แต่ละแห่งที่ข้อมูลสรุปอ้างอิง ระบบจะแสดงรหัสสถานที่ พิกัด ลิงก์ Google Maps และการระบุแหล่งที่มาด้วย

หน้านี้อธิบายตัวเลือกคำขอ ซึ่งรวมถึงตัวเลือก Pro, สิ่งที่การตอบกลับมี และวิธีเรียกเก็บเงินสำหรับคำขอ ดูสคีมาเครื่องมือแบบเต็มได้ที่ข้อมูลอ้างอิง search_places

ตัวเลือกคำขอ

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

ตัวเลือก คำอธิบาย
text_query ต้องระบุ คำค้นหา เช่น coffee shops near Golden Gate Park คำค้นหาต้องมีข้อมูลตำแหน่งที่เพียงพอเพื่อให้ไม่กำกวม หรือคำขอต้องมี location_bias
location_bias วงกลม (center และ radius_meters ที่ไม่บังคับ สูงสุด 50,000 เมตร) เพื่อให้น้ำหนักผลการค้นหา หาก text_query ระบุสถานที่ตั้งที่ชัดเจน ระบบจะใช้สถานที่ตั้งนั้นแทน
language_code ภาษาของข้อมูลสรุป เช่น en หรือ ja ค่าเริ่มต้นคือภาษาอังกฤษ
region_code รหัสภูมิภาค CLDR ของผู้ใช้ เช่น US ส่งผลต่อชื่อสถานที่เฉพาะภูมิภาคและอาจส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง
page_size จำนวนสถานที่สูงสุดที่จะแสดงผล ค่าเริ่มต้นคือ 5 ค่าตั้งแต่ 6 ถึง 10 เป็นตัวเลือกแบบมือโปร ค่าที่มากกว่า 10 จะแสดงข้อผิดพลาด INVALID_ARGUMENT บริการอาจแสดงผลสถานที่น้อยกว่าที่ขอ
include_extended_details เมื่อtrue ข้อมูลสรุปจะมีรายละเอียดสถานที่เพิ่มเติม นี่คือตัวเลือกแบบมือโปร ค่าเริ่มต้นคือ false

ตัวเลือก Pro

เลือก SKU รุ่น Pro ได้ 2 ตัวเลือก คำขอที่ใช้ SKU อย่างใดอย่างหนึ่งหรือทั้ง 2 รายการจะเรียกเก็บเงินภายใต้ SKU ระดับ Pro ดังนี้

ตัวเลือก Pro ใช้เมื่อใด
ตั้งค่าที่อยู่include_extended_detailsเป็น true แล้ว คำขอของผู้ใช้ต้องการรายละเอียดสถานที่เพิ่มเติม เช่น ข้อมูลเชิงลึกจากรีวิว ไฮไลต์เมนู บรรยากาศ หรือเคล็ดลับสำหรับผู้เข้าชม
page_size จาก 6 เป็น 10 ผู้ใช้ต้องการเปรียบเทียบสถานที่มากกว่า 5 แห่ง

คำขอที่ไม่ได้ใช้ตัวเลือกใดเลย รวมถึงคำขอที่มี page_size ตั้งแต่ 1 ถึง 5 จะเรียกเก็บเงินภายใต้ SKU ของ Essentials

รายละเอียดสถานที่เพิ่มเติม

ตั้งค่า include_extended_details เป็น true เมื่อคำขอของผู้ใช้ต้องการข้อมูลเชิงลึกเชิงคุณภาพ สภาพการณ์แบบเรียลไทม์ หรือแอตทริบิวต์เฉพาะทาง เช่น

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

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

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

รายละเอียดเพิ่มเติมจะไม่เปลี่ยนโครงสร้างของคำตอบ หากไม่มีข้อมูลดังกล่าว ข้อมูลสรุปจะอธิบายสถานที่แต่ละแห่งใน 1-2 ประโยค ซึ่งจะช่วยให้แต่ละสถานที่มีคำอธิบายที่ยาวขึ้นซึ่งดึงข้อมูลจาก Google Maps มากขึ้น รวมถึงข้อมูลเชิงลึกจากรีวิว รายการ places ที่มีโครงสร้างจะเหมือนกันสำหรับ SKU ทั้ง 2 รายการ

ตัวอย่าง

คำขอต่อไปนี้จะขอสถานที่สูงสุด 8 แห่งพร้อมรายละเอียดเพิ่มเติม โดยจะเรียกเก็บเงินภายใต้ SKU ของ Pro ดังนี้

{
  "method": "tools/call",
  "params": {
    "name": "search_places",
    "arguments": {
      "text_query": "date night Italian restaurants in Chicago",
      "page_size": 8,
      "include_extended_details": true
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}

หากไม่มีรายละเอียดเพิ่มเติม ข้อมูลสรุปจะอธิบายสถานที่แต่ละแห่งใน 1 หรือ 2 ประโยค ดังนี้

Example Trattoria [0] (4.6★ (1,250) · 123 W Example St · $$$) A neighborhood trattoria known for handmade pasta and a long wine list.

With extended details, the summary adds what reviewers highlight and practical tips:

Example Trattoria [0] (4.6★ (1,250) · 123 W Example St · $$$) ห้องอาหารบรรยากาศอบอุ่นใต้แสงเทียนที่ผู้รีวิวบอกว่าโรแมนติกแต่เสียงดังในช่วงสุดสัปดาห์ อาหารจานเด่น ได้แก่ ตัลยาเตลเล อัล รากู, บูร์ราตา และทีรามิสุ แนะนำให้จองล่วงหน้า ลูกค้าที่วอล์กอินเข้ามาอาจต้องรอ 30-45 นาทีในช่วงเย็นวันศุกร์และวันเสาร์ และที่จอดรถริมถนนมีจำนวนจำกัด

คำตอบ

การตอบกลับประกอบด้วยข้อมูลต่อไปนี้

  • summary: ข้อมูลสรุปผลการค้นหาด้วยภาษาธรรมชาติ ซึ่งอาจมีการอ้างอิงแบบอิงฐานศูนย์ เช่น [0] ที่แมปกับรายการใน places
  • places[]: สถานที่ที่พูดถึงในข้อมูลสรุป สถานที่แต่ละแห่งประกอบด้วยข้อมูลต่อไปนี้
    • place: ชื่อทรัพยากรของสถานที่ในรูปแบบ places/{id}
    • id: รหัสสถานที่ คุณสามารถใช้ Place ID กับ Google Maps Platform API อื่นๆ ได้ เช่น เพื่อแสดงสถานที่บนแผนที่
    • location: ละติจูดและลองจิจูดของสถานที่
    • googleMapsLinks: ลิงก์ Google Maps สำหรับสถานที่ (placeUrl) เส้นทาง (directionsUrl) รีวิว (reviewsUrl) รูปภาพ (photosUrl) และการเขียนรีวิว (writeAReviewUrl)
    • attribution: การระบุแหล่งที่มาที่คุณต้องแสดงพร้อมกับสถานที่ ดูข้อกำหนดในการระบุแหล่งที่มา

การตอบกลับมีโครงสร้างเดียวกันสำหรับ SKU ทั้ง 2 รายการ ดูรายละเอียดช่องได้ในข้อมูลอ้างอิง search_places

ตัวเลือก Pro ในช่วง GA แบบจำกัด

ในช่วง GA แบบจำกัด ตัวเลือก Pro จะใช้ได้กับโปรเจ็กต์ในรายการที่อนุญาตของ Pro เท่านั้น หากโปรเจ็กต์ของคุณยังไม่อยู่ในรายการที่อนุญาต ระบบจะละเว้นตัวเลือก Pro แทนที่จะปฏิเสธ

  • ระบบจะถือว่า include_extended_details เป็น false
  • ค่า page_size ที่มากกว่า 5 รวมถึงค่าที่มากกว่า 10 จะลดลงเหลือ 5

ระบบจะเรียกเก็บเงินสำหรับคำขอภายใต้ SKU ของ Essentials หากต้องการขอสิทธิ์เข้าถึง โปรดดูตัวเลือก Pro ในช่วง GA แบบจำกัด

การเรียกเก็บเงินและโควต้า

คำขอ search_places แต่ละรายการเป็นเหตุการณ์ที่เรียกเก็บเงินได้ 1 รายการ ดังนี้

โควต้า search_places คือ 300 คำค้นหาต่อนาทีต่อโปรเจ็กต์ โดยใช้ร่วมกันทั้ง 2 SKU ดูราคาได้ที่ตารางราคาหลักและตารางราคาสำหรับอินเดีย