שימוש באילתות גיאו-מרחביות

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

לפני שמתחילים

1. מוודאים שיש לכם גישה למסד נתונים קיים של פעולות שתואם ל-MongoDB, או יוצרים מסד נתונים ומתחברים אליו.

2. מוודאים שיש לכם לפחות אינדקס אחד מסוג 2dsphere, או יוצרים אינדקס מסוג 2dsphere.

אובייקטים של GeoJSON

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

הרצת שאילתה גיאו-מרחבית

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

בדוגמה הבאה, האופרטור $near משמש לחישוב המרחק בין הנקודה הגיאוגרפית (-122.084, 37.4221) לבין הנקודות הגיאוגרפיות שנמצאות בשדה location של כל המסמכים ב-myCollection.. המסמכים מוחזרים וממוינים לפי המרחק הקרוב ביותר בין שתי הנקודות.

  db.myCollection.find({
    location: {
      $near: {
        $geometry: {
          type: 'Point',
          coordinates: [ -122.084, 37.4221 ]
        }
      }
    }
  }
  )

אפשר גם להשתמש בשדות האופציונליים $maxDistance ו-$minDistance כדי לשלוט במרחק במטרים מנקודת השאילתה. בדוגמה הבאה מוצגת שאילתה שבה המסמכים שמוחזרים צריכים להיות במרחק של 500 מטרים לפחות ו-2,000 מטרים לכל היותר מהנקודה (-122.084, 37.4221):

  db.myCollection.find({
    location: {
      $near: {
        $geometry: {
          type: 'Point',
          coordinates: [ -122.084, 37.4221 ]
        },
        $maxDistance: 2000,
        $minDistance: 500
      }
    }
  }

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

  db.myCollection.find( { $and: [
    { location:
      { $near: {
        $geometry: {
          type: 'Point',
          coordinates: [ -122.084, 37.4221 ]
        },
      }
    },
    { "region": "midwest" }
  ] } )

הערך של המחיצה חייב להיות מחרוזת. מסנן המחיצה צריך להיות מחובר לשאילתת החיפוש באמצעות האופרטור $and.

מגבלות

• אי אפשר להשתמש באופרטורים $near ובאופרטורים $text באותה שאילתה.
• אי אפשר להשתמש ב-$near בתוך משפט $or עם כמה פסוקיות, אלא אם $near הוא הביטוי היחיד בפסוקית $or.
• אי אפשר להשתמש ב-$near עם האופרטורים $not או $nor בשאילתה.
• אין תמיכה ב-$near בשאילתות אגרגציה.