ציון מותאם אישית של מיקומים ב-Places Aggregate

מטרה

תמונה

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

במסמך הזה מוסבר איך להשתמש ב-Places Aggregate API כדי ליצור ציוני מיקום דינמיים בהתאמה אישית, על סמך צפיפות המקומות באזור גיאוגרפי מוגדר. הציון, דירוג מספרי בהתאם לקריטריונים שציינתם, יראה מיד עד כמה המיקום מתאים לצרכים שלכם.

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

  • מסעדות ובתי קפה
  • פארקים ומוזיאונים
  • חנויות בגדים

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

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

לפני שקוראים את המסמך הזה, מומלץ להכיר את המסמכים הבאים:

בוחרים את סוגי המקומות הרלוונטיים.

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

  • מסעדה
  • פארק
  • clothing_store
  • מוזיאון
  • coffee_shop

בשלב הבא, מקצים משקל לכל אחד מסוגי המקומות האלה, שמשקף את החשיבות היחסית שלו בציון הסופי. המשקלים צריכים להיקבע על סמך מה שהכי חשוב לתרחיש לדוגמה ולהעדפות של המשתמשים. בדוגמה הזו, סולם השקלול יהיה בין 0 ל-1, באופן הבא:

סוג המקום

שקלול

מסעדה

0.8

פארק

0.6

clothing_store

0.3

מוזיאון

0.2

coffee_shop

0.5

שליחת קריאה ל-Places Aggregate API

אחרי שיש לכם רשימה של סוגי המקומות שמעניינים אתכם, השלב הבא הוא לשלוח קריאה ל-Places Aggregate API.

כדי להשתמש ב-Places Aggregate API, צריך להגדיר מסנן מיקום. בדוגמה הזו נשתמש ב-circle, כאשר המרכז latLng הוא המיקום של המלון, וה-radius הוא 500 מטרים. כדאי גם להגדיר את ratingFilter כך שיחזיר מקומות עם דירוג בין 3.8 ל-5, ולא יכלול בספירה מקומות עם דירוג נמוך יותר.

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

כדי להכיר את האפשרויות הזמינות, כדאי לקרוא את הקטע בנושא מסנן מיקום במסמכי התיעוד של Places Aggregate API.

שולחים קריאה ל-Places Aggregate API לכל סוג מקום ומיקום שרוצים ליצור בשבילם ציון בהתאמה אישית. לדוגמה, קריאה לסוג המקום "מסעדה" באחד מהמלונות שלכם:

curl --location 'https://areainsights.googleapis.com/v1:computeInsights' \
--header 'X-Goog-Api-Key: API_KEY \
--header 'Content-Type: application/json' \
--data '{
    "insights": [
        "INSIGHT_COUNT"
    ],
    "filter": {
        "locationFilter": {
            "circle": {
                "latLng": {
                    "latitude": 51.51611,
                    "longitude": -0.12726
                },
                "radius": 500
            }
        },
        "typeFilter": {
            "includedTypes": [
                "restaurant"
            ]
        },
        "ratingFilter": {
            "minRating": 3.8,
            "maxRating": 5
        }
    }
}'

אחרי שכל הקריאות ל-API הושלמו, הנתונים של כל מיקום ייראו כך:

סוג המקום

שקלול

ספירה

מסעדה

0.8

56

פארק

0.6

3

clothing_store

0.3

32

מוזיאון

0.2

8

coffee_shop

0.5

41

יצירת ציון מיקום בהתאמה אישית

עכשיו, כשיש לכם את מספר המקומות ואת השקלול של כל סוג מקום לכל מיקום, אתם יכולים ליצור את הציון המותאם אישית למיקום. בקטע הזה נדון בשתי אפשרויות: שימוש באלגוריתם מקומי או שימוש ב-Gemini Developer API.

אפשרות 1: שימוש באלגוריתם

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

itemCounts

typeWeights

    {
      "restaurant": 56,
      "park": 3,
      "clothing_store": 32,
      "museum": 8,
      "coffee_shop": 41
    }
    
    {
      "restaurant": 0.8,
      "park": 0.6,
      "clothing_store": 0.3,
      "museum": 0.2,
      "coffee_shop": 0.5
    }
    

כדי ליצור ציון מהספירות והשקלולים, מכפילים את itemCounts ב-typeWeights ומוסיפים את התוצאות ל-weightedCount הכולל:

let weightedCount = 0;
for (const itemType in itemCounts) {
  weightedCount += itemCounts[itemType] * typeWeights[itemType];
}
weightedCount = weightedCount.toFixed(2);

בדוגמה הזו, הפלט של השלב הזה הוא: 78.3.

עכשיו אפשר להשתמש בנורמליזציה לוגריתמית כדי ליצור את הציון הסופי של המיקום הזה בסולם שבין 0 ל-5:

if (weightedCount === 0) {
   normalizedScore = 0;
} else {
   normalizedScore = Math.log(weightedCount + 1);
}

// Clamp between 0 and 5
normalizedScore = Math.max(0, Math.min(5, normalizedScore));

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

אפשרות 2: שימוש ב-Gemini Developer API

במקום להשתמש באלגוריתם מקומי, אתם יכולים להשתמש ב-Gemini Developer API כדי לחשב את הציון המותאם אישית לכל המיקומים. פשוט מספקים את נתוני הספירה והשקלול עם הוראות מערכת לכל מיקומי המלונות.

השיטה הזו שימושית במיוחד אם יש לכם מידע מפורט שאתם רוצים לכלול בחישוב, כמו:

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

‫Gemini Developer API יכול להבין את הנתונים האיכותיים האלה ולהביא אותם בחשבון, וכך להגיע לציון מתוחכם ורלוונטי יותר, מעבר לגישה מתמטית בלבד.

אם משתמשים ב-Gemini Developer API, בנוסף לטבלה של סוגי המקומות והמשקלים שלמעלה, אפשר לקבל נתוני תיאור לכל מיקום שנראים כך:

מיקום

תיאור

51.49884, -0.17978

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

51.51750, -0.13065

מיקום מרכזי קרוב לברים ולמסעדות. רועש ועמוס בלילה, מתאים לקבוצות.

51.45712, 0.01146

אזור מגורים רחוק ממרכז העיר.

51.51271, -0.09933

מיקום מרכזי קרוב לנהר. שקט בלילה ומתאים למשפחות.

51.58502, -0.06445

אזור מגורים רחוק ממרכז העיר.

אתם יכולים לכלול בהנחיה ל-Gemini את התיאורים האיכותיים האלה, יחד עם מידע על המשתמשים או ההעדפות שלהם.

הוראות מערכת

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

You will be given a json file containing details about a number of locations grouped by their latitude and longitudes.

Within the location details is information about the count of places nearby the location that match a specific category, and the weighting of importance of that category, between 0 - 1.

You will also be given information about the user's preference, and a description of each location. Take this into consideration when generating scores.

Generate a location suitability score taking these into account for each location. The score should be between 1 - 5 inclusive, to two decimal places. The minimum score a location can receive is 1.

Output in JSON

ההוראות שלמעלה למערכת מאפשרות ל-Gemini לדעת לאילו נתונים לצפות, ומה הפלט הצפוי ממודל ה-AI. הן גם מבקשות את הפלט ב-JSON.

פלט מובנה

למרות שביקשנו מ-Gemini להפיק את התוצאה ב-JSON, אנחנו צריכים להיות ספציפיים יותר לגבי מבנה הפלט, כדי שנדע למה לצפות כשאנחנו שולחים שאילתה באמצעות קוד. כדי לעשות את זה, אנחנו יכולים להוסיף לבקשה עוד הוראה לפלט מובנה באמצעות השדה responseSchema ב-Gemini API. כדי להגביל את הפלט מהמודל, משתמשים באובייקט סכימה של OpenAPI.

לדוגמה:

{
  "type": "array",
  "description": "Array of location data with score",
  "items": {
    "type": "object",
    "properties": {
      "location": {
        "type": "object",
        "description": "Geographical coordinates of the location",
        "properties": {
          "latitude": {
            "type": "number",
            "format": "float",
            "description": "Latitude of the location"
          },
          "longitude": {
            "type": "number",
            "format": "float",
            "description": "Longitude of the location"
          }
        },
        "required": [
          "latitude",
          "longitude"
        ]
      },
      "score": {
        "type": "string",
        "description": "A score associated with the location"
      }
    },
    "required": [
      "location",
      "score"
    ]
  }
}

בדוגמה הזו, Gemini מתבקש להפיק מערך ב-JavaScript עם הפרטים הבאים:

  • קווי הרוחב והאורך של המיקום
  • הציון של המיקום המותאם אישית

אם משתמשים בהוראות המערכת ובפלט המובנה שלמעלה, התשובה מ-Gemini למיקום אחד תיראה כך, כאשר score הוא הציון המותאם אישית של המיקום:

[
  {
    "location": {
      "latitude": 51.51611,
      "longitude": -0.12726
    },
    "score": "4.13"
  }
]

הצגת הניקוד

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

סיכום

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

נסו את Places Aggregate API עוד היום כדי ליצור ציוני מיקום שימושיים שיעזרו ללקוחות שלכם לקבל החלטות מושכלות על סמך מיקום.

תורמים

הנריק ואלווה | מהנדס DevX