חיפוש מקומות

הכלי search_places מאפשר למודל LLM למצוא מקומות במפות Google באמצעות שאילתה בשפה טבעית. הכלי מחזיר סיכום שנוצר על ידי AI של המקומות התואמים. לכל מקום שמוזכר בסיכום, הוא גם מחזיר את מזהה המקום, הקואורדינטות, הקישורים למפות Google והשיוך (Attribution).

בדף הזה מתוארות האפשרויות של הבקשה, כולל האפשרויות של 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 הם אפשרות Pro. ערכים מעל 10 מחזירים שגיאת INVALID_ARGUMENT. יכול להיות שהשירות יחזיר פחות מקומות מהמספר שביקשתם.
include_extended_details כשהערך הוא true, הסיכום כולל פרטי מקום מורחבים. זו אפשרות ב-Pro. ברירת המחדל היא false.

אפשרויות מתקדמות

שתי אפשרויות לבחירת המק"ט של Pro. בקשה שכוללת אחד מהם או את שניהם מחויבת לפי המק"ט של Pro:

אפשרות Pro מתי כדאי להשתמש בו
הכתובת true הוגדרה כמיקום הinclude_extended_details הבקשה של המשתמש דורשת פרטי מקום מורחבים, כמו תובנות מביקורות, מנות מומלצות בתפריט, אווירה או טיפים למבקרים.
‫page_size מ-6 עד 10 המשתמש רוצה להשוות בין יותר מ-5 מקומות.

בקשות שלא משתמשות באף אחת מהאפשרויות, כולל בקשות עם page_size מ-1 עד 5, מחויבות במסגרת המק"ט של Essentials.

פרטים מורחבים על המקום

מגדירים את include_extended_details כ-true כשהבקשה של המשתמש דורשת תובנות איכותיות, תנאים בזמן אמת או מאפיינים מיוחדים, כמו:

  • מה כותבי הביקורות אומרים: תובנות שמבוססות על ביקורות, סנטימנט של לקוחות ומשוב.
  • הצעות ספציפיות: פריטים בתפריט, מנות, מאכלים מיוחדים, משקאות או מאפיינים בולטים של העסק.
  • אווירה: עיצוב פנים, אסתטיקה, אווירה או מצב רוח.
  • טיפים מעשיים למבקרים: האם צריך להזמין מקום מראש, מדיניות לגבי קבלת קהל ללא תיאום מראש, זמני המתנה, רמת העומס במקום, חנייה ומתקנים.
  • קרבה: המרחק או זמן ההגעה מהמיקום שצוין בשאילתה, או ממרכז location_bias, כשהמשתמש שואל מה נמצא בקרבת מקום או הכי קרוב.

התובנות בסיכום תלויות בשאילתה ובנתונים שזמינים לכל מקום. לא כל סוג של תובנה מופיע בכל תשובה.

משאירים את הערך false (ברירת המחדל) לחיפושים רגילים: סוגי מטבחים או חנויות, כתובות, פרטים ליצירת קשר, שעות פתיחה ושירותים רגילים. בקשות עם פרטים מורחבים נמשכות יותר זמן.

הפרטים הנוספים לא משנים את מבנה התשובה. בלעדיהם, הסיכום מתאר כל מקום במשפט או שניים. הם מאפשרים להוסיף לכל מקום תיאור ארוך יותר שמבוסס על יותר נתונים ממפות Google, כולל תובנות מביקורות. הערכים המובְנים של places זהים בשני המק"טים.

דוגמה

הבקשה הבאה מבקשת עד 8 מקומות עם פרטים מורחבים. החיוב מתבצע לפי המק"ט של 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
}

בלי פרטים מורחבים, הסיכום מתאר כל מקום במשפט או שניים:

מסעדת פועלים איטלקית לדוגמה [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: מזהה המקום. אפשר להשתמש בו עם ממשקי API אחרים של Google Maps Platform, למשל כדי להציג את המקום במפה.
    • ‫location: קו הרוחב וקו האורך של המקום.
    • ‫googleMapsLinks: קישורים למפות Google למקום (placeUrl), מסלול (directionsUrl), ביקורות (reviewsUrl), תמונות (photosUrl) וכתיבת ביקורת (writeAReviewUrl).
    • ‫attribution: השיוך שצריך להציג עם המקום. דרישות ייחוס

התשובה כוללת את אותו מבנה לשני המק"טים. לפרטים על השדות, ראו חומר העזר של search_places.

אפשרויות ב-Pro במהלך הזמינות הכללית המוגבלת

במהלך תקופת הזמינות הכללית המוגבלת, האפשרויות של גרסת Pro זמינות רק לפרויקטים שנמצאים ברשימת ההיתרים של גרסת Pro. אם הפרויקט שלכם עדיין לא ברשימת ההיתרים, המערכת מתעלמת מהאפשרויות של Pro במקום לדחות אותן:

  • ‫include_extended_details נחשב כ-false.
  • page_size ערכים מעל 5, כולל ערכים מעל 10, מופחתים ל-5.

הבקשה מחויבת במסגרת המק"ט של Essentials. כדי לבקש גישה, קראו את המאמר אפשרויות Pro במהלך תקופת הזמינות הכללית המוגבלת.

חיוב ומכסות

כל בקשה של search_places היא אירוע אחד שניתן לחיוב:

המכסה של search_places היא 300 שאילתות לדקה לכל פרויקט, והיא משותפת לשני המק"טים. למידע על מחירים, ראו את טבלת התמחור הראשית ואת טבלת התמחור בהודו.