Tìm kiếm địa điểm

Công cụ search_places cho phép LLM tìm địa điểm trên Google Maps từ một truy vấn bằng ngôn ngữ tự nhiên. Công cụ này sẽ trả về một bản tóm tắt do AI tạo về các địa điểm phù hợp. Đối với mỗi địa điểm mà bản tóm tắt trích dẫn, bản tóm tắt cũng trả về Mã địa điểm, toạ độ, đường liên kết đến Google Maps và thông tin ghi nhận tác giả.

Trang này mô tả các lựa chọn yêu cầu, bao gồm cả các lựa chọn Pro; nội dung phản hồi; và cách tính phí cho các yêu cầu. Để xem giản đồ đầy đủ của công cụ, hãy xem tài liệu tham khảo về search_places.

Tuỳ chọn yêu cầu

LLM đặt các tuỳ chọn này khi gọi công cụ, dựa trên yêu cầu của người dùng và nội dung mô tả công cụ. Bạn có thể tác động đến các lựa chọn mà mô hình sử dụng bằng hướng dẫn của riêng bạn; hãy xem phần Kiểm soát việc sử dụng Pro.

Phương thức Mô tả
text_query Bắt buộc. Cụm từ tìm kiếm, ví dụ: coffee shops near Golden Gate Park. Cụm từ tìm kiếm phải chứa đủ thông tin vị trí để không gây nhầm lẫn hoặc yêu cầu phải bao gồm location_bias.
location_bias Một vòng tròn (center và radius_meters không bắt buộc, tối đa 50.000 mét) để ưu tiên kết quả. Nếu text_query đặt tên cho một vị trí rõ ràng, thì vị trí đó sẽ được sử dụng.
language_code Ngôn ngữ của bản tóm tắt, ví dụ: en hoặc ja. Mặc định là tiếng Anh.
region_code Mã vùng CLDR của người dùng, ví dụ: US. Ảnh hưởng đến tên địa điểm theo khu vực cụ thể và có thể ảnh hưởng đến kết quả dựa trên luật hiện hành.
page_size Số lượng địa điểm tối đa cần trả về. Giá trị mặc định là 5. Giá trị từ 6 đến 10 là Lựa chọn chuyên nghiệp. Các giá trị lớn hơn 10 sẽ trả về lỗi INVALID_ARGUMENT. Dịch vụ có thể trả về ít địa điểm hơn so với yêu cầu.
include_extended_details Khi true, bản tóm tắt sẽ bao gồm thông tin chi tiết mở rộng về địa điểm. Đây là một lựa chọn của gói Pro. Giá trị mặc định là false.

Lựa chọn chuyên nghiệp

Hai lựa chọn chọn SKU Pro. Yêu cầu sử dụng một hoặc cả hai tham số này sẽ được tính phí theo SKU Pro:

Lựa chọn chuyên nghiệp Trường hợp sử dụng
include_extended_details được đặt thành true Yêu cầu của người dùng cần có thông tin chi tiết mở rộng về địa điểm, chẳng hạn như thông tin chi tiết từ các bài đánh giá, món ăn nổi bật trong thực đơn, bầu không khí hoặc mẹo dành cho khách tham quan.
page_size từ 6 đến 10 tuổi Người dùng muốn so sánh hơn 5 địa điểm.

Những yêu cầu không sử dụng lựa chọn nào, bao gồm cả những yêu cầu có page_size từ 1 đến 5, sẽ được tính phí theo SKU Essentials.

Thông tin chi tiết mở rộng về địa điểm

Đặt include_extended_details thành true khi yêu cầu của người dùng cần thông tin chi tiết định tính, điều kiện theo thời gian thực hoặc thuộc tính chuyên biệt, chẳng hạn như:

  • Ý kiến của người đánh giá: thông tin chi tiết dựa trên bài đánh giá, cảm nhận và ý kiến phản hồi của khách hàng.
  • Sản phẩm/dịch vụ cụ thể: món trong thực đơn, món ăn, món ăn đặc sản, đồ uống hoặc điểm nổi bật của doanh nghiệp.
  • Bầu không khí: phong cách trang trí nội thất, tính thẩm mỹ, không gian hoặc tâm trạng.
  • Mẹo thiết thực cho khách tham quan: có nên đặt trước hay không, chính sách cho khách không đặt trước, thời gian chờ, mức độ đông đúc của địa điểm, bãi đỗ xe và cơ sở vật chất.
  • Khoảng cách: khoảng cách hoặc thời gian di chuyển từ vị trí trong cụm từ tìm kiếm hoặc trung tâm location_bias, khi người dùng hỏi về địa điểm lân cận hoặc gần nhất.

Thông tin chi tiết trong bản tóm tắt phụ thuộc vào cụm từ tìm kiếm và dữ liệu có sẵn cho từng địa điểm. Không phải loại thông tin chi tiết nào cũng xuất hiện trong mọi câu trả lời.

Để nguyên giá trị false (mặc định) cho các nội dung tìm kiếm thông thường: ẩm thực hoặc loại cửa hàng, địa chỉ, thông tin liên hệ, giờ mở cửa và tiện nghi thông thường. Yêu cầu có thông tin chi tiết mở rộng sẽ mất nhiều thời gian hơn để hoàn tất.

Thông tin chi tiết mở rộng không làm thay đổi cấu trúc của phản hồi. Nếu không có các thuộc tính này, bản tóm tắt sẽ mô tả từng địa điểm trong một hoặc hai câu. Nhờ đó, mỗi địa điểm sẽ có một nội dung mô tả dài hơn, dựa trên nhiều dữ liệu hơn của Google Maps, bao gồm cả thông tin chi tiết từ các bài đánh giá. Các mục places có cấu trúc là giống nhau cho cả hai SKU.

Ví dụ

Yêu cầu sau đây yêu cầu tối đa 8 địa điểm có thông tin chi tiết mở rộng. Gói này được tính phí theo 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
}

Nếu không có thông tin chi tiết mở rộng, phần tóm tắt sẽ mô tả từng địa điểm trong một hoặc hai câu:

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 · $$$) Phòng ăn ấm cúng, thắp nến lung linh, được người đánh giá mô tả là lãng mạn nhưng ồn ào vào cuối tuần. Các món ăn nổi bật bao gồm tagliatelle al ragù, burrata và tiramisu. Bạn nên đặt chỗ trước; khách không đặt chỗ trước có thể phải đợi từ 30 đến 45 phút vào tối thứ Sáu và thứ Bảy, đồng thời chỗ đỗ xe trên đường cũng hạn chế.

Phản hồi

Phản hồi chứa:

  • summary: Bản tóm tắt kết quả tìm kiếm bằng ngôn ngữ tự nhiên. Câu trả lời có thể chứa các trích dẫn dựa trên số 0, chẳng hạn như [0], liên kết đến các mục trong places.
  • places[]: Các địa điểm được đề cập trong bản tóm tắt. Mỗi địa điểm bao gồm:
    • place: Tên tài nguyên của địa điểm, ở định dạng places/{id}.
    • id: Mã địa điểm. Bạn có thể sử dụng mã nhận dạng này với các API khác của Google Maps Platform, ví dụ: để hiển thị địa điểm trên bản đồ.
    • location: Vĩ độ và kinh độ của địa điểm.
    • googleMapsLinks: Đường liên kết đến Google Maps cho địa điểm (placeUrl), đường đi (directionsUrl), bài đánh giá (reviewsUrl), ảnh (photosUrl) và viết bài đánh giá (writeAReviewUrl).
    • attribution: Thông tin ghi nhận tác giả mà bạn phải hiển thị cùng với địa điểm. Xem Yêu cầu về thông tin ghi công.

Phản hồi có cùng cấu trúc cho cả hai SKU. Để biết thông tin chi tiết về trường, hãy xem tài liệu tham khảo về search_places.

Các lựa chọn Pro trong giai đoạn Phát hành rộng rãi có hạn chế

Trong giai đoạn Phát hành rộng rãi có hạn chế, các lựa chọn của gói Pro chỉ dành cho những dự án có trong danh sách cho phép của gói Pro. Nếu dự án của bạn chưa có trong danh sách cho phép, thì các lựa chọn Pro sẽ bị bỏ qua thay vì bị từ chối:

  • include_extended_details được coi là false.
  • Các giá trị page_size trên 5, bao gồm cả các giá trị trên 10, sẽ được giảm xuống còn 5.

Yêu cầu này được tính phí theo SKU Essentials. Để yêu cầu quyền truy cập, hãy xem phần Các lựa chọn cho gói Pro trong giai đoạn phát hành rộng rãi có hạn chế.

Thanh toán và hạn mức

Mỗi yêu cầu search_places là một sự kiện có tính phí:

  • Yêu cầu không sử dụng bất kỳ lựa chọn nào của gói Pro sẽ được tính phí theo SKU Essentials.
  • Yêu cầu sử dụng một lựa chọn Pro sẽ được tính phí theo SKU Pro. Việc sử dụng cả hai lựa chọn trong một yêu cầu không làm thay đổi mức phí. Để biết giá của gói Pro, hãy xem bài viết So sánh gói Essentials, Pro và Grounding with Google Maps.

Hạn mức search_places là 300 truy vấn mỗi phút, mỗi dự án, được chia sẻ bởi cả hai SKU. Để biết thông tin về giá, hãy xem Bảng giá chính và Bảng giá tại Ấn Độ.